Yandex Direct 广告管理技能
面向 AI 代理的首个 Yandex Direct (API v5) 开源技能，用自然语言完成俄语市场 PPC 广告的审计、投放、优化与报告。
凭据存放于 ~/.secrets 并 chmod 600，工具声明明确；但允许 Bash/WebFetch 且缺少对创建/删除/出价变更等外部写操作的显式用户确认与回滚机制，脚本本体未提供无法审查数据流。
SKILL.md 流程逻辑自洽、命令结构清晰，但引用的 scripts/*.sh 与 references/*.md 内容未在受审文件中体现，无测试、无异常输入的错误反馈设计证据。
触发词明确（俄/英双语）、受众（俄罗斯市场 PPC）清晰，质量门限披露良好；但核心功能完全依赖 Yandex API 与 OAuth，从中国大陆可达性存疑，且未声明非适用边界。
文档分层合理（按需加载 references）、含快速开始与俄语双语 README、MIT 许可明确；扣分项：无版本号/变更日志、维护责任与更新路径不明。
声称 55 项审计、评分体系与基准数据，结构完整有边际价值，但仅凭'一晚建成'的自述与单账户（stepback.ru）轶事，无代表性输出样例验证可用性。
仅有作者自述与单一轶事案例（D→C+），无测试、无 CI 证据、无第三方佐证，关键声明不可独立复现。
- 核心功能完全依赖 Yandex API，中国大陆网络可达性未经证实，使用前请自行验证端点连通性。
- 审计引用的脚本与参考文件不在受审范围内，实际行为与安全性未经验证，静态审查置信度低。
- 创建/删除/改价等破坏性 API 操作缺少显式确认与回滚设计，建议在生产账户上先只读试用。
- 无版本号与变更日志，后续更新与维护责任不明。
这个 Skill 能做什么，适合哪些场景？
这是由 Nick Serebrov 与 Kobe 🐍 开发的开源 Agent Skill，通过 Yandex Direct API v5 对俄罗斯市场搜索广告和 РСЯ（YAN）广告进行全周期管理。它提供 8 个命令，覆盖账户审计（55 项检查、0-100 加权评分、A-F 等级）、广告系列增删改、关键词与竞价管理、效果报告、预算分析与优化建议。技能以 SKILL.md 为核心，配有按需加载的参考文件（审计清单、评分体系、俄语市场基准、竞价策略、合规规则、图片规格）和 Shell API 封装脚本。作者称其为首个针对 Yandex Direct 的开源广告技能，灵感来自不支持 Yandex 的 claude-ads 项目。
通过 Bash 调用 scripts/yd-api.sh 封装的 Yandex Direct API v5（https://api.direct.yandex.com//v5/，Bearer OAuth 认证，凭据存于 ~/.secrets/yandex-direct.）。具体操作包括：/direct audit 拉取全部广告系列、广告组、关键词、广告和快速链接后执行 50+ 项检查并输出 0-100 评分、A-F 等级与优先级行动计划；/direct campaigns 列出广告系列状态与指标；/direct create 通过 campaigns.add、adgroups.add、keywords.add、ads.add 创建搜索或 РСЯ 广告系列；/direct keywords 管理关键词（添加、暂停、恢复、改价、删除）；/direct report 调用 Reports 服务生成 TSV 报告（campaign/adgroup/keyword/search_query 预设，多种日期范围）；/direct optimize 基于 30 天数据找出零转化关键词、低 CTR 广告并应用 3x Kill Rule；/direct budget 计算消耗速率与月度预测；/direct negative 管理广告系列级和共享级否定词。
- 在俄罗斯市场投放 Yandex Direct 广告的营销人员，想用一句话让 AI 代理对整个广告账户做体检并拿到整改清单
- 代理公司客户经理需要批量检查多个 Direct 账户，快速定位烧钱的关键词和低质广告
- 已经有 claude-ads（Google/Meta/LinkedIn 广告）的用户，需要补齐 Yandex Direct 这一渠道
- 投放新手想让 AI 按俄语市场 CTR/CPC/CVR 基准评估自己的账户处于什么水平（例如作者自己从 D 级提升到 C+）
- 需要每周生成消耗报告和预算预测、避免超支或欠投的广告优化师
这个 Skill 有哪些优点和局限？
- 填补空白：首个针对 Yandex Direct 的开源 AI 代理技能，claude-ads 等竞品不覆盖该平台
- 审计体系具体可执行：55 项编号检查（YD01-YD55）、按 6 大类加权评分、内置俄语市场 CTR/CPC/CVR 基准数据
- 覆盖完整投放生命周期：从建站式创建广告系列到否定词、预算预测，均通过真实 API 调用完成
- 内置行业质量约束：3x Kill Rule、宽泛匹配需配自动策略、7 天学习期内不改策略、广告必须带 UTM 等
- MIT 许可，可自由 fork 和修改
- 依赖 Yandex Direct API 访问权限，申请门槛和审核周期可能阻碍快速上手
- 仅面向 Yandex Direct（俄语市场），对投放其他平台的团队价值有限
- 参考文件为静态基准（CTR 5-8%、CPC 30-150₽ 等），行业差异大，需自行核实适用性
- 仓库未列出 Topics，也没有可见的测试套件或第三方验证，实际可靠性依赖作者自述（一次 D→C+ 审计案例）
- 针对 OpenClaw 和 Claude Code 提供安装说明，其他代理框架的适配未经验证
如何安装这个 Skill？
1) 在 direct.yandex.ru 申请 API 访问权限；2) 通过 https://oauth.yandex.ru/authorize?response_type=token&client_id=YOUR_CLIENT_ID 获取 OAuth token；3) 将凭据写入 ~/.secrets/yandex-direct.（包含 client_id、client_secret、oauth_token），并执行 chmod 600 保护文件；4) 复制仓库中的 yandex-direct 文件夹到代理的技能目录：OpenClaw 用 cp -r yandex-direct ~/clawd/skills/，Claude Code 用 cp -r yandex-direct ~/.claude/skills/。仓库未说明其他安装方式。
如何使用这个 Skill？
安装后对代理下达自然语言指令或使用斜杠命令，例如「Run a Yandex Direct audit」（运行一次 Yandex Direct 审计）。SKILL.md 定义了 /direct audit、campaigns、create、keywords、report、optimize、budget、negative 八个子命令，触发词包括「Яндекс Директ」「Yandex Direct」「РСЯ」「директ」等。API 凭据位置必须预先配置，否则所有依赖 API 的命令都无法工作。