mcpField
D
dby-api

dby-api

github.com/zizhanovoMarketing & growth1167 installsUpdated 4w ago
Repository

About dby-api

A CLI skill for retrieving public data and engagement metrics through 都爆鸭, and routing requests to relevant capabilities. It returns data and references for analysis, rather than writing finished copy or creating images.

Key features

  1. 01Access public platform data
  2. 02Retrieve reading and interaction metrics
  3. 03Find topic and account analysis capabilities
  4. 04Look up API schemas before invocation
  5. 05Return data without generating finished content

Use cases

  1. 01Research popular articles and topic trends
  2. 02Review public account engagement metrics
  3. 03Gather reference data for a writing workflow

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/zizhanovo/doubaoya-community --skill dby-api

After installing, type/dby-apiin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.version
LICENSE
README.md
evals/
triggers.jsonl
references/
capability-table.md
compose.md
dby-shim.mjs
gotchas.md
mera-routing.json
retired.md
user-skill-template.md
scripts/
dby.mjs
doubaoya.mjs
scripts/lib/
argv.mjs
capability.mjs
cli.mjs
scripts/lib/commands/
api.mjs
article.mjs
banned.mjs
charter.mjs
doc.mjs
doctor.mjs
draft.mjs
insp.mjs
material.mjs
profile.mjs
retro.mjs
routes.mjs
task.mjs
upload.mjs

Details

From the project README

都爆鸭 · 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

Comments

Markdown supported