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

# 小红书博主笔记怎样整理成 Excel 目录？

> 用 xiaohongshu.app_v2.get_user_posted_notes 逐页读取小红书博主的笔记，一条笔记填一行表格，交付时写明已保存页数、覆盖范围和停止原因。

要把小红书博主的笔记整理成 Excel 目录，用 `xiaohongshu.app_v2.get_user_posted_notes` 逐页读取博主主页的笔记，一条笔记填一行，只给选中的笔记补详情。做好的表格列出每条笔记的链接、已保存的页和每条笔记的入选理由。下面的步骤用一个例子说明：回顾一位美食博主上一季发过哪些菜谱。

## 从主页取得第一页

传入博主已确认的 `user_id`，或把博主完整的主页分享链接作为 `share_text` 传入。下面的示例用主页分享链接。请求发往 `POST https://api.beatapi.io/v1/social-data/call`，使用 BeatAPI Bearer 鉴权，把 `<confirmed_profile_share_link>` 换成目标博主的真实分享链接。

```json
{
  "action": "xiaohongshu.app_v2.get_user_posted_notes",
  "params": {"share_text": "<confirmed_profile_share_link>", "cursor": ""}
}
```

1. 确认第一批笔记属于目标博主。
2. 保存请求、原响应、采集时间和请求号。
3. 取下一页时，把实际返回的游标作为 `cursor` 传入，博主和其他输入保持不变。输入文档给出的续页游标示例路径是 `data.data.notes[-1].cursor`。
4. 遇到空页、游标重复、报错或到达自己设定的范围上限时停止，并记录是哪一种停止原因。

## 按实际返回填入工作表

先把笔记ID列设为文本格式，再一条笔记填一行。下面是工作表的列：每个值按返回原样保留，缺项写「待核」。

| 列          | 如何使用                 |
| ---------- | -------------------- |
| 博主与笔记标识    | 用确认的笔记ID核对重复，保留原件位置  |
| 标题、可读文字和链接 | 筛主题，单独记录这是卡片内容还是已读详情 |
| 实际发布时间     | 筛研究季度，时间不明的单列        |
| 互动原值与观察时间  | 需要比较表现时，按同一字段和可比范围比较 |
| 选读理由       | 例如“包含完整备料思路，值得读详情”   |

把原响应和表格放在一起保存。要交付 CSV 时，用表格软件导出 UTF-8 编码的 CSV。`xiaohongshu.app_v2.get_user_posted_notes` 的公开输入文档没有定义全部列表字段，所以先核对自己拿到的响应，再把字段对应到列。要给选中的笔记补正文，按[笔记标识与详情流程](/zh/faq/xiaohongshu-share-links)处理。

回顾第三季度时，加一列筛选，取值为「季度内」「日期待核」「季度外」。同一条笔记出现在两页时，只保留一行，并记下两个来源页。导出后抽查一行：笔记ID 仍是完整字符串，并且能在保存的原响应里找到对应笔记。

交付说明里写明实际保存的页数、可识别的笔记数、目标季度和停止原因。列表翻到底时，写明已取完本次列表返回的全部页。调用次数按列表页数加上选中笔记的详情请求来规划，现价见[价格页](https://beatapi.io/zh/pricing)。