# 都爆鸭 · AI Agent 接入文档 > 这是给 AI Agent 读取的纯文本接入说明。人类版位于 https://doubaoya.com/start。 > 选择当前使用的 Agent，只复制对应的一条完整指令。未实际验证能发现并调用能力前，不要声称接入成功。 ## 选择 Agent，复制一条指令 ### WorkBuddy **按官方指南接入**：使用 WorkBuddy 当前支持的 Skill 或 MCP 方式；都爆鸭没有专属 WorkBuddy 脚本或现成 MCP 服务。 请完成都爆鸭接入：先阅读官方 https://doubaoya.com/llms.txt，并按 WorkBuddy 当前支持的 Skill 或 MCP 指南配置。都爆鸭没有专属 WorkBuddy 一键脚本或现成 MCP 服务，不要声称存在或已经接入。若缺少 DOUBAOYA_API_KEY，只引导我去都爆鸭密钥中心创建，并在本机安全设置环境变量；不要索要、回显，或要求我把密钥粘贴到聊天、代码、截图或日志。完成配置后实际验证能发现并调用一项都爆鸭能力；只有验证成功才说明接入完成，否则明确说明还缺什么。 ### Qoder **运行公开安装命令**：在当前项目运行公开安装命令，一次装齐全部 Skill，之后按任务直接使用装好的 Skill。 请在当前项目完成都爆鸭接入：运行 curl -fsSL https://doubaoya.com/install.sh | sh，它会把全部都爆鸭 Skill 一次装进当前项目；装完直接从已装好的 Skill 里挑匹配当前任务的来用，它们各自的 description 就是路由，不需要再下载或生成别的能力文档。若缺少 DOUBAOYA_API_KEY，只引导我去都爆鸭密钥中心创建，并在本机安全设置环境变量；不要索要、回显，或要求我把密钥粘贴到聊天、代码、截图或日志。完成配置后实际验证能发现并调用一项都爆鸭能力；只有验证成功才说明接入完成，否则明确说明还缺什么。 ### CodeBuddy **运行公开安装命令**：在当前项目运行公开安装命令，一次装齐全部 Skill，之后按任务直接使用装好的 Skill。 请在当前项目完成都爆鸭接入：运行 curl -fsSL https://doubaoya.com/install.sh | sh，它会把全部都爆鸭 Skill 一次装进当前项目；装完直接从已装好的 Skill 里挑匹配当前任务的来用，它们各自的 description 就是路由，不需要再下载或生成别的能力文档。若缺少 DOUBAOYA_API_KEY，只引导我去都爆鸭密钥中心创建，并在本机安全设置环境变量；不要索要、回显，或要求我把密钥粘贴到聊天、代码、截图或日志。完成配置后实际验证能发现并调用一项都爆鸭能力；只有验证成功才说明接入完成，否则明确说明还缺什么。 ## 先分清两种能力 - 可安装 Skill 包：来自公开技能库的目录。能跑 shell 的 Agent 跑一条 `curl -fsSL https://doubaoya.com/install.sh | sh` 就把它们全部装进当前项目；装好之后照每个 Skill 自己的 description 选用，不需要另外维护一份能力文档。也可以用 `npx skills add` 单独装某一个。 - API 能力：都爆鸭目录里的 HTTP 接口，带密钥直接调用即可拿到结构化数据，**不能**用 `npx skills add` 安装。它又分成 Skill 能力与平台 API 能力两份清单，调用路由各不相同，下面分开列。 - 三份名单下面分开列。API 能力的标识（slug）不是技能库目录名，别把 slug 拼进安装命令。 ## 鉴权与调用 所有调用使用同一把真实密钥。只在本机安全设置环境变量 DOUBAOYA_API_KEY；不要索要、回显，或把密钥粘贴到聊天、代码、截图、提交与日志。 Authorization: Bearer $DOUBAOYA_API_KEY GET https://doubaoya.com/api/skills GET https://doubaoya.com/api/apis GET https://doubaoya.com/api/skills/search?query=<你的需求> POST https://doubaoya.com/api/skills/recommend ## 先发现，再按 execution.target.path 调用 能力清单分两份且**互不重叠**：`GET /api/skills` 返回 Skill 能力，`GET /api/apis` 返回平台 API 能力。同一个能力只会出现在其中一份里，两条调用路由也各管一半——拿 Skill 的路由去调平台 API 能力只会 404。 别自己记哪个能力走哪条路由。清单里每条能力都自带 `execution.target`（`method` + `path`，`path` 已经是完整路径），调用地址一律从这里取：多数能力是 `POST /api/skills//invoke` 或 `POST /api/apis///call`，少数走专用路由（`execution.mode` 为 `dedicated`，如公众号排版与草稿写入）。`execution.mode` 为 `unavailable` 的能力当前调不通，直接跳过。 入参规格（`inputContract`）**只在单条详情端点上**：`GET /api/skills/` 与 `GET /api/apis//`。两份列表端点都不带它（JSON Schema 有体积，列表用不上）。所以要按规格拼参数，必须先拉一次详情，别指望从列表里读到。 `POST /api/skills/recommend` 按自然语言任务描述给推荐：请求体 `{ "query": "你的任务", "category": "全部", "limit": 6 }`，`query` 必填（为空返回 400 INVALID_PARAMS）；`data` 里有 `primary`、`candidates`、`signals` 与 `decisionSummary`，每个候选同样带 `execution.target.path`。注意它**只在 Skill 能力里排序**，平台 API 能力不参与推荐，要找那一半请直接读 `GET /api/apis`。 GET https://doubaoya.com/api/skills → data.items[].execution.target.path GET https://doubaoya.com/api/apis → data.items[].execution.target.path GET https://doubaoya.com/api/apis// → 单条详情：输入结构与输出示例 POST https://doubaoya.com<上一步取到的 execution.target.path> ## 返回信封 所有 API 返回 `{ success, requestId, data, error }`。成功时读取 `data`；失败时读取 `error`；保留 `requestId` 用于排查和对账。缺失字段如实留空，不要编造。 `notice`（如「你的 skill 有新版本」）只在真有话说时出现：没有提示时这个字段**整个不在响应里**，不是 `null`。所以请按字段是否存在来判断，别写 `notice === null` 那种判断——它永远不成立。 ## 能力找不到（404）：先更新一次 Skill，再重试一次 拿到 404（`SKILL_NOT_FOUND` / `ENDPOINT_NOT_FOUND`）先按上一节处理：两份清单互不重叠，去**另一份**发现接口里找同名能力，别猜 slug、别换着花样重试。 两份发现接口里**都**找不到这条能力时，多半是本机 skill 已经过期——它点名的能力早就下架了。跟用户说一句「你的本鸭 skill 可能过期了」，让他跑一次 `/dby-update`（或直接说「更新都爆鸭」），然后**只重试这一次**。🔴 重试仍是 404 就如实告知该能力已下架，**不许再更新、不许成环**。 🔴 只有上面这一条 404 走「先更新再重试」。别的错一律不许触发更新：401 去密钥中心重建密钥、400 照 `message` 改入参、402 提示用户充值——重装 skill 一个都解决不了。 ## 公众号草稿边界 公众号能力只能写入草稿箱，绝不代替用户群发。涉及多个已授权公众号时，先确认目标账号。写入前先查询授权状态。 GET https://doubaoya.com/api/wechat/status POST https://doubaoya.com/api/wechat/publish ## 可直接复用的玩法 - [跨平台找近 30 天选题](https://doubaoya.com/recipes/topic-discovery-last-30-days)：同时查看小红书、抖音和公众号的真实作品，用互动依据比较不同平台的内容切口。 - [从公众号爆文到文章大纲](https://doubaoya.com/recipes/wechat-hot-articles-to-outline)：先列真实互动依据，再提炼标题套路、内容空白和可继续写的文章结构。 - [一次检查三平台违禁词](https://doubaoya.com/recipes/multi-platform-banned-words)：分别按小红书、抖音和公众号规则检查风险，并生成一版更保守的通用改写。 - [把 Markdown 存进公众号草稿箱](https://doubaoya.com/recipes/markdown-to-wechat-draft)：让 Agent 套用已保存的主题并写入选定公众号，只生成待人工确认的草稿。 ## 可安装 Skill 包（7 项） 装进 Agent 后用自然语言或斜杠命令触发，全部来自公开技能库 https://github.com/zizhanovo/doubaoya-community。 能跑 shell 的 Agent 不用逐条装：一条 `curl -fsSL https://doubaoya.com/install.sh | sh` 会把技能库的全部包一次装进当前项目，下面这些都在内。 要单独装某一个，就用它那行反引号里的完整命令。 - `npx skills add zizhanovo/doubaoya-community/skills/dby` **推荐主入口** · 都爆鸭公众号工具箱主入口 — 装好后输入 /dby，按「选题 → 写草稿 → 排版 → 代发 → 复盘 → 反哺选题」的飞轮，逐跳把你路由到该用的技能。第一次用输入 /dby 新手入门。 - `npx skills add zizhanovo/doubaoya-community/skills/dby-api` 都爆鸭取数与创作总入口 — 一条 DOUBAOYA_API_KEY 调平台全部在架能力（搜索/榜单/日报源/账号/解析/违禁词/生图/联网查证），按意图路由到具体那一条。公众号爆文样本、爆款封面与标题数据、小红书笔记搜索都在这儿。 - `npx skills add zizhanovo/doubaoya-community/skills/dby-write` 公众号写作主干 — 从读你的号章程与创作 DNA 开始，经选题、定标题、列提纲、写正文、摘要留言、成稿自检，一口气写完一篇像你本人写的公众号文章；也管复盘——按你自己的历史均值分四象限，只告诉你该修哪一处。 - `npx skills add zizhanovo/doubaoya-community/skills/dby-image` AI 生图与改图 — 一句话要一张图：文生图、图生图、改图、主视觉、单独配一张插图。含各平台封面骨架（公众号 / 小红书 / 抖音视频号）与提示词阶梯。慢操作，出图后落成本地文件给你路径。 - `npx skills add zizhanovo/doubaoya-community/skills/dby-publish` 公众号图文流水线 — 正文写好之后的确定性运维：md→公众号 HTML 渲染、本地图片预上传、配封面，最终存进你自己公众号的草稿箱（只存草稿、绝不群发）。 - `npx skills add zizhanovo/doubaoya-community/skills/dby-banned-words` 多平台违禁词检测 — 发布前检测敏感词和平台风险词，返回高亮命中的 HTML 内容与违禁词类别。 - `npx skills add zizhanovo/doubaoya-community/skills/dby-charter` 定位教练 · 号章程 — 想清楚定位/变现/该写什么号：装到你自己的 agent 里对话式问诊，L0 三问 5 分钟出最小章程、L1 十五问深化、老号反推校对；章程存回服务端后，选题/写作/复盘都按它走。三条专用接口全程免费不扣点。 ## Skill 能力（HTTP 调用，17 项） 这些是接口不是 Skill 包，装不进 Agent。默认调用地址是下面这条；个别能力走专用路由（下面的说明里写明了是哪条），一律以清单接口返回的 `execution.target.path` 为准： POST https://doubaoya.com/api/skills/<下面列出的 slug>/invoke 完整清单（含每条的 `execution.target`、输入结构与输出示例）： GET https://doubaoya.com/api/skills - `playlet-wechat-feed`：短剧-公众号信息源 — 面向短剧创作者和内容运营的公众号爆款追踪工具，每日汇总热门文章、题材方向和互动表现。 - `doubao-web-search`：豆包联网搜索 — 提交关键词由豆包 WebSearch 异步联网检索（约5分钟内出结果），自动汇总综合答案、引用来源与延伸建议。 - `cn-last30days`：Last 30 Days—CN版 — 搜索近 30 天中文社交媒体真实讨论数据，跨平台对比舆情趋势并输出结构化研究报告。 - `gpt-image-gen`：GPT-image2 — AI 图片生成与改图工具，支持文生图、图生图和内容创作场景的快速素材探索。 - `wechat-channels-ai-feed`：AI视频号信息源 — 每日扫描视频号 AI 相关作品，按互动量筛选高热内容并聚类生成可视化日报。 - `trend-radar`：跨平台趋势雷达 — 一次请求聚合多个平台热点，快速生成选题方向和运营日报。 - `xiaohongshu-viral-notes`：小红书爆款笔记发现 — 按关键词发现高互动笔记，返回标题、作者、互动指标和发布时间。 - `content-safety-check`：多平台违禁词检测 — 发布前检测敏感词和平台风险词，返回高亮命中的 HTML 内容与违禁词类别。 - `wechat-draft-publish`：公众号草稿箱写入 — 把写好的图文一键存进你自己授权的微信公众号草稿箱：先授权绑定公众号，再发布图文草稿，只存草稿、不群发。每次成功调用 1 点。注意：本能力走专用接口 POST /api/wechat/publish，不走 /api/skills//invoke 通用代理。 - `wechat-render`：公众号排版渲染 — 把 Markdown 一键渲染成公众号内联样式 HTML，可套内置主题或你自己保存的主题，直接贴进公众号草稿。免费不扣点。注意：本能力走专用接口 POST /api/wechat/render，不走 /api/skills//invoke 通用代理。 - `dby-charter`：定位教练 · 号章程 — 想清楚定位/变现/该写什么号：装到你自己的 agent 里对话式问诊，L0 三问 5 分钟出最小章程、L1 十五问深化、老号反推校对；章程存回服务端后，选题/写作/复盘都按它走。三条专用接口全程免费不扣点。 - `wechat-similar-account`：公众号相似账号推荐 — 公众号创作者对标账号匹配工具，基于 3 层加权匹配体系（核心基础 40% + 运营变现 35% + 数据特征 25%）智能推荐同阶对标账号和高阶标杆账号，帮助创作者精准定位赛道、复制成功打法、规划增长路径。 - `wechat-account-analyzer`：公众号账号诊断 — 输入公众号名称，拉取该账号的真实运营指标（粉丝、发文、阅读等维度数据），用数据看清账号现状与体量。 - `wechat-fastest-growing`：公众号黑马账号推荐 — 直接对接官方阅读增长率榜单，按日期查看公众号阅读增速 TOP 排行，每个作者只展示最高阅读那篇，标题一键直达原文。 - `wechat-search`：公众号热门文章查询 — 公众号热门文章搜索工具，帮你快速找到公众号平台阅读数>5000 的热门文章，获取创作灵感，把握内容趋势。 - `wechat-prohibited-word`：公众号违禁词检测 — 发布前扫描公众号文案里的违禁词与敏感表述，返回高亮命中的 HTML 内容与违禁词类别，帮你安全过审、避免删文限流。 - `wechat-cover`：公众号封面图制作 — 基于全网每日持续收录的 10w+ 文章数据，获取同赛道爆款封面的视觉元素，通过 AI 分析总结高转化视觉规律，生成贴合文章内容、符合平台流量审美的封面设计方案。 ## 平台 API 能力（HTTP 调用，77 项） 另一半能力在这里，数量太多不逐条列。它们**不在** `/api/skills` 里，也**不能**用 `/api/skills//invoke` 调用——各自的调用地址是： POST https://doubaoya.com/api/apis///call 用下面两条接口获取平台、能力标识、输入结构和输出示例，不要在 Agent 内维护一份会漂移的副本： GET https://doubaoya.com/api/apis GET https://doubaoya.com/api/apis// ## 参考 - 人类版接入页：https://doubaoya.com/start - 公开技能库：https://github.com/zizhanovo/doubaoya-community - Skill 能力清单：https://doubaoya.com/api/skills（17 项，走 /api/skills//invoke） - 平台 API 能力清单：https://doubaoya.com/api/apis（77 项，走 /api/apis///call）