JinDaGe - meta-ads-mcp MCP Details

article

README

🚀 元广告多账户工具包（Meta Ads Multi Account Package）

本工具包可帮助用户便捷地管理元广告多账户，提供丰富的操作工具和灵活的配置选项，提升广告账户管理效率。

🚀 快速开始

基本使用示例

运行以下命令开启工具：

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

获取广告账户信息

若要查看所有关联的广告账户，请运行：

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

📦 安装指南

通过 pip 安装

使用以下命令通过 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。

文档扩展

如需更详细的文档，访问项目官网或查阅相关技术资料。

meta-ads-mcp