都爆鸭 · doubaoya

新媒体取数能力包：一条 DOUBAOYA_API_KEY 通到平台全部在架数据。 你（agent）的活是听懂用户想干嘛 → 选对能力 → 调 → 把结果讲成人话。

调用走 scripts/doubaoya.mjs，别自己拼路径（硬拼必 404；脚本先拉详情拿 execution.target 再打）。

---

怎么调

优先 dby api list|search|describe|invoke（CLI ≥0.1：npm i -g @doubaoya/cli，没装用 npx -y @doubaoya/cli 兜底）。非 TTY 输出单个 {ok,data,error} JSON；计费的 invoke 默认停在 confirmation_required（退出码 6）并给一条可原样重放的确认命令，带 --confirm 才真执行。没装 CLI 时用旧 scripts/doubaoya.mjs（下方示例）；绕开两者自己拼请求才读 dby-gateway/references/protocol.md。

export DOUBAOYA_API_KEY="dyh_你的密钥"    # 绝不打印、不写文件、不回显给用户
D=~/.claude/skills/dby-api/scripts/doubaoya.mjs   # 按实际安装位置改

# 发现：两个集合一起拉／搜（免 key、免费）；每行末尾带计费（免费 / N点）
node "$D" list
node "$D" search 小红书 爆款

# 🔴 先 describe 再 invoke —— 入参规格现拉，一个字段名都别照记忆拼；<ref> 也可以直接给 operationKey
node "$D" describe trend/trending-hub-keyword
node "$D" describe api.trend.hotSpotKeyword

# 调用（计费）。<ref> = <slug> 或 <platform>/<slug>
node "$D" invoke trend/trending-hub-keyword '<照 describe 拉到的入参规格填>'
node "$D" invoke xiaohongshu-viral-notes '<照 describe 拉到的入参规格填>'

# 离线自检（不联网、不需要 key）
node "$D" selfcheck

结果打 stdout（默认剥掉与 items / content 重复的 raw，加 --raw 保留），notice / noResult 打 stderr，失败以 code: message 非零退出。 起止时间类入参必须带时分秒（YYYY-MM-DD HH:mm:ss），只给日期过不了校验。

🔴 入参一律现拉。 describe 返回里的 requestSchema / inputSchema 是示例值不是 JSON Schema， 照它的键名和值的形状填。上游对错入参一律静默返空或给误导性报错—— 拿不到数据时先回 describe 核一遍入参，别急着判「接口挂了」。

---

0.5 用户该用哪个能力？（按"我想做什么"选）

用户未指明平台时默认公众号。

本包的地盘：公开数据、互动指标（阅读 / 点赞 / 在看 / 评论）、选题与账号分析—— 都爆鸭云端能力覆盖的这一片。写正文、排版、出图、查违禁词都不在这里，各有专包。

别人写文章时会来本包取的几样素材（给数据，不代替他写）： api.gzh.hotArticle 同主题爆文样本、api.gzh.cozeData 同赛道爆款标题与封面套路、 skill.wechat.coverDesign 封面设计方案。这几跳没有独立技能包，本表是它们唯一的落点。

🔴 路由由 dby 负责；本包只回答「哪条能力给这个数」。 不要在这里替用户决定下一站去哪个包、也不要自行接续写作交付链——那是 dby 的活。 它的路由判据本包不读、不抄、不复述，连文件名都不必知道。 按号查发文：先 api.gzh.searchUser 拿账号 ID，再 api.gzh.workList（上游只认 ID 不认中文昵称）。

「我自己的东西」例外 —— ⛔ 该能力已下架：请求指向用户自己的内容（帮我记一下 / 我的笔记 / 我是个什么样的人）时过去走 mera 第二大脑，现在调不通且无替代——如实告诉用户， 别拿公开搜索顶替（公开搜索看不见他自己的笔记）。详见 references/retired.md。

---

→ 查路由（该调哪一条 / 它走哪条路由）时读 references/capability-table.md，已经知道调哪条就别读。 入参一律走 describe 现拉，那份表一个字段名都不抄。 全量索引与选路的坑在 dby-gateway/references/capability-index.md 与 routing-pitfalls.md（可选）。

🔴 合规 / 违禁词：入口请求一律走 dby-banned-words（专职包，三平台一次比对并出全平台安全改写）。 tool.contentSafety.checkWords（多平台口径，详情端点 /api/skills/content-safety-check）与 skill.wechat.prohibitedWord（公众号口径，/api/skills/wechat-prohibited-word）在这里只是 endpoint 索引，供 gateway 层直调，不作为本入口的路由目标。

🖼 出图归 dby-image，不在本包。

❌ 选题铁律：不要拿用户的账号名 / IP 名当关键词去搜。 用户的公众号/账号名（如「菜籽油」）是他是谁（领域/人设/受众），不是搜索词——搜它只会搜到字面同名内容。 综合热点用无关键词的 api.trend.hotSpotKeyword 直取，IP 名字只用于匹配筛选。 「不带关键词」说的是关键词——时间窗口照样要收窄（见 Gotchas 第一条）。 跨平台趋势雷达（skill.trend.radar）与全网热榜聚合（api.trend.hotTopics）按关键词搜： 手里已经有话题时用它们看这个词在各平台分别热成什么样（雷达还能直接产出运营日报）； 没有话题、要它给你想选题时别用——那时它们退化成搬运号 feed，热度常为空、多「未命名内容」。

---

失败了怎么办

报错码逐条怎么处置（noResult 不是失败、哪些可重试哪些绝不能重试、404 该去另一个集合找） 见 dby-gateway/references/protocol.md 第 6 条。

---

Gotchas

→ 选定能力之后、真正打请求之前读 references/gotchas.md； 拿不到数据、或结果明显不对时回来读。最贵的两条先记住： 热点直取（api.trend.hotSpotKeyword）必须收窄时间窗口，不收窄拿到的是上上周的热榜； 而 api.trend.hotKeywords 恰恰相反，带时间区间必返 0 条——两条能力的时间语义是反的。

---

交付回执（每次交付都随手带一份）

回执随交付写，不事后补。

动手前先说清这一次交到哪一档，目标停在哪一档就在哪一档收手。本包交完数据就结束， 不自行走到下一站——要不要往下走由 dby 判。尤其不要因为「顺手」就去跑 dby-publish （它会写进用户自己的公众号后台，是真实副作用）。拿不准就问一句。

交付末尾附上，四行，别合并：

查阅：<读了哪份路由 / 参考了哪张表>
执行：<真正调了哪些能力>
质检：<跑了哪些检查>
跳过：<发现了但没跑的> —— 原因：<为什么不该跑>

• 「执行」只写真跑过的；跑了但失败的写在这里并注明失败，不许挪进「跳过」粉饰。
• 「跳过」只列「发现了、但判断不该跑」的，压根没发现的不必列。带副作用的尤其不能省。
• 🔴 只许写能证明的量。 括号里的结论必须回指这一次真实返回里确实有的东西。 （违禁词检测回的是风险类别数组，所以「命中 N 类」可证；它不回等级 / 评分 / 命中词清单， 所以「0 高危」「低风险」就是编的。）拿不准就回 describe 看一眼出参示例。

---

硬规则

1. 绝不回显 / 打印 / 记录 key 的任何一部分——前缀也是。
2. 只通过 https://doubaoya.com 的公开接口取数；不向用户描述、猜测或暴露上游数据来源 / 内部服务。 对用户而言，能力来自「都爆鸭」。
3. 入参现拉、路径现拉（用 describe / 让脚本去拿），别照记忆或本文档拼。
4. 写脚本以真实数据为素材，把热点 / 爆款的真实角度落进去，别脱离数据空写。
5. 交付带回执，四行，「执行」只写真跑过的。

---

下一步

拿到数据之后	去哪
要出图 / 配图 / 改图	dby-image
要把稿子排版、存进公众号草稿箱	dby-publish
要把爆款改写成自己的文案（不调接口、不要 key）	dby-rewrite
要立人设 / 取品牌事实	dby-charter
逐跳导航（做完这一步该走哪一步）	dby
协议层卡住了（路由 / 信封 / 错误码的完整说明）	dby-gateway