> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# 怎样用 WorkBuddy、豆包工作或千问办公查社媒资料？

> 分别设置 WorkBuddy、豆包工作、千问办公，查一批可回到原文的公开社媒材料。

在 WorkBuddy、豆包工作或千问办公里添加一个 **BeatAPI 自定义连接器**，地址填 `https://beatapi.io/mcp`，请求头带 Bearer 鉴权。添加后客户端会出现 `capabilities_search`、`capabilities_inspect` 和 `capabilities_run` 三个工具，可在对话里查询公众号文章、小红书笔记或抖音视频。写周报时，先用核对过的公众号标识查一页文章，把值得读的文章连同原标题和链接发给同事。

## 在你用的客户端添加连接器

三款客户端都填同样的三个值：服务器名称 `beatapi`、地址 `https://beatapi.io/mcp`、请求头 `Authorization: Bearer <BEATAPI_API_KEY>`。在客户端的凭据或自定义 Header 里填入真实密钥。开始任务时，在提问里写出连接器名称和业务目标。

| 客户端       | 添加与启用                                                                                                                 |
| --------- | --------------------------------------------------------------------------------------------------------------------- |
| WorkBuddy | 打开 **专家·技能·连接器 → 连接器 → 自定义连接器**，选择可流式 HTTP，填地址和 Header。编辑 MCP JSON 时，传输类型写 `streamableHttp`。工具没出现时，检查安全中心的自定义 MCP 开关。 |
| 豆包工作      | 打开电脑版的 **技能、连接器与伙伴** 页面，选择新建自定义插件或连接器。传输选 **HTTP**，在自定义 Headers 添加鉴权头。保存并启用后，新建一次任务。                                  |
| 千问办公      | 打开 **扩展 → 连接器 → 添加 → 手动填写配置**，类型选 **Streamable HTTP**。在库的「已安装」里启用该服务，再新建对话。使用 JSON 导入时，类型字段写 `streamable-http`。       |

如果组织统一管理扩展，先确认客户端允许自定义连接器、`beatapi` 服务已启用。然后在工具列表里找 `capabilities_search`、`capabilities_inspect` 和 `capabilities_run`。部分客户端会在工具名前加服务器名前缀。

[WorkBuddy 连接器](https://www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Connector) · [WorkBuddy 传输类型](https://open.workbuddy.cn/docs/connector) · [豆包工作插件](https://www.doubao.com/work/docs/zh-cn/articles/705018132598-plugins) · [千问办公连接器](https://qwenwork.cn/docs/features/connectors)

## 试查一页，再决定要不要读正文

> 使用 beatapi 连接器，先找公众号历史文章列表并检查它的必填参数和价格。等我给已确认的账号标识后，只查第一页。给出文章标题、原文链接、查询范围和请求号。我选中文章后再读正文。

把核对过的公众号 `username` 传给 `data:wechat_mp.v2.fetch_account_articles`，传 `raw:false` 取简化列表。选文章前，先确认返回的原文链接属于目标账号。列表为空时，记下本次的请求号和查询范围；工具调用失败时，检查连接或入参，不记成「该号没发文」。

客户端能查看工具入参时，用下面这组参数对照。`reference` 先与 `capabilities_inspect` 的结果核对，账号换成已确认的标识。本例只读第一页。

```json
{
  "reference": "data:wechat_mp.v2.fetch_account_articles",
  "operation": "start",
  "input": {"username": "<verified_username>", "item_show_type": 0, "raw": false},
  "view": "preview"
}
```

同一个客户端也能做[小红书关键词选题](/zh/guides/xiaohongshu-notes-research)和[抖音视频研究](/zh/guides/douyin-python-research)。两种搜索结果都先按平台、对象 ID、来源链接和摘录范围留档，评论、详情和下一页只在需要时读取，费用见 [BeatAPI 价格页](https://beatapi.io/zh/pricing)。

## 周报里可以交付什么？

例如对手的公众号目录里有一篇《秋季新品发布》，同事想知道具体上市日期：

1. 先交付一条候选：原标题、原文链接、列表摘要和请求号。
2. 按文章链接读正文，核对日期。
3. 首页只看到《活动回顾》、没有覆盖周报需要的日期时，简报写「已查该账号首页，日期范围待补」，再决定是否翻页。

已有账号标识时，查一页目录再读三篇入选正文，共 4 次数据请求。只有账号昵称时，先[核对公众号标识](/zh/faq/wechat-account-identifier)，实际发生的账号查找和额外列表页另计。

## 如果只看到一段回答，怎样判断工具真的跑了？

打开这次任务的工具记录，找实际的 BeatAPI 查询、请求号和返回记录；连接器已启用并不说明查询已经执行。出现 `401` 时，确认请求发往正确地址、`Bearer` 后面有一个空格、密钥仍然有效。新建任务后仍看不到工具时，检查客户端的开关和权限。暂时无法接入的客户端也可以用已保存的材料完成简报，并标注材料的来源和采集时间。

例如助手写「新品下周上市」，工具记录里却只有公众号列表摘要。先请助手指出摘要里支持这句话的原文。摘要只说「秋季发布」时，简报写「计划秋季发布，具体日期待查」；需要日期时只补读这篇文章。把文章 URL 和请求号留给下次做周报的同事。

[公众号目录与增量检查](/zh/guides/wechat-incremental-articles) · [其他客户端接入入口](/zh/guides/social-research-client-setup)