Claudeで12プラットフォームの広告アカウントを安全に監査する方法

本番タスクに言語モデルを信頼することは、いつも少しだけ怖いものです。広告予算这样的话、恐れは10倍になります。広告プラットフォームAPIでエージェントが一歩間違えば、1ヶ月の予算が数時間で間違ったターゲティングに使われてしまいます。だからほとんどのチームは依然として手動でエクスポートをコピーしてチャットボットのWebインターフェースに流し込み、具体的な数字のない曖昧なアドバイスを受け取るにとどまっています。

最近、claude-adsというオープンソースリポジトリを見つけました。著者はClaude Codeのエージェント機能の上に厳格なエンジニアリングシステムを構築しようと試みていました。そのアイデアは、厳格な安全策、型安全性、決定論的なバリデーションチェックを備えた、监督されたパフォーマンスマーケティングアシスタントとしてClaudeを変換することです。

内部構造

このプロジェクトはPythonで書かれたスキルとCLIツールのコレクションです。Claude Code、Cursor、Windsurf、Gemini、Codexを通じて動作させることができます。主な焦点はデータセキュリティと予測可能性にあります。

このシステムは12の広告プラットフォームをサポートしています：

• 検索エンジンとソーシャルネットワーク：Google Ads、Meta Ads、YouTube Ads、LinkedIn Ads、TikTok Ads、Microsoft Advertising、Reddit Ads、Snapchat Ads、X Ads。
• Eコマースとリテールメディア：Apple Ads、Amazon Ads、Pinterest Ads。

制御されていないツール呼び出しを通じてモデルに完全な自由を与える代わりに、このプロジェクトはワークフローを分離されたステージに分割しています。

セキュリティと偶発的な請求からの保護

claude-adsアーキテクチャはデフォルトでリードオンリーモードで動作します。ライブキャンペーンを壊すリスクなしに監査を構築したり、ヒポシスを立てたり、广告コピー生成したり、指標を分析したりできます。

最適化を適用する必要がある場合、システムは複数のレベルのチェックをパスする必要があります：

• 正確なアカウントとオブジェクトIDが明示的に指定されます。
• 変更前後の状態の明確な差分を作成し、影響範囲の評価を行います。
• エージェントが根本的に超えられない厳格な予算制限が設定されます。
• 各書き込みリクエストに対して、冪等性キーと変更のロールバックプランが生成されます。

バージョン2では、完全なエンティティ削除オペレーションはコードから単に削除されています。API認証情報はモデルのコンテキスト、レポート、git履歴に残らず、環境変数またはシステムシークレットストアからのみ読み取られます。

アーキテクチャとキャンペーン品質評価

リポジトリ内では、すべてが明確な責任レベルに分割されています。

単一のコンダクタプロセスがユーザーコマンドを受け取り、スコープ境界を定義し、分離されたワーカーにタスクを分散させます。各ワーカーは特定の分析担当し、スキーマに従って厳格なJSONを出力します。必要なワーカーのいずれかがエラーで失敗した場合、実行全体が部分的としてマークされます。システムは失敗を隠蔽して、不完全なレポートを完成品として提示することはしません。

正規出力はバージョン管理され、バリデーションされたJSONです。このJSONから、ユーティリティはMarkdownサマリー、HTMLページ、またはWeasyPrint経由のPDFをアセンブルします。

広告アカウントのヘルススコアリングは興味深い設計になっています。各チェックにはpass、fail、unknown、not_applicableのステータスがあります。収集されたデータの完全性は、全体的なヘルススコアとは別途評価されます：

• チェックの80%以上がカバーされている場合、完全なスコアが割り当てられます。
• 60%から79%のカバー率の場合、スコアは暫定と見なされます。
• データが60%未満の場合、証拠が不十分なためスコアリングは計算されません。
• ベータ機能と利用できないプラットフォーム機能は、評価を引き下げることを避けるため計算から除外されます。

ツールでの作業の様子

Claude Codeでのインストールはプラグインストア経由で行います：

/plugin marketplace add AgriciDaniel/claude-ads
/plugin install claude-ads@ai-marketing-hub-claude-ads

ローカルインストールや他の環境を好む場合：

git clone https://github.com/AgriciDaniel/claude-ads.git
cd claude-ads
bash install.sh --source=local

インストーラーはLinux、macOS、Windows上のPython 3.11および3.12をサポートしています。システムライブラリが不足している場合、スクリプトは変更を加える前にエラーで失敗します。

インストール後、対話はスラッシュコマンドを中心に構築されます。例えば：

• /ads setupはクライアントプロファイル、ターゲットKPI、許容可能な予算境界、プライバシールールを設定します。
• /ads audit allは接続されたチャネルの完全監査を実行し、各出力は日付付き指標に紐付けられます。
• /ads planは予算配分、メディアプラン、スプリットテストプランを計算します。
• /ads optimize --draftは入稿とクリエイティブの変更のドラフトを準備しますが、プラットフォームには適用しません。
• /ads reportは最終的な構造化レポートを生成します。

特定のアカウントへの直接ショートカットも動作します：/ads google、/ads meta、/ads reddit。

プロジェクトが役立つ人

数千ルーブルの予算で1つの広告を運用している人々にこのリポジトリは不要でしょう。しかし、複数のプラットフォームで広告を運用している場合、または代理店に内部自動化を構築している場合は、ここで探求する価値のあるものがたくさんあります。

たとえツール全体を不使用場合でも、ソースコードclaude_ads_coreとディレクトリ構造control-plane/は、LLM用の信頼できるスキルを設計する方法の確かな例を提供します。混沌としたテキストプロンプトの代わりに、著者はデータコントラクト、バリデーションスキーマ、オペレーター確認ゲートの実装を行いました。このリポジトリはオープンライセンス（MIT）なので、コードを自由に独自のモジュールに分解できます。