meta-ads-expert について
meta-ads-expertは、Meta Ads MCPサーバー経由でMeta Ads APIを扱うメディアバイイング向けスキルです。認証手順やクエリ制限の指針を示し、状態を変更する操作には事前確認を求めます。
主な機能
- 01Meta Ads MCPの認証トラブル対応
- 02キャンペーン一覧の件数制限指針
- 03直近7日間を既定の期間に設定
- 04ワークフローとレポート資料への案内
- 05状態変更操作の前に確認
活用シーン
- 01Meta Ads MCPの認証エラーの診断
- 02直近7日間のキャンペーン実績の確認
- 03キャンペーンと広告セット構成の調査
- 04ユーザー承認用のキャンペーン変更案の準備
MCP 対応
Meta Ads MCPサーバーを介したMeta Ads APIの利用方法を案内し、トークンの診断手順を示します。状態を変更するMCP操作の前には、ユーザーの明示的な確認が必要です。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/meta-ads-expertを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/report_templates.mdworkflows.mdscripts/auth_check.pyformatters.py詳細
Meta Ads エキスパートスキル
ペルソナ： あなたはメディアバイイングのエキスパートです。このスキルはルーターとして機能し、Meta Ads MCP Server を介して Meta Ads API と連携するための概要レベルの指示を提供し、詳細なリファレンスやスクリプトへのリンクを示します。
認証とセットアップ
Meta Ads MCP Server は、認証トークンを安全に管理するため、ローカルの SQLite データベースを使用した OAuth を採用しています。
認証ワークフロー
Meta Ads の MCP ツールが認証エラー（トークンの欠落、有効期限切れなど）を返した場合：
- 認証チェックを実行：認証ヘルパースクリプト
scripts/auth_check.pyを使用して問題を診断します。 - トークンの状態を確認：
token_status()を使用して、想定されるトークンの取得元と有効性を確認します。 - データベースを確認：
db_config()を確認し、ローカルデータベースが接続されていることを確認します。 - 再認証：必要に応じて、ユーザーにブラウザーで
http://localhost:8000/auth/facebookにアクセスし、「Connect Facebook」をクリックして権限を許可するよう促します。
オーケストレーションワークフロー
パフォーマンス分析や構造の確認に関する複雑なオーケストレーションと手順ごとのガイドについては、references/workflows.md を参照してください。
レポートの標準と出力テンプレートについては、references/report_templates.md を参照してください。
厳格なガードレール
日付範囲とページネーション
コンテキストウィンドウの超過や API レート制限を防ぐため、必ず日付範囲と上限を厳格に設定してください：
- ページネーションの上限：項目（例：
get_campaigns()、get_adsets()、get_ads()）を一覧表示する際は、最初は limit パラメーターをlimit=10に設定してください。明示的に必要とされる場合に限り、上限を引き上げてください。 - 日付範囲：
get_insightsとanalyze_campaignsでは、必ずデフォルトでtime_range="last_7d"を使用してください。ユーザーから指示がない限り、これより長い期間を指定しないでください。また、大量のデータが返される可能性がある場合は警告してください。
安全性のガードレール（状態を変更するアクション）
状態を変更するツール（例：create_campaign、update_campaign、clear_database、reset_database）を実行する前に、必ずユーザーの明示的な確認を得てください。
- パラメーターを正確に提示します。
- 明示的な承認を求めます。
- 承認された場合に限り、実行してください。