跳到导航

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

助手要真正读取社媒数据,客户端必须能调用 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 保存在连接凭据里。先传一个目标,确认响应,再接筛选和导出步骤。

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

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

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

只把选中的文章链接传给正文步骤,保留原链接与入选理由。已有小红书或公众号原件时,直接进入筛选与导出。具体结构见小红书表格流程和公众号目录与统计。

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

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

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

发给已接好工具的助手,可以这样写:

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

要读同一次结果的更多内容,见结果阅读。新页与详情是新的查询,单价见价格页。

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

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

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

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

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

在 Dify 读取社媒来源 · 扣子 HTTP 社媒工作流

检查 BettaFish 数据并读回样本

查看三种桌面客户端的具体配置