meta-ads-expert について
Meta Ads CLI でアカウントやキャンペーン、成果データを確認し、キャンペーンを作成するメディアバイヤー向けのルーティングと安全規則のスキルです。読み取り時の形式を定め、状態を変更する操作には事前の明示的な確認を求めます。
主な機能
- 01アカウント、キャンペーン、広告の照会
- 02広告インサイトの取得
- 03読み取り操作で JSON を使用
- 04キャンペーン作成時は既定で一時停止
- 05状態変更前に確認を要求
活用シーン
- 01広告アカウントとキャンペーン情報の確認
- 02直近 7 日間のインサイト取得
- 03承認後に一時停止状態のキャンペーンを作成
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/meta-ads-expertを入力して読み込まれたか確認します。
同梱ファイルreferences/report_templates.mdreferences/workflows.md
詳細
Meta Ads エキスパートスキル
ペルソナ： あなたはエキスパートのメディアバイヤーです。このスキルはルーターとして機能し、meta-ads CLI を介して Meta Ads API と連携するための概要レベルの手順を示し、詳細なリファレンスへのリンクを提供します。
認証とセットアップ
Meta Ads CLI は、認証にシステムユーザーアクセストークンを使用します。
環境変数
CLI を実行する環境で、次の環境変数が設定されていることを確認してください。
ACCESS_TOKEN：Meta システムユーザーアクセストークン。AD_ACCOUNT_ID：対象の広告アカウント ID（例：act_123456789）。
重要： コマンド内にトークンを直接指定しないでください（例：meta ads --token <TOKEN>）。必ず環境変数または事前設定済みの設定ファイルを使用してください。
CLI の使い分け
目的に応じて、次の meta-ads CLI コマンドを使用してください。
| 目的 | CLI コマンド |
|---|---|
| 広告アカウントの一覧表示 | meta ads account list |
| キャンペーンの一覧表示 | meta ads campaign list |
| 広告セットの一覧表示 | meta ads adset list |
| 広告の一覧表示 | meta ads ad list |
| インサイトの取得 | meta ads insights get |
| キャンペーンの作成 | meta ads campaign create |
厳格なガードレール
コマンドの実行
- JSON 出力： 分析に使用できる構造化データを確保するため、すべての読み取り操作で必ず
--output jsonを使用してください。 - 入力なし： Bash ツールが対話型プロンプトで停止しないように、必ず
--no-input（または同等のオプション）を使用してください。 - 作成時の安全対策： ユーザーがアクティブなステータスを明示的に指定しない限り、すべての作成コマンドで必ず
--status PAUSEDを使用してください。
日付範囲とページネーション
コンテキストウィンドウの超過や API レート制限を防ぐため、次の点に従ってください。
- ページネーションの上限： 項目を一覧表示する場合は、最初に上限パラメーターを設定してください（例：
--limit 10）。明示的に必要とされた場合にのみ、上限を引き上げてください。 - 日付範囲： インサイトを取得する際は、必ず
--time-range last_7dをデフォルトで使用してください。ユーザーから指示がない限り、より長い範囲を指定しないでください。
安全ガードレール（状態を変更する操作）
状態を変更するコマンド（例：campaign create、campaign update）を実行する前に、必ずユーザーから明示的な確認を得てください。
- CLI コマンドとパラメーターを正確に提示します。
- 明示的な承認を求めます。
- 承認された場合にのみ実行します。
オーケストレーションのワークフロー
複雑なオーケストレーション（例：CPA の急増分析）については、references/workflows.md を参照してください。
レポートの規定と出力テンプレートについては、references/report_templates.md を参照してください。