🚀 元广告多账户工具包（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。
文档扩展
如需更详细的文档，访问项目官网或查阅相关技术资料。