skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
zizhanovo/doubaoya-community67 installs

dby-api

都爆鸭(doubaoya/本鸭)新媒体取数包:DOUBAOYA_API_KEY取在架数据,做联网事实核查。只给数据:写正文归 dby-write、查违禁词归 dby-banned-words、排版存草稿归 dby-publish,不确定问 dby。要成品图(出图/改图/配图/主视觉)归 dby-image,本包只给封面与标题的**参考数据**。触发词:小红书:搜索/爬取/作品/创作/选题/标题/封面/排行/榜单/热榜/日榜/周榜/周排行/TOP/热门笔记/爆款笔记/笔记查询、公众号:取数/爬虫/标题/封面/排行/榜单/爆文/黑马/对标、抖音:搜索/取数/评论/实时搜索/综合搜索、视频号:AI/日报/爆款/选题、爆款:文章/标题/封面/结构/仿写/复盘/排行/选题/笔记发现、选题:拆解/灵感/素材/角度/信号、封面:灵感/参考/套路/设计/选题、标题:灵感/优化/套路/生成、账号画像/账号体检/账号健康度/账号发文列表、对标:分析/作品/推荐/矩阵/账号/后再写、竞品:账号/诊断/跟踪/发文复盘、出海:选题/爆款/日报/流量风口、笔记:对标/拆解/生成/选题、内容:创作/灵感/出海、跨平台:选题/分析/热搜、热点:扫描/榜、今日热点/综合热点/追热点/蹭热点/借势选题/找选题/中线选题/短视频选题/全网热搜/热搜关键词/全网热榜/聚合热榜/热榜TOP10/每日榜/今日爆款/一周爆款/近期爆款/全平台爆款/低粉爆款/素人爆款/搜抖音爆款、低粉高赞/黑马笔记/黑马账号/头部账号/热门账号/相似账号/标杆账号/小号打法/冷启动对标/起号参考/公众号诊断/批量诊断/被限流/阅读量掉了/周度趋势/近30天作品/最新发布/最多点赞/持续走高/增长榜/阅读增长/增长率排行/流量风向/热度指数/追流量/追更/话题研究/看赛道热门内容、高点击标题/起标题、查出处/引用来源/联网搜索/联网查证/豆包搜索/社媒舆情/舆情监测/用户需求/评论分析/评论风向/看评论/扒评论区、解析链接/链接解析/作品详情/扒文章/扒抖音作品/照着写小红书/找对标笔记/热门文章/批量爬公众号/盯公众号/订阅公众号/某公众号发了什么、AI视频号/小红书抖音公众号/文旅/短剧/赛道日报/每天在推什么/实时取数

How do I install this agent skill?

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

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill provides a set of tools for new media creators to interact with the doubaoya.com API, including content discovery, drafting, and account analysis. It is implemented as a set of Node.js scripts that act as a CLI for the agent.

  • Socketpass

    No alerts

  • Snykwarn

    Risk: MEDIUM · 2 issues

What does this agent skill do?

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

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/zizhanovo/doubaoya-community/dby-api">View dby-api on skillZs</a>