都爆鸭 · doubaoya

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

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

---

怎么调

$SKILL_DIR = 本包目录（宿主加载本 SKILL.md 时给出的目录），统一走 CLI：node "$SKILL_DIR/scripts/dby.mjs" <组> <命令> [参数] [flags]。非 TTY stdout 是单个 {ok,data|error} JSON；退出码 0 成功 / 1 一般错误 / 2 用法错 / 3 业务态 / 4 鉴权 / 5 网络超时（计费请求绝不自动重试）/ 6 需确认（--confirm 放行，回执给的确认命令可原样重放）。参数看 node "$SKILL_DIR/scripts/dby.mjs" <组> <命令> --help。

按组命令名（本文件是全量参考；各包 SKILL.md 只列自己用到的那几条）：

• api：list search describe invoke validate recommend
• write：prep topics review articles
• charter：profiles get put
• draft：create get version review-packet precheck submit comment list versions decide merge comments star link
• article：list get
• profile：list get create update delete wechat-history sample-add sample-list sample-rm
• doc：list get patch put revisions revision restore
• material：list get add rm
• insp：list add
• wechat：status render writing-spec topics review publish media-upload theme-list theme-get theme-add theme-update theme-rm
• task：list
• usage：summary balance logs log log-rm analytics
• banned：check
• 单命令：doctor retro upload whoami routes

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

→ 要把命令串成自己的流程时读 references/compose.md；要照抄骨架写自己的 SKILL.md 时读 references/user-skill-template.md。

---

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

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

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

别人写文章时会来本包取的几样素材（给数据，不代替他写）： api.gzh.hotArticle 同主题爆文样本、api.gzh.cozeData 同赛道爆款标题与封面套路。 这些都是数据与参考，不会生成成品图。

🔴 路由由 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（2026-09 随服务端生图能力恢复而重建）。本包给的是封面数据——同赛道爆款的封面图 URL、标题与点击量，供你自己提炼套路，不出图。

❌ 选题铁律：不要拿用户的账号名 / IP 名当关键词去搜。 用户的公众号/账号名（如「菜籽油」）是他是谁（领域/人设/受众），不是搜索词——搜它只会搜到字面同名内容。 综合热点用无关键词的 api.trend.hotSpotKeyword 直取，IP 名字只用于匹配筛选。 「不带关键词」说的是关键词——时间窗口照样要收窄（见 Gotchas 第一条）。 跨平台趋势雷达（skill.trend.radar）按关键词搜三平台的文章、不是榜，keyword 必填： 手里已经有话题时用它，看这个词在抖音 / 小红书 / 公众号分别被谁怎么写； 没有话题、要它给你想选题时别用——那种需求走上面的 api.trend.hotSpotKeyword。

---

失败了怎么办

报错码逐条怎么处置（noResult 不是失败、哪些可重试哪些绝不能重试、404 该去另一个集合找） 见 dby-gateway/references/protocol.md 第 6 条。 照做仍绕不过去、或想吐槽 → 可提一句用 dby-feedback 当场写成反馈（可忽略，不再重复提）。

---

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

---

能力索引表（该调哪一条）

查路由时读它：不知道该点名哪条能力、或不确定它走哪条路由时读。已经知道调哪条就别读—— 入参一律走 describe 现拉，这份表一个字段名都不抄。

🔑 每行给三样东西：能力的 operationKey、一句用途、详情端点（GET，免鉴权免费）。 要发请求，直接把这一行的 operationKey 或详情端点尾段交给 describe / invoke。 ⚠️ 第四列是详情端点，不是调用地址——调用地址只有一个来源：详情响应里 execution 的 target。 表里没有你要的能力时，先 node "$SKILL_DIR/scripts/dby.mjs" api list（$SKILL_DIR = 本包目录）把两个集合都翻一遍；本表是起手线索，不是全量清单。

选题 / 热点 —— 通用选题从这一档起手

用户这么说（运营白话）	该调哪条	一句话用途	详情端点（GET，免鉴权免费）
"最近全网在火什么？给我点选题" —— 🔴 不带关键词、但要收窄时间窗口，通用选题的正确起手	api.trend.hotSpotKeyword	全网热点聚合直取，通用选题首选。⚠️ 不收窄时间窗口时返的是近 30 天池子、中位 15 天前（实测），要「今天」必须按详情端点里的起止时间字段收窄	/api/apis/trend/trending-hub-keyword
"全网热搜 / 热搜关键词 / 热榜TOP10 / 出一批热词当选题种子"	api.trend.hotKeywords	全网热搜关键词	/api/apis/trend/hot-keywords
"我已经有一个话题了，看它在各平台分别热成什么样 / 跨平台分析 / 出一份运营日报"（带关键词才用它；不带关键词的通用选题走本表首行）	skill.trend.radar	跨平台趋势雷达：给一个关键词，到抖音 / 小红书 / 公众号各搜一次近期文章，按平台归并成对照清单。不是榜，也不产日报——日报得你自己拿这批原文去写。keyword 必填	/api/skills/trend-radar
"某个词近 30 天在各平台被讨论成什么样 / 近30天作品 / 社媒舆情 / 舆情监测"	api.multi.workSearch	全平台近30天作品聚合	/api/apis/multi/cn30-multi-search
"这个词在各平台分别被怎么写"（CN 版，与上一条是两条能力）	skill.social.last30Days	Last 30 Days—CN版：与 skill.trend.radar 同一个底座，三平台各搜一次文章。⚠️ 没有任何讨论量/情感/趋势指标（上游不返回），days 参数只回显不过滤。keyword 必填	/api/skills/cn-last30days
"内容出海 / 出海爆款 / 出海日报 / 出海选题 / 出海流量风口 / 全平台爆款"	api.multi.contentExportTop	全平台内容出海Top榜	/api/apis/multi/multi-content-export-top

小红书

用户这么说（运营白话）	该调哪条	一句话用途	详情端点（GET，免鉴权免费）
"我这个赛道在涨啥 / 爆款笔记发现 / 小红书热门笔记 / 找对标笔记"	skill.xhs.viralNotes	小红书爆款笔记发现	/api/skills/xiaohongshu-viral-notes
"搜小红书笔记 / 小红书搜索 / 小红书笔记查询 / 小红书爬取"	api.xhs.searchNote	搜索小红书笔记	/api/apis/xiaohongshu/search-note
"搜小红书作品 / 照着写小红书 / 对标后再写（先取数再动笔）"	api.xhs.searchWork	搜索小红书作品	/api/apis/xiaohongshu/search-work
"批量爬小红书作品 / 小红书爬虫 / 小红书作品采集"	api.xhs.crawlWork	小红书作品采集	/api/apis/xiaohongshu/crawl-work
"小红书封面怎么做 / 首图套路 / 封面选题 / 起个小红书标题 / 笔记拆解 / 笔记对标 / 对标分析 / 选题拆解 / 爆款结构"	api.xhs.cozeData	小红书爆款封面/标题/笔记分析数据	/api/apis/xiaohongshu/xiaohongshu-coze
"小红书日榜 / 小红书 TOP / 今日爆款笔记"	api.xhs.cozeDailyTop	小红书日榜	/api/apis/xiaohongshu/xiaohongshu-daily-top
"小红书周榜 / 小红书周排行 / 一周爆款 / 周度趋势 / 中线选题"	api.xhs.cozeWeeklyTop	小红书周榜	/api/apis/xiaohongshu/xiaohongshu-weekly-top
"低粉爆款 / 素人爆款 / 黑马笔记 / 低粉高赞 / 小号打法 / 冷启动对标"	api.xhs.cozeLowFansTop	小红书低粉爆款榜	/api/apis/xiaohongshu/xiaohongshu-low-fans-top

抖音

用户这么说（运营白话）	该调哪条	一句话用途	详情端点（GET，免鉴权免费）
"搜抖音作品 / 抖音搜索 / 抖音综合搜索 / 扒抖音作品 / 短视频选题"	api.douyin.searchWork	搜索抖音作品	/api/apis/douyin/search-work
"抖音实时搜索 / 抖音最新发布 / 刚发出来的那批"	api.douyin.realtimeSearch	抖音实时搜索	/api/apis/douyin/realtime-search

公众号

用户这么说（运营白话）	该调哪条	一句话用途	详情端点（GET，免鉴权免费）
"搜公众号文章 / 公众号取数 / 热门文章 / 扒文章"	api.gzh.searchArticle	搜索公众号文章	/api/apis/gongzhonghao/search-article
"公众号爆文 / 爆款文章 / 爆款仿写 / 写公众号先拉样本"	api.gzh.hotArticle	公众号爆文搜索	/api/apis/gongzhonghao/hot-article
"公众号热门文章 / 只要真火过的（阅读量有下限那种）"（与上一条是两条能力：这条按阅读量门槛筛，拿的是"确实火过"的样本）	skill.wechat.hotSearch	公众号热门文章查询	/api/skills/wechat-search
"公众号封面怎么做 / 爆款封面 / 起个公众号标题 / 标题套路 / 高点击标题"	api.gzh.cozeData	公众号爆款封面数据（返回同赛道爆款的封面图 + 标题 + 点击量，给你数据自己提炼）	/api/apis/gongzhonghao/gongzhonghao-coze-cover
"直接给我一版公众号封面"（给标题就出一张成品封面图，不是数据；与上一行是两条能力，别混）	skill.wechat.coverDesign	公众号封面图制作：title 必填、digest 可选，走与生图同一条出图通道，返回内联 base64。慢操作、计费、失败别重试 —— 要多张候选或要改图请走 dby-image	/api/skills/wechat-cover
"追更某个号 / 盯公众号 / 订阅公众号 / 账号发文列表 / 竞品发文复盘 / 某公众号发了什么"	api.gzh.workList	公众号账号发文列表。🔴 必须先过 api.gzh.searchUser 拿账号 ID，上游只认 ID 不认中文昵称	/api/apis/gongzhonghao/gongzhonghao-work-list
"公众号 10 万+ / 原创爆文 / 原创热文 / 原创热门榜"	api.gzh.categoryTime	公众号10万+/原创榜	/api/apis/gongzhonghao/category-time-hot
"头部账号 / 公众号排行 / 公众号榜单 / 热度指数 / 热门账号"	api.gzh.indexRank	公众号热门账号榜	/api/apis/gongzhonghao/gongzhonghao-index-rank
"公众号阅读增长 / 增长榜 / 增长率排行 / 持续走高"（要账号级的增量与名次）	api.gzh.raiseRank	公众号阅读增长榜	/api/apis/gongzhonghao/gongzhonghao-raise-rank
"黑马账号 / 公众号黑马 / 流量风向 / 增长榜里每个号给我一篇代表作"（与上一条同一条上游线，但是两条能力：这条按作者去重、每人只出最高阅读那篇，标题可直达原文）	skill.wechat.fastestGrowing	公众号黑马账号推荐	/api/skills/wechat-fastest-growing
"公众号 AI 这块在发什么 / 公众号 AI 日报"	api.gzh.aiFeed	公众号AI日报源	/api/apis/gongzhonghao/gongzhonghao-ai-feed
"公众号文旅 / 短剧这块在发什么 / 每日榜"	api.gzh.playletFeed	公众号文旅/短剧日报源	/api/apis/gongzhonghao/gongzhonghao-playlet-feed
"按名字找公众号 / 这个号叫什么 ID"（三步编排的第一步，见下方 A 股例子）	api.gzh.searchUser	公众号账号搜索	/api/apis/gongzhonghao/gongzhonghao-search-user
"某天各号发了什么 / 每日发文查询"	api.gzh.dailyPublish	公众号每日发文查询	/api/apis/gongzhonghao/gongzhonghao-daily-publish
"我这个公众号做得怎么样 / 账号体检 / 账号健康度 / 账号画像 / 公众号诊断 / 批量诊断 / 竞品诊断"（给账号名，拉粉丝、发文、阅读等真实运营指标，用数据看清现状与体量）	skill.wechat.accountAnalyzer	公众号账号诊断	/api/skills/wechat-account-analyzer
"给我找几个同赛道的号对标 / 公众号对标 / 相似账号 / 对标推荐 / 对标矩阵 / 竞品账号 / 起号参考"（3 层加权匹配，同时给同阶对标号与高阶标杆号）	skill.wechat.similarAccount	公众号相似账号推荐	/api/skills/wechat-similar-account
"短剧赛道的公众号热门文章日报"（产品化 Skill 侧，与上面的日报源是两条）	skill.playlet.wechatFeed	短剧-公众号信息源	/api/skills/playlet-wechat-feed

视频号

用户这么说（运营白话）	该调哪条	一句话用途	详情端点（GET，免鉴权免费）
"视频号最近什么在爆 / 视频号上 AI 这块在火什么 / 视频号日报 / 视频号选题"	api.sph.aiFeed	视频号AI日报源	/api/apis/sph/shipinhao-ai-feed
"搜视频号作品 / 视频号爆款"	api.sph.searchWork	搜索视频号作品	/api/apis/sph/search-work
"找视频号账号"	api.sph.searchUser	搜索视频号账号	/api/apis/sph/search-user
"AI 视频号信息源"（产品化 Skill 侧，与 api.sph.aiFeed 是两条）	skill.wechatChannels.aiFeed	AI视频号信息源	/api/skills/wechat-channels-ai-feed

解析 / 合规 / 素材 / 查证

用户这么说（运营白话）	该调哪条	一句话用途	详情端点（GET，免鉴权免费）
"这条链接为什么火 / 解析链接 / 链接解析 / 作品详情 / 拆给我看"	tool.content.parseDetail	解析作品/文章详情	/api/apis/tool/parse-content-detail
"帮我把这段文案过一遍别违规 / 违禁词 / 合规检测 / 过审 / 极限词 / 广告法"（多平台口径）	tool.contentSafety.checkWords	多平台违禁词检测（入口请求走 dby-banned-words，此处仅为 endpoint 索引）	/api/skills/content-safety-check
"公众号这篇能不能发 / 公众号违禁词"（公众号口径，与上一条是两条）	skill.wechat.prohibitedWord	公众号违禁词检测（入口请求走 dby-banned-words，此处仅为 endpoint 索引）	/api/skills/wechat-prohibited-word
"这事儿是真的吗 / 联网搜索 / 联网查证 / 事实核查 / 查出处 / 引用来源 / 豆包搜索"	skill.search.doubaoWeb	豆包联网搜索	/api/skills/doubao-web-search

🔴 上表两条违禁词能力的 content 单次上限 2000 字（上游硬限，服务端扣点前就 400 拒掉）。 直调这两条时自己按 2000 字分段；走 dby-banned-words 的 banned check 不用管——它自动分段、 逐段计费（计费 = 平台数 × 段数）。

不是一条能力、得自己编排的（表里查不到是正常的，别硬凑一条）：

• "A股公众号 / 股市大V / 股票公众号榜单" —— 三步：api.gzh.searchUser 搜号 → api.gzh.workList（或 api.gzh.dailyPublish）拉发文 → api.gzh.hotArticle 找爆文。
• "我是不是被限流了 / 阅读量掉了 / 推荐流量没了" —— 不是取数能算的：skill.wechat.accountAnalyzer 只看公开体量；限流判定走后台「账号检测」，官方口径见 references/gotchas.md。
• "把这条爆款改写成我的文案" —— 不调接口：Skill dby-rewrite 一个包管七个平台 （公众号 / 视频号 / 抖音 / 快手 / B站 / 小红书 / 知乎，也能一稿多发），纯本地、不要 key。 没装就用搜来的素材由你合成。
• "帮我记一下 / 查查我的笔记 / 我是个什么样的人" —— ⛔ 第二大脑（mera）已下架， 无替代能力：如实告知，别拿公开搜索顶替（见上方「我自己的东西」例外）。
• ⛔ seedream-lite（Seedream 5.0 lite）已于 2026-08-10 下架，调用一律 503， 所以它不在上表里。要公众号封面数据走 api.gzh.cozeData（给数据不出图，见上表）。
• "给我配张图 / AI 出图 / 文生图 / 图生图 / 改图 / 生成图片 / 主视觉" —— 走 dby-image （2026-09 随服务端生图能力恢复而重建）。本包只给数据，不出成品图。

首次上手三句话（用户第一次用时，可主动这么引导）：

1. 先确认有没有 key（没有就带他走「拿钥匙」那一节，一次就好）。
2. 问一句"你现在想做选题、追热点、还是查账号？"——把模糊需求收敛到上面某一类。
3. 选一个能力先跑一次出结果，让用户看到真东西，再顺势引导下一步 / 订阅。

别一上来甩一长串能力清单给用户看——用户要的是"帮我做事"，不是 API 目录。 operationKey 是你内部选路用的。