claude-ads

1. 基本信息

项目	内容
名称	claude-ads
项目自述名称	Claude Ads（README 展示名，与仓库名书写形式略有差异，同一名称）
作者/维护者	AgriciDaniel（GitHub 个人开发者，公开身份可查；同一账号名下还发布 claude-obsidian、claude-seo 等多个 Claude Code 技能）
来源链接	https://github.com/AgriciDaniel/claude-ads
许可证	MIT（GitHub API 验证；另有付费社区镜像 AI-Marketing-Hub/claude-ads 供早期访问，公开版本无需付费）
GitHub Stars / Forks	7,151 / 1,058（GitHub API 认证 token 验证）
最新版本	v2.0.1，2026-07-13 发布（GitHub Releases API 验证）
安装方式	见第 10 章

2. 功能介绍与亮点

Claude Ads 是一个把付费广告投放的日常运营工作接入 Claude Code 的技能，覆盖 Google、Meta、YouTube、LinkedIn、TikTok、Microsoft Advertising、Reddit、Snapchat、X、Apple、Amazon、Pinterest 共 12 个广告平台。核心能力：

有据可查的账户审计：基于已授权导出的数据或账户读取生成带日期与置信度标注的审计结论，而非模型凭印象作答
规划与创意生产：产出渠道、预算、测量与实验方案，以及文案、图片、视频、商品图的创作简报
投放监控：跟踪投放节奏、交付、跟踪代码、素材疲劳、政策合规与效果表现
默认只读、变更需过多重关卡：账户层面的实际变更默认关闭，需针对具体平台与操作显式启用，并依次通过审批、幂等性、校验、审计留痕、回滚五道关卡才会执行
结构化产出：先生成版本化 JSON 结果，再渲染为 Markdown、HTML，可选 PDF

亮点：①覆盖平台数量在同类工具中少见地做到 12 个主流广告网络的统一操作界面；②“审计优先、只读默认”的设计避免了自动化工具常见的“未经确认就改动投放”风险；③附带 SECURITY.md 与推荐使用 SHA-256 校验、明确警告不要将安装脚本直接管道执行到 shell，安全意识在同类项目中较为突出；④近 5 个月内从 v1.7 迭代到 v2.0.1，维护活跃。

3. 适用场景

固定分类：集成与工作流自动化

适合需要跨多个广告平台开展审计、规划与监控工作的效果营销代理商、独立顾问与企业内部增效团队——尤其是同时管理 Google、Meta 等多个平台投放、希望用统一工作流替代逐平台手工核对数据，且需要变更记录可审计、可回滚的场景。

4. 跨 Agent 兼容性

Agent	结论	依据
Claude Code	原生支持	README 明确标注为“canonical runtime”，提供 `/plugin marketplace add` 插件市场安装路径
Codex	需适配	README 列出 Codex 可消费同一套技能文件，并提供 `install.sh --target=codex` 专用安装参数
OpenClaw	未验证	已抓取材料未提及 OpenClaw 专属适配，未为此单独搜索
Hermes Agent	未验证	已抓取材料未提及 Hermes Agent 专属适配，未为此单独搜索

5. 推荐理由

多数广告投放辅助工具要么止步于“生成文案”，要么在自动化优化时把账户变更权限交给模型却缺乏刹车机制。Claude Ads 把审计、规划、创作、监控整合进一套跨 12 个平台的统一工作流，同时坚持“默认只读、变更需经审批与回滚关卡才生效”的设计，对需要同时打理多平台广告账户、又必须保证操作可追溯的团队和顾问有直接、可落地的价值。

6. 评分

维度	分数	说明
受欢迎程度	9	GitHub 7,151 stars、1,058 forks，5 个月内自然增长
可用性	7	提供 Claude Code 一条命令安装路径，文档详尽（含架构图、能力清单），近期仍在发版；但需要匹配特定 Python 版本、可选 Playwright 与 WeasyPrint/Pango 系统库，完整功能配置步骤多于典型“复制即用”技能
安全性	7	见下方检查清单——默认只读、变更受多重关卡约束，附 SECURITY.md，但涉及最多 12 个平台的 API 凭据管理，凭据存储细节未在已抓取材料中完全确认
综合评分	7.67	三项均值

安全检查清单：

检查项	结果
① Shell 命令执行及权限范围	提供 install.sh/uninstall.sh，README 明确建议使用带 SHA-256 校验的发布包、警告不要将远程安装脚本直接管道执行到 shell；卸载脚本仅清理自身登记的文件
② 运行时联网外发数据	按设计需要读取/写入 12 个广告平台账户数据，属功能核心且在文档中透明说明，非隐蔽外发
③ API Key/凭据要求	需要为使用到的广告平台分别配置授权凭据；具体存储加密方式未在已抓取材料中完全确认
④ 可疑指令/Prompt Injection 迹象	已抓取的 README 与安装脚本说明中未发现要求执行额外操作或访问声明范围外文件的可疑指令
⑤ 作者/组织信誉	个人开发者身份公开可查，同一账号下另有 claude-obsidian（9,524★）、claude-seo（11,648★）等独立技能，非匿名一次性账号
⑥ License 是否明确	MIT，明确
⑦ 最近维护时间	最新版本 v2.0.1 于 2026-07-13 发布，近期活跃维护

7. 跟同类 Skills 相比的优势

名称	定位	与 Claude Ads 的差异
claude-ads（本次推荐）	12 个广告平台的审计、规划、创作、监控一体化工作流，默认只读+多重变更关卡	唯一同时覆盖全平台账户审计与“可审批的账户变更”能力的方案
marketingskills（coreyhaines31）	面向 CRO、文案、SEO、分析、增长工程的通用营销技能集	覆盖面更广的通用营销技能包，不专注广告平台账户操作，也无跨 12 平台的统一审计/变更框架
claude-seo（同作者）	聚焦技术 SEO、E-E-A-T、schema、GEO/AEO 等自然搜索优化	面向自然流量增长而非付费广告投放，两者可在同一营销团队中互补而非替代

8. 用户评价

该技能目前在第三方平台尚无具名用户评价原文；公开可见的信息集中在项目自身文档与若干技能目录站点的转载条目。

9. 其他补充

项目同时以两种形式分发：公开版本（AgriciDaniel/claude-ads，MIT，无需会员）与社区镜像（AI-Marketing-Hub/claude-ads，面向付费社区会员提供早期访问与直接协作）；本报告评估与推荐的对象是前者。

10. 安装使用方式

方式一：Claude Code 插件市场

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

方式二：本地克隆安装（支持多平台/多目标）

git clone https://github.com/AgriciDaniel/claude-ads.git
cd claude-ads
bash install.sh --source=local
# 指定其他宿主：bash install.sh --target=codex --source=local
# 仅安装技能文件、跳过依赖：bash install.sh --source=local --no-deps

方式三：Windows PowerShell

git clone https://github.com/AgriciDaniel/claude-ads.git
Set-Location claude-ads
.\install.ps1 -Source local

安装后用 /ads setup 创建客户端、账户与隐私护栏配置，再用 /ads audit、/ads plan、/ads monitor 等命令触发相应流程；账户实际变更需先通过 /ads launch --draft、/ads optimize --draft 生成草案，显式启用后才会真正提交。无需重启终端。

11. 注意事项

OpenClaw、Hermes Agent 的兼容性未获作者材料证实，标记为“未验证”
完整功能依赖 CPython 3.11/3.12、可选 Playwright 浏览器组件（用于抓取）与 WeasyPrint/Pango 系统库（用于 PDF 渲染）；使用 --no-deps 可退化为仅技能文件的轻量安装
需要为计划使用的每个广告平台单独配置 API 凭据/授权，平台越多、凭据管理的复杂度越高，建议先在测试账户验证审批流程再接入生产账户
账户变更功能虽有审批、幂等、校验、审计、回滚多重关卡，但仍建议使用前完整阅读相关文档，理解每一关卡的实际约束，而非假定“默认安全”
项目存在面向付费社区会员的镜像版本，本报告推荐的是无需付费的公开 MIT 版本