> 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.

# 怎样让助手或工作流真正读取社媒数据？

> 通过远程 MCP（https://beatapi.io/mcp）为 AI 助手接入 BeatAPI，或在固定工作流中调用 POST https://api.beatapi.io/v1/social-data/call 获取可追溯社媒数据。

助手要真正读取社媒数据，客户端必须能调用 BeatAPI 工具：接入远程 MCP 服务 `https://beatapi.io/mcp`，并确认能列出 `capabilities_search`、`capabilities_inspect` 和 `capabilities_run`。工作流要真正读取数据，需要一个向 `https://api.beatapi.io/v1/social-data/call` 发 POST 的 HTTP 步骤。步骤固定时用 HTTP 流程，问题多变时让助手选择工具。

例如你要从一个公众号选出安装教程，再查小红书和抖音上读者还在问什么。先确认你用的客户端能执行什么，再选固定 HTTP 流程或由助手选择能力。

## 在客户端核对工具

1. **添加服务。** 客户端支持远程 HTTP MCP 和自定义请求头时，把服务地址设为 `https://beatapi.io/mcp`，用客户端凭据保存 `Authorization: Bearer <BEATAPI_API_KEY>`。
2. **核对工具列表。** 保存后确认客户端能列出 `capabilities_search`、`capabilities_inspect` 和 `capabilities_run`。
3. **先试一次。** 让助手找一个能力并核对输入，再请求约定的第一批。
4. **保留记录。** 保存动作、状态、请求号和实际读到的材料。

CLI 助手、桌面扩展和托管工作流的接入方式取决于客户端版本、请求头支持和网络设置。配置失败时，先看工具有没有列出，再分别排查鉴权、传输和执行响应。BeatAPI 的公开读取动作使用 BeatAPI Key。已有的平台插件，其会话状态由插件自己的设置和数据来源决定。

## 流程固定时，用 HTTP 节点

在有 HTTP 步骤的环境里，发 `POST https://api.beatapi.io/v1/social-data/call`，Content-Type 为 `application/json`，Key 保存在连接凭据里。先传一个目标，确认响应，再接筛选和导出步骤。

```json
{"action":"xiaohongshu.app_v2.search_notes","params":{"keyword":"咖啡机 清洁","page":1}}
```

要读已确认公众号的文章目录，在单独的步骤里发：

```json
{"action":"wechat_mp.v2.fetch_account_articles","params":{"username":"<verified_username>","offset":"","item_show_type":0,"raw":false}}
```

只把选中的文章链接传给正文步骤，保留原链接与入选理由。已有小红书或公众号原件时，直接进入筛选与导出。具体结构见[小红书表格流程](/zh/guides/xiaohongshu-note-workflow-handoff)和[公众号目录与统计](/zh/guides/wechat-python-article-review)。

## 按你已有的客户端选择入口

| 环境                              | 先核对                             | 首批交付                 |
| ------------------------------- | ------------------------------- | -------------------- |
| Claude Code、Cursor、Codex 等工具客户端 | 是否能配置远程 HTTP MCP、认证请求头并列出工具     | 一批作品或文章候选与来源         |
| Dify 或扣子等工作流                    | 固定流程用可配置 HTTP 步骤；动态选择先核对 MCP 支持 | 保存输入、原响应和入选链接，之后再补详情 |
| WorkBuddy、豆包或千问办公等桌面客户端         | 已安装版本的连接器是否接受地址与请求头             | 确认实际工具调用和结果，再扩大范围    |
| 使用 DeepSeek 或其他模型的客户端           | 由运行模型的客户端执行查询或提供已存材料            | 分清由工具取得的原文和模型归纳      |
| 当前只能聊天                          | 提交已保存的数据、原文与范围                  | 有出处的摘要、分类和待补项        |

BeatAPI 定义了接口地址和工具规范。各客户端的实际连接、模板和发布仍要在你的环境里确认。已有 Skill 时，可以用 Skill 保存工作步骤和结果要求；执行记录、响应与来源照样要核对。

发给已接好工具的助手，可以这样写：

> 用这条已确认的公众号标识取一批文章目录，选两篇与咖啡机清洁有关的文章读正文。再从小红书和抖音各找一批相关内容。交付原文依据、实际读到的材料类型、请求数和需要补读的具体对象。

要读同一次结果的更多内容，见[结果阅读](/zh/faq/agent-result-reading)。新页与详情是新的查询，单价见[价格页](https://beatapi.io/zh/pricing)。

比如周报每周读同一批账号，就用固定 HTTP 流程保存账号和目录页；编辑临时想查一条新笔记时，再让能调用工具的助手选动作。客户端暂时接不上时，把上周已存的目录和备注交给模型整理，报告上注明采集日期。

## 接 BettaFish 一类分析工具时，先检查输入

BettaFish 这类分析工具显示没有数据时，先确认工具读取的是文件、数据库表还是工具调用。

1. 取一批小红书和抖音的公开样本，保留原响应。
2. 按已安装版本的要求，映射作品 ID、正文或摘录、日期单位和评论关系。
3. 用一条已存素材从读入到查询完整验证一遍。

BettaFish 的实际表结构和连接方式，按你安装的版本核对。BeatAPI 采集流程只交付可追溯的输入文件，不写入 BettaFish 的数据库。

[在 Dify 读取社媒来源](/zh/guides/dify-social-research) · [扣子 HTTP 社媒工作流](/zh/guides/coze-social-research)

[检查 BettaFish 数据并读回样本](/zh/guides/bettafish-social-data)

[查看三种桌面客户端的具体配置](/zh/guides/desktop-social-research-mcp)

* [办公助手接入社媒 MCP](/zh/guides/office-clients-social-mcp)
* [DeepSeek 工具与社媒证据](/zh/guides/deepseek-social-research)