跳到导航

用 AI 搜索小红书笔记

通过 BeatAPI 搜索小红书笔记分三步:用免费的 Search 调用找到搜索能力,用免费的 Inspect 调用确认 data:xiaohongshu.app_v2.search_notes 的输入和价格,再用付费的 Run 调用获取一页笔记。本指南只完成一次搜索;采集评论和导出全部结果是另外的任务。

开始前

在 AI 客户端连接 BeatAPI MCP,并准备 BeatAPI API key。Search 和 Inspect 调用免费,Run 调用会消耗余额。

把这段任务交给 AI

搜索小红书上关于露营咖啡的笔记。先查找能力,再确认必填参数、就绪状态和价格,执行前告诉我价格。得到我批准后,只取一页,展示少量预览,有来源链接时一并保留。不要获取评论、继续翻页,或未经询问重试付费执行。

查找能力

使用 HTTP 客户端时,先发送免费的 Search 请求:

curl -sS https://api.beatapi.io/v1/capabilities/search \
-H "Content-Type: application/json" \
-d '{"query":"小红书 搜索笔记"}'

把 Search 响应里的 reference 值原样填进 Inspect 请求。下面的 Inspect 请求使用 data:xiaohongshu.app_v2.search_notes;如果 Search 返回了不同的 reference,使用返回的 reference。

curl -sS https://api.beatapi.io/v1/capabilities/inspect \
-H "Content-Type: application/json" \
-d '{"reference":"data:xiaohongshu.app_v2.search_notes"}'

扣费前确认

Inspect 响应给出输入结构、价格、就绪状态和下一步调用。只有就绪状态为 ready 或 runnable 时才继续;状态为 listed 的能力不能执行。把 next 调用里的每个占位符替换成自己的输入。

获取一页笔记

确认 Inspect 给出的价格后,带上 API key 发送 Inspect 响应里的 Run 调用。使用 data:xiaohongshu.app_v2.search_notes 时,Run 请求如下:

curl -sS https://api.beatapi.io/v1/capabilities/run \
-H "Authorization: Bearer $BEATAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"reference":"data:xiaohongshu.app_v2.search_notes","input":{"keyword":"露营咖啡"},"view":"preview","max_items":5}'

上面的 Run 请求是示例,不是实测返回。以实际响应里的字段为准:runnable 的能力不保证固定的输出结构。

读取结果

preview 视图中的条数可能少于原始响应。预览条数少不等于平台翻页。参见 AI 只看到几条结果,是只取到了几条吗?。

费用与范围

本指南只用 Run 发起一次付费搜索;Search 和 Inspect 免费。当前价格以 Inspect 响应为准,指南里不写固定金额。一页搜索结果不保证包含全部匹配笔记,搜索排名也不保证稳定。

能力接口合同 · 社媒数据合同