AgriciDaniel/claude-ads

Claude Ads – AI 驱动的广告账户审计技能

它是什么 – 一个开源的 技能（插件），适用于 Claude Code（以及兼容的 AI 代理运行时），可读取导出的广告账户数据（CSV/JSON、截图或摘要）并生成结构化审计。它适用于十二个主要广告平台（Google、Meta、YouTube、LinkedIn、TikTok、Microsoft、Apple、Amazon、Reddit、Pinterest、Snapchat、X），还可以起草计划、创意简报、监控检查、优化建议和测试设计。

工作原理 –

1. 设置 – 您告诉技能您的业务模式、目标、支出、平台和审批流程（绝不粘贴 API 密钥）。
2. 证据摄入 – 您上传账户导出文件或粘贴摘要；技能将数据存储在本地（默认只读）。
3. 审计 – 一组特定于平台的 worker 分析数据并返回发现，每个发现标记为 通过、失败、未知（数据缺失）或 不适用。每个发现都包含导致该发现的证据。
4. 输出 – 您可以将审计渲染为 Markdown/HTML/PDF，查看最关键的阻塞项（/ads next），或请求下游命令（/ads plan、/ads create、/ads monitor、/ads optimize --draft、/ads experiment）。

主要命令

命令	用途
/ads setup	记录客户、目标、支出、平台列表和审批护栏
`/ads audit [platform	all]`
/ads plan	生成渠道、预算、竞争对手和衡量建议
/ads create	为新广告生成文案、图片、视频或产品照片简报
/ads launch --draft	起草活动变更计划，不触及实时账户
/ads monitor	持续检查节奏、疲劳、政策合规等
/ads optimize --draft	基于证据的改进建议
/ads experiment	设计受控测试或读取已完成测试
/ads report	以 Markdown、HTML 或 PDF 导出保存的运行
/ads next / /ads status	显示当前审计状态和最高优先级阻塞项

安全与信任 – 除非启用了特定功能、提供了确切的对象 ID、显示了人类可读的差异，并且遵守了所有者批准的限额，否则所有适配器都是 只读 的。仓库中不存储任何凭据；必须通过环境变量或密钥管理器提供。

可选伴侣 – Claude Ads Cockpit（一个单独的插件）提供本地 UI，用于探索审计运行、与之前的运行比较，并查看合成演示数据。

安装 – 首选通过 Claude Code 的市场：

/plugin marketplace add agricidaniel/claude-ads
/plugin install claude-ads@ai-marketing-hub-claude-ads

或者，克隆仓库并运行 bash install.sh --source=local（支持其他主机，如 Codex、Gemini、Cursor 等，但只有 Claude Code 经过官方验证）。

项目状态 – 开发候选：在 control-plane/RELEASE_REQUIREMENTS.md 中的所有门禁通过之前，尚未达到发布就绪状态。目前所有十二个健康评分配置文件均被禁用，因此审计仅报告发现和证据覆盖。Cockpit 伴侣是可选的，尚未被接受为原生插件。

适用对象 – 营销机构、顾问和内部团队，希望在不给 AI 直接写权限的情况下，获得 AI 辅助、基于证据的广告账户审查。

许可证 – 代码和文档采用 MIT 许可证；第三方 API 保留其自身条款。

---

以上所有细节均直接取自仓库的 README。