详细介绍
概览
Claude Ads 是面向代理商、顾问与品牌投放团队的开源、Claude 优先付费广告运营工具包。它把授权导出或经批准的账户读取,转成有证据支撑的审计、渠道与预算规划、创意流程、实验、监控与报告。公开版仓库为 AgriciDaniel/claude-ads(MIT);另有面向 AI Marketing Hub Pro 成员的社区镜像。
默认只读。可起草账户变更,但在具体平台与操作通过审批、幂等、校验、审计与回滚门禁前,不会落地写入。结果先产出版本化 JSON,再渲染为 Markdown、HTML 与可选 PDF;缺失数据、过期来源、矛盾与部分失败会明确报告,而不是悄悄掩盖。
主要功能
- 十二个广告平台: 覆盖 Google / Meta / YouTube / LinkedIn / TikTok / Microsoft / Reddit / Snapchat / X,以及 Apple Ads、Amazon Ads、Pinterest Ads。每个平台有专注 skill、审计 worker、控制参考与能力声明。
- 生命周期命令: 统一
/ads(Claude Code 插件为/claude-ads:ads),支持 setup、audit、plan、create、launch --draft、monitor、optimize --draft、experiment、report、research refresh、validate、status、next,以及/ads google、/ads meta、/ads amazon等平台捷径。 - 证据感知评分: 控件结果为 pass / fail / unknown / not_applicable;健康分、证据覆盖率、监管暴露与机会项分开;覆盖不足时标为 provisional 或 insufficient,而不是虚构置信度。
- 创意与研究: 文案、图片、视频与商品摄影 brief;竞品与落地页流程;带日期的平台政策与生态证据刷新。
- 安全优先写入: 写入需已启用能力、明确对象 ID、可读 diff、在上限内的负责人批准、幂等键、审计目标、回滚与校验窗口。v2 不支持永久删除。凭证只放环境变量、系统钥匙串或密钥管理,不进仓库与报告。
- 可移植 Skills: 除 Claude Code 插件市场安装外,Codex、Gemini、Cursor、Windsurf、Goose 等兼容主机可通过安装脚本加载同一套 skill 文件。
如何使用
- 优先使用 Claude Code,或其他能加载本仓库 skills 的客户端。
- Claude Code 推荐:
若以前装过旧别名/plugin marketplace add agricidaniel/claude-ads /plugin install claude-ads@ai-marketing-hub-claude-adsagricidaniel-claude-ads,先移除该 marketplace 再按上面重装。也可git clone https://github.com/AgriciDaniel/claude-ads.git后执行bash install.sh --source=local(Windows 用install.ps1);--target=codex/gemini指定主机,--no-deps仅装 skill。 - 重载客户端,运行
/ads setup建立客户、账户、KPI、隐私与护栏配置。 - 提供授权导出或批准读取,运行
/ads audit/plan/create或平台捷径;launch / optimize 用--draft,默认不改账户。 - 行动前复核 JSON 运行包与报告。凭证勿进入 git、配置文件或共享报告。浏览器抓取需自行安装 Playwright 浏览器;PDF 需按仓库外部依赖清单准备 WeasyPrint/Pango。
定价
公开版按 MIT 开源免费,使用 AgriciDaniel/claude-ads 无需会员。部分社区早期协作与 AI Marketing Hub Pro(Skool)相关,与公开 MIT 代码分开;以仓库 README 与 Skool 页面当前说明为准。
适用人群
希望在 Claude Code 或兼容 Agent 中做可重复、有证据的投放审计与草案的效果营销、电商品牌增长与代理团队——含 Amazon Ads 以及 Meta / Google / TikTok 等渠道。适合能提供真实账户导出或批准 API 读取的场景。若需要无审核门禁的一键实盘改价,本工具不是广告后台的替代品。
常见问题
会自动改我的广告账户吗?
默认不会。适配器只读,直到操作经项目安全门禁显式启用并批准。launch / optimize 请优先用 --draft。
支持哪些平台?
README 平台表列出的 Google、Meta、YouTube、LinkedIn、TikTok、Microsoft、Reddit、Snapchat、X、Apple、Amazon、Pinterest Ads。
怎么安装?
推荐 Claude Code 插件市场安装;从 git clone 跑 install.sh / install.ps1 可装 Claude、Codex、Gemini 或仅 skill。
只能给 Claude 用吗?
Claude Code 是规范运行时,但 skill 文件设计为可移植到其他支持 Agent Skills 的主机。