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

# 怎样在 Dify 工作流里查小红书和公众号，输出带出处的研究材料？

> 在 Dify 配置 HTTP 或 MCP，把真实返回的笔记和公众号文章交给下游。

每周都要做同一份选题简报时，在 Dify 工作流里用两个 **HTTP Request** 节点：一个调用 `xiaohongshu.app_v2.search_notes` 搜小红书笔记，另一个调用 `wechat_mp.v2.fetch_account_articles` 列出指定公众号的文章。要让 Dify Agent 根据提问决定查哪个平台，改为把 BeatAPI 接成 **MCP** 服务器。第一次可以用「咖啡机除垢」找用户遇到的问题，同时从一个已确认的公众号选出教程。

[Dify 模型接入](/zh/integrations/dify) · [怎么核对助手找到的素材](/zh/faq/assistant-social-research)

## 配置固定的 HTTP 路线

1. 在 **Workflow** 的开始节点增加两个字符串输入：`keyword`（小红书搜索词）和 `account_username`（核对过的公众号标识）。
2. 添加两个 **HTTP Request** 节点，都 POST 到 `https://api.beatapi.io/v1/social-data/call`。
3. 选择 Bearer 鉴权，把 BeatAPI Key 存为 Secret 类型的环境变量，用变量选择器引用。
4. 请求体类型选 JSON，分别填入下面对应的结构，再用 Dify 变量选择器替换占位值。

```json
{"action":"xiaohongshu.app_v2.search_notes","params":{"keyword":"<keyword>","page":1}}
```

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

用 **If-Else** 检查 HTTP 状态。在 **Code** 节点输入 HTTP 响应正文，正文是字符串时先解析 JSON，再验证 `status`、`error` 和 `request_id`。小红书候选在 `data.data.items[].note`，公众号的标题、链接和摘要在 `data.articles[]`。把状态、请求号和候选清单接到 **Output**。成功的空数组保留为空，失败走单独的错误输出。需要时只把入选链接送到[正文读取](/zh/guides/read-wechat-article)或[小红书详情](/zh/guides/xiaohongshu-notes-research)。

两条来源各自检查响应，再把结果交给简报。需要在同一次运行里保留成功分支时，给两个 HTTP 节点各自设置错误处理：某个来源失败，就为失败的来源输出失败状态，另一个来源的候选照常进入简报。每条分支保留来源、输入、状态、候选和请求号，补跑时就知道该重用哪个关键词或账号。

## 一次调试应该拿到什么？

| 调试看到的结果             | 下一步                                                 |
| ------------------- | --------------------------------------------------- |
| 小红书找到一篇笔记《除垢后还有异味》  | 留下笔记 ID、返回的标题和请求号。先把这篇笔记当成选题线索；需要引用具体说法时，再读这篇笔记的详情。 |
| 公众号列表有一篇《咖啡机清洁步骤》   | 留下标题、文章链接、摘要和请求号。简报可以引用摘要明确提到的内容；要列出清洁步骤，先读取这篇正文。   |
| 小红书成功但结果为空，或公众号请求失败 | 前者在简报标为「这次查询无结果」。后者显示查询失败和请求号（有则保留），可单独补跑公众号。       |

接到 LLM 时，可以这样写提示词：「给出两个选题，每个选题附对应来源标识和需要补查的内容。若只拿到标题或摘要，标出材料类型；若素材只支持一个选题，就只给一个。」交稿前点开一条原文，核对简报里的对应说法。一个关键词首页加一个公众号首页是两次数据请求，每篇入选详情另算一次请求。

## 让 Agent 自己选工具时，用 MCP

在 Dify 的 **工具 → MCP → 添加 MCP 服务器**中填 `https://beatapi.io/mcp`，连接方式选 Streamable HTTP。连接设置支持自定义认证头时，通过受保护配置传 `Authorization: Bearer <BEATAPI_API_KEY>`。你的 Dify 版本只接受其他鉴权方式时，改用上面的 HTTP 路线。

1. 保存后确认能看到 `capabilities_search`、`capabilities_inspect` 和 `capabilities_run`，把三个工具接到 Agent，或按顺序作为工作流节点。
2. 搜索小红书关键词搜索能力或公众号文章目录能力。
3. 检查返回的 reference 和必填输入。
4. 对一个目标执行该能力。

在调试记录里，把查询参数、请求号、返回材料和最终输出一一对应。公众号目录里的摘要标记为摘要。价格见 [BeatAPI 价格页](https://beatapi.io/zh/pricing)。

[Dify HTTP Request](https://docs.dify.ai/en/cloud/use-dify/nodes/http-request) · [Dify 的 MCP 工具接入](https://dify.ai/blog/v1-6-0-built-in-two-way-mcp-support)