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

📚 詳細文檔

工具說明

常用工具命令

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怎麼辦？ 查看環境變量或在元廣告控制面板中找到您的應用ID。

文檔擴展

如需更詳細的文檔，訪問項目官網或查閱相關技術資料。