数据查询

豆包联网搜索

doubao-web-search

面向选题、调研和事实核查场景的联网搜索 Skill，输出结构化的综合答案与可追溯来源。

#搜索#核查

这项能力做什么

提交关键词由豆包 WebSearch 异步联网检索（约5分钟内出结果），自动汇总综合答案、引用来源与延伸建议。

能力分类: 数据查询
当前状态: 可使用

输入与输出

以下内容来自当前能力目录，用于理解字段形状，不代表真实调用结果。

输入结构

示例

{
  "query": "2026年AI Agent最新进展"
}

输出结构

示例

{
  "source": "search.doubaoWeb",
  "taskId": "样例任务ID",
  "status": "success",
  "query": "2026年AI Agent最新进展",
  "result": {
    "content": "样例联网搜索综合答案",
    "references": [
      {
        "title": "样例来源",
        "url": "https://example.com/article"
      }
    ],
    "suggestions": [
      "样例延伸提问"
    ]
  }
}

使用文档

公开 SKILL.md 快照，按文档中的步骤和边界使用这项能力。

都爆鸭 · 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 看一眼出参示例。

硬规则

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

下一步

拿到数据之后	去哪
要出图 / 配图 / 改图	`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 随服务端生图能力恢复而重建）。本包只给数据，不出成品图。

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

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

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

交给你的 Agent

复制一条带真实密钥的启动指令

请安装并使用都爆鸭 Skill「豆包联网搜索」。
Skill 标识：doubao-web-search
先在终端运行 dby login 完成授权（它会自动打开浏览器让你点一下批准），再回来继续。
安装完成后，按照这个 Skill 的要求直接执行任务：面向选题、调研和事实核查场景的联网搜索 Skill，输出结构化的综合答案与可追溯来源。

页面只展示不含密钥的预览；复制时才在浏览器内加入真实 Key。

登录后直接调用登录后复制启动指令登录并管理密钥

登录后才能复制带真实密钥的启动指令。