【小题XT】小红书评论采集
给一条或多条小红书笔记链接，帮你收集评论正文和接口返回的楼中楼回复，保留“谁回复谁”的关系，整理成可筛选、可核对的评论表。
能帮你做什么
| 你的需求 | 这个 Skill 会做什么 |
|---|---|
| 想把一篇笔记的评论区整理下来 | 分页读取评论，导出正文、评论者、点赞数和发布时间 |
| 不只看一级评论，还想看评论下面的讨论 | 整理接口实际返回的楼中楼回复，关联所属一级评论及已知的回复对象 |
| 想收集多篇笔记下面的用户反馈 | 按笔记分别采集、去重后汇总，每条评论都保留来源笔记 |
| 想优先看最新评论或高赞评论 | 使用接口提供的最新、默认或点赞最多排序 |
| 上次没采完，希望继续 | 依据已保存的来源、游标和去重记录续采，并说明未完成的部分 |
楼中楼采集说明： 支持采集笔记评论及可获取的楼中楼回复，并保留回复关系。楼中楼的采集范围取决于所连接数据服务的支持情况；未完整获取时，会明确标注已采集数量和未完成原因，不将部分结果标记为全量。
你需要提供什么
最少提供 一条小红书笔记链接。也可以一次粘贴多条链接，或直接粘贴带链接的分享文案，不需要按固定格式填写。
| 你可以指定的条件 | 未指定时怎么处理 |
|---|---|
| 笔记链接 | 必须提供；只处理你指定的笔记 |
| 采集数量 | 默认每篇最多100条一级评论，同时保留这些评论已返回的楼中楼；采集前告知此口径 |
| 楼中楼回复 | 默认包含；也可以明确说“只要一级评论” |
| 排序方式 | 默认使用平台默认排序；可选最新或点赞最多 |
| 评论时间、点赞门槛、包含词等 | 默认不限；有要求时依据返回字段筛选，不擅自放宽 |
| 文件格式 | 默认 CSV 和 JSON；需要 Excel 文件时可以要求 XLSX |
“采集100条”未说明口径时，会先确认是100条一级评论，还是含回复共100条。已明确数量、范围或筛选条件时不会重复询问。要求尽量采全时，会分页采集可访问的数据，遇到接口或页数限制时交付已取得的部分并说明后续可否继续。
能拿到哪些数据
| 数据 | 说明 |
|---|---|
| 评论正文、评论者昵称及 ID | 保留原文、高亮标记及实际返回的媒体链接；可附小红书号、头像 |
| 评论点赞数、发布时间、热度分 | time 为秒级时间戳；热度分可能为负，缺失就留空 |
| 作者回复标记、IP 属地 | 从标签和 ip_location 读取；只记录接口原值 |
| 一级评论／楼中楼标记 | 区分主评论与回复；无法确认时保留未知 |
| 所属一级评论、回复对象 | 根据 sub_comments 和 target_comment 还原已知关系，不根据昵称猜测 |
| 笔记链接、笔记 ID、标题 | 标题需另调笔记详情工具；评论接口不返回笔记正文、标题或笔记赞藏指标 |
| 采集时间、采集状态、未完成原因 | 分别说明一级评论和楼中楼的采集情况 |
最后交付什么
- 评论明细表：一条评论或回复一行，默认 CSV，可用 Excel 打开；一级评论与楼中楼通过 ID 关联。
- JSON 数据：保留实际返回的评论字段、来源和回复关系，便于核查与后续处理；剔除认证信息。
- 采集结果说明：逐篇报告一级评论数、楼中楼回复数、总记录数，以及未采全、无法判断或失败的原因。
- 续采记录：保存已读取的分页位置及处理状态；达到本次范围或接口中断时可接着处理。
页面显示的评论总数与本次采集记录数会分开呈现，不把“评论数”当成已经获得的评论正文条数。评论会变化，结果反映本次采集时接口可返回的内容。
可以直接这样用
> 采集这篇小红书笔记的评论，包括楼中楼，整理成评论表。
> [粘贴笔记链接]
> 这几篇笔记每篇采100条一级评论，带上接口返回的楼中楼，按最新排序，导出 Excel。
> [粘贴多条笔记链接]
> 尽量采全这篇笔记的评论和楼中楼，保留回复关系。采不全的部分单独说明。
> [粘贴笔记链接]
使用前需要准备
当前 Agent 必须配置并能实际使用小题 ai-tool-center MCP，配置方法见下方。直接提供笔记链接、导出本地文件，无需安装飞书或钉钉 CLI。
本 Skill 聚焦评论正文与回复关系。按关键词找笔记用 xt-xhs-keyword-links；回收作品点赞、收藏等指标用 xt-work-data-collector。评论接口只提供原始字段，不返回情感、热词统计或地域聚合等分析；本 Skill 不默认进行这些分析、回复评论或写入在线表格。
以下为 Agent 执行规则。上面的内容用于介绍能力，不改变执行顺序：第一步始终检查小题 MCP，未通过时不访问笔记链接、不采集评论。 制作或修改本 Skill 属于文件编辑，不触发业务采集，也不索要测试链接。
小题 XT MCP 强制前置闸门
本节优先于正文中任何旧版配置、手动兜底或“选择是否使用 MCP”的说明。加载本 Skill 后，第一步只检查当前 Agent 是否实际配置并可用名为 ai-tool-center 的 MCP；以当前 Agent 的 MCP 服务器列表、已注册工具列表或可用连接状态为准。已检测到且可用时直接继续，不重复询问配置、不索取 API Key；未检测到、无法确认或连接失败时，只发送配置提醒并停止，不得先读取外部链接、调用平台数据、生成/分析媒体或使用其他能力绕过闸门。
用户只说“已配置”、只提供 URL/API Key，或配置后尚未重启验证，均不算可用。用户明确不配置时，只有在其再次明确授权无 MCP 继续后，才可执行不依赖 MCP 的部分，并标记受影响能力，不得伪称 MCP 调用成功。
MCP 配置提醒
未检测到可用 MCP 时，提示用户到 xt.gbotai.cn 申请 API Key，在当前 Agent 的 MCP 设置中新增以下配置，完全退出并重启 Agent，确认工具列表出现 ai-tool-center 后再回复“已配置 MCP”；真实 Key 不得写入 Skill、日志或交付物。
{
"mcpServers": {
"ai-tool-center": {
"url": "https://middle-aitool.gbotai.cn/mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>"
}
}
}
}
MCP 错误提醒
调用 ai-tool-center 时按返回错误或状态分流，不要反复重试或猜测原因：
- 如果返回 Key 无效、未授权、认证失败或类似错误，提醒用户到 xt.gbotai.cn 重新申请 Key，更新配置并重启 Agent 后再重试。
- 如果返回钱包余额不足、额度不足或类似计费错误，提醒用户到 xt.gbotai.cn 进行充值，确认余额恢复后再重试。
- 错误处理完成前，将对应能力标记为“待确认/不可用”，不得声称任务成功，也不要索取或展示真实 Key、钱包或支付信息。
Agent 执行入口
- 检查 MCP 与工具：严格执行强制闸门。通过后核对下表工具的实际注册 Schema；缺少必需工具时报告具体能力不可用。
- 明确来源与范围：从用户输入提取笔记链接，保留完整链接中的访问参数。没有链接才询问；默认范围直接告知后执行。数量口径有歧义时先澄清。按用户需求处理时间、点赞与关键词条件。
- 识别笔记、分页取评论：读取 MCP 调用与分页规则，通过详情取得真实 noteId，再调用评论工具。默认每篇最多100条一级评论、20次评论分页调用；用户指定数量时调整目标，20页仍作为一轮上限。若因上限未达目标，明确交付为部分结果并询问是否继续，不称完成。
- 整理楼中楼与筛选：读取 回复关系与结果字段。遍历返回中实际存在的回复集合，去重并保留关系。楼中楼需独立判断完整性；未返回的内容不得补写或猜测。
- 导出并验收：交付 CSV、JSON 和逐篇状态；核对数量、关系及来源。只有实际生成且能读取的文件才能报告已导出。采集和筛选数量分开报告，未满足条件的记录不得凑数。
实际调用的工具
| 用途 | ai-tool-center 中的工具 | 关键参数 |
|---|---|---|
| 从笔记链接读取详情、取得 noteId | mcp__ai_tool_center__fetch_content_detail |
request.link、request.plant="xhs"、request.include_comments=false |
| 分页读取笔记评论 | mcp__ai_tool_center__get_xhs_note_comments |
request.noteId、request.sort；下一页使用 request.lastCursor |
| 整理楼中楼 | 提取 sub_comments，保留 target_comment、数量和子评论游标 |
sub_comment_cursor 是返回字段；当前无已注册的独立展开工具，不传入一级评论的 lastCursor |
具体参数、停止条件与能力变化处理见调用规则。工具名称和参数以当前 Agent 注册的 Schema 为准；不得用浏览器、HTTP 脚本或其他爬虫绕过 MCP。
