Meta Ads MCP

🚀 元広告多アカウントツールキット（Meta Ads Multi Account Package）

このツールキットは、Meta広告の多アカウント管理を容易にするためのパッケージです。様々な操作をコマンドラインから簡単に行うことができます。

🚀 クイックスタート

基本的な使用法

uvx meta-ads-mcp --app-id your_app_id

広告アカウント情報の取得

すべての関連する広告アカウントを表示するには、以下のコマンドを実行します。

uvx meta-ads-mcp --app-id your_app_id --get-ad_accounts

📦 インストール

pipを使用したインストール

pip install meta-ads-mcp

ソースコードからのインストール

git clone https://github.com/your-repository/meta_ads_mcp.git
cd meta_ads_mcp
python setup.py install

💻 使用例

基本的な使用法

uvx meta-ads-mcp --app-id your_app_id

高度な使用法

広告アカウント情報を取得するには、以下のコマンドを使用します。

uvx meta-ads-mcp --app-id your_app_id --get-ad_accounts

📚 ドキュメント

よく使うツールコマンド

1. ログインリンクの取得

mcp_meta_ads_get_login_link ツールを使用して、新しい認証リンクを取得します。

mcp_meta_ads_get_login_link()

2. 広告アカウント情報の照会

すべての関連する広告アカウントをリストアップします。

mcp_meta_ads_get_ad_accounts()

操作ツールリスト

以下は、すべての操作ツールのリストです。各ツールには特定の機能があります。

• ログインリンクの取得：mcp_meta_ads_get_login_link()
• 広告アカウント情報の照会：mcp_meta_ads_get_ad_accounts()
• アカウント詳細の取得：mcp_meta_ads_get_account_info(account_id="your_account_id")
• 新しい広告キャンペーンの作成：mcp_meta_ads_create_campaign(campaign_name="your_campaign_name", budget_type="daily", daily_budget=100.0, account_id="your_account_id")
• 広告キャンペーンの削除：mcp_meta_ads_delete_campaign(campaign_id="your_campaign_id", account_id="your_account_id")
• 広告キャンペーンの取得：mcp_meta_ads_get_campaigns(account_id="your_account_id")
• 新しい広告セットの作成：mcp_meta_ads_create_ad_set(ad_set_name="your_ad_set_name", campaign_id="your_campaign_id", budget_type="daily", daily_budget=100.0, account_id="your_account_id")
• 広告セットの削除：mcp_meta_ads_delete_ad_set(ad_set_id="your_ad_set_id", account_id="your_account_id")
• 広告セット情報の取得：mcp_meta_ads_get_ad_sets(campaign_id="your_campaign_id")
• 新しい広告の作成：mcp_meta_ads_create_ad(creative_id="your_creative_id", title="your_title", description="your_description", url="your_url", ad_set_id="your_ad_set_id")
• 広告の削除：mcp_meta_ads_delete_ad(ad_id="your_ad_id", ad_set_id="your_ad_set_id")
• すべてのクリエイティブの取得：mcp_meta_ads_get_creatives(account_id="your_account_id")

🔧 環境変数の設定

アプリIDの設定

META_APP_ID 環境変数を設定します。

export META_APP_ID=your_app_id
uvx meta-ads-mcp

コマンドラインでのアプリIDの指定

uvx meta-ads-mcp --app-id your_app_id

🔑 ログイン方法

ローカルキャッシュによるログイン

初回実行時に、ツールは自動的にブラウザを起動して認証を行います。

uvx meta-ads-mcp

強制的な再ログイン

--force-login フラグを使用して、強制的に再ログインします。

uvx meta-ads-mcp --force-login

🐞 デバッグガイド

画像ダウンロードのデバッグ

クリエイティブ画像をダウンロードする場合は、以下のように設定します。

export AD_CREATIVES_DOWNLOAD=1
mcp_meta_ads_get_creatives(account_id="your_account_id")

ログ記録

問題を解決するためにログ記録を有効にします。

uvx meta-ads-mcp --log-file /path/to/logfile.log

🔒 プライバシーとセキュリティ

認証情報の保護

すべての認証情報は暗号化されて保存され、第三者にはアクセスされません。共有環境でこのツールを使用しないでください。

データ転送

データはHTTPSを通じて安全に転送され、転送中のセキュリティが確保されます。

❓ よくある質問

• 認証を再取得するにはどうすればいいですか？ --force-login フラグを使用して、強制的に再ログインします。

• アプリIDを忘れてしまったらどうすればいいですか？ 環境変数を確認するか、Meta広告コントロールパネルであなたのアプリIDを見つけてください。

📖 ドキュメントの拡張

より詳細なドキュメントが必要な場合は、プロジェクトの公式ウェブサイトにアクセスするか、関連する技術資料を参照してください。