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

# 用 AI 搜索小红书笔记

> 先找到搜索能力、确认参数与价格，再获取一页笔记。本指南只完成一次搜索，不继续采集评论，也不导出全部搜索结果。

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

## 开始前

在 AI 客户端连接 [BeatAPI MCP](https://beatapi.io/mcp)，并准备 BeatAPI API key。Search 和 Inspect 调用免费，Run 调用会消耗余额。

## 把这段任务交给 AI

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

## 查找能力

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

```bash
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。

```bash
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 请求如下：

```bash
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 只看到几条结果，是只取到了几条吗？](/zh/faq/social-data-preview)。

## 费用与范围

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

[能力接口合同](/zh/capabilities) · [社媒数据合同](/zh/social-data)