Meta Ads API

🚀 Meta广告管理工具用户指南

Meta广告管理工具是一款强大的工具，可帮助用户高效地管理Meta平台的广告业务，涵盖账户、系列、广告组等多方面管理功能。

🚀 快速开始

安装包依赖

安装Meta广告管理工具所需的Python包：

pip install meta-ads-mcp

设置环境变量

为了方便使用，建议设置以下环境变量：

设置默认App ID

在终端中运行以下命令：

export META_APP_ID=your_app_id

设置默认访问令牌

如果你已经有有效的访问令牌，可以跳过OAuth身份验证流程：

export META_ACCESS_TOKEN=your_access_token

获取帮助信息

查看工具的使用说明和版本信息：

uvx meta-ads-mcp --help
uvx meta-ads-mcp --version

✨ 主要特性

Meta广告管理工具提供以下核心功能：

广告账户管理

• 获取所有可用广告账户：

uvx meta-ads-mcp get-ad-accounts

• 检查特定广告账户信息：

uvx meta-ads-mcp check-account-info --account-id=your_account_id

广告系列操作

• 创建新的广告系列：

uvx meta-ads-mcp create-campaign --name="Your Campaign Name" --objective=CPC

• 获取所有广告系列列表：

uvx meta-ads-mcp get-campaigns

广告组管理

• 创建新的广告组：

uvx meta-ads-mcp create-ad-set --campaign-id=your_campaign_id --name="Your Ad Set Name"

• 获取所有广告组：

uvx meta-ads-mcp get-ad-sets

📦 安装指南

安装包依赖

安装Meta广告管理工具所需的Python包：

pip install meta-ads-mcp

设置环境变量

为了方便使用，建议设置以下环境变量：

设置默认App ID

在终端中运行以下命令：

export META_APP_ID=your_app_id

设置默认访问令牌

如果你已经有有效的访问令牌，可以跳过OAuth身份验证流程：

export META_ACCESS_TOKEN=your_access_token

获取帮助信息

查看工具的使用说明和版本信息：

uvx meta-ads-mcp --help
uvx meta-ads-mcp --version

💻 使用示例

基础用法

以下是一些基础的命令使用示例：

# 安装工具
pip install meta-ads-mcp

# 获取所有可用广告账户
uvx meta-ads-mcp get-ad-accounts

高级用法

创建一个带有特定开始和结束时间的广告系列：

uvx meta-ads-mcp create-campaign --name="Your Campaign Name" --objective=CPC --start-time=2024-01-01 --end-time=2024-12-31

📚 详细文档

命令参考

账户相关命令

uvx meta-ads-mcp get-ad-accounts --help
uvx meta-ads-mcp check-account-info --account-id=ACCOUNT_ID --help

广告系列操作命令

uvx meta-ads-mcp create-campaign --name=CAMPAIGN_NAME --objective=OBJECTIVE [--start-time=START_TIME] [--end-time-END_TIME] --help
uvx meta-ads-mcp get-campaigns --status STATUS --fields.Fields --limit.LIMIT --help

广告组操作命令

uvx meta-ads-mcp create-ad-set --campaign-id=CAMPAIGN_ID --name=AD_SET_NAME [--optimization-OPTIMIZATION] [--bid-strategy=BID_STRATEGY] --help
uvx meta-ads-mcp get-ad-sets --status STATUS --fields.Fields --limit.LIMIT --ad setId AD_SET_ID --help

认证问题

常见认证错误

如果你遇到类似(#200) Provide valid app ID的错误，请检查以下几点：

1. 确保你已正确设置Meta开发者应用。
2. 验证是否正确传递了应用ID，可通过以下方式：
   • 设置环境变量：export META_APP_ID=your_app_id
   • 作为命令行参数使用：uvx meta-ads-mcp --app-id your_app_id

访问令牌管理

• 获取新的访问令牌：

uvx meta-ads-mcp get-access-token

• 刷新现有令牌：

uvx meta-ads-mcp refresh-token

工具调试

日志记录

工具默认启用日志记录功能，日志文件位于~/.meta_ads_mcp/logs/目录下。

错误报告

遇到问题时，请提供以下信息：

1. 完整的错误日志。
2. 相关操作步骤。
3. 环境配置详情（包括Python版本和包版本）。

测试与验证

运行测试用例

uvx meta-ads-mcp run-tests

查看代码文档

uvx meta-ads-mcp view-docs

故障排除

网络问题

如果遇到网络连接问题，请检查：

1. 确保互联网连接正常。
2. 检查防火墙设置，允许必要的端口通信。

数据同步延迟

某些操作可能会出现数据同步延迟，建议在执行关键操作前等待几分钟，并确保使用最新的广告数据。

联系方式

如需帮助或反馈问题，请访问我们的支持页面：Meta Ads MCP 支持中心。