SuperAPI AI 工具集

ads-cli

编程与开发

查看项目

更新于 10-16 08:04

技能介绍

用途:通过一个 CLI 与统一客户端管理 Google、Meta、TikTok 的付费广告,可用于认证、创建广告系列、调整预算、拉取报告和暂停广告系列等操作。

主要能力:

  • Google Ads 为真实的 Google Ads API v23 实现,支持认证校验、列出可访问客户、生成报告、创建广告系列(默认 PAUSED)、按百分比或绝对值调整预算、暂停广告系列。
  • Meta 与 TikTok 目前是存根(stubs),尚未实现。
  • 代码结构包括 cli.py(Click 命令)、src/google.py、src/meta.py、src/tiktok.py、src/unified.py(按平台路由)。

认证方式:

  • Google Ads 使用基于文件的认证,读取 ~/google-ads.yaml,凭据不使用环境变量。需要在 ~/.secrets 中设置: export GOOGLE_ADS_LOGIN_CUSTOMER_ID=6445466801 export GOOGLE_ADS_CUSTOMER_ID=<sub_account_id>
  • Meta / TikTok 相关环境变量(META_APP_ID、META_APP_SECRET、TIKTOK_ACCESS_TOKEN)对应功能尚未实现。

使用方式示例: cd ~/.claude/skills/ads-cli python cli.py auth --platform google python cli.py report --platforms google --date-range 7d --format table python cli.py create-campaign --platform google --objective conversions --budget 35 --targeting "AI consulting" python cli.py adjust-budget --platform google --campaign-id <id> --amount "+20%" python cli.py pause --platform google --campaign-id <id>

适用场景:需要在命令行或 Python 中批量管理付费广告投放、调整预算与生成报告的场景。

限制与已知问题:MCC 6445466801 存在政策标记,阻止通过 API 创建子账户,需先在 ads.google.com 处理后再创建广告系列;MCC 2673211237 为次要账户,不要改动;customers/8507948813 已失效(权限被拒),应忽略。Meta 与 TikTok 集成暂未提供。扩展新平台时需实现 auth、create_campaign、adjust_budget、get_report、pause_campaign,并在 UnifiedAdsClient 中注册。