【小题XT】小红书博主主页笔记采集

给我一个小红书博主主页链接，帮你逐页采集公开笔记，整理标题、类型、点赞数、发布时间、封面图和笔记直链，导出可用 Excel 打开的 CSV 清单。

能帮你做什么

默认采集全部可访问笔记，不限定发布时间、类型和点赞数。你已经说“全部”时不再反复询问采集几篇；指定篇数或筛选条件时按要求执行。

你需要提供什么

最少提供一个小红书博主主页链接。 可以直接粘贴分享文字，也可以一次给出多个主页。尽量保留完整链接及查询参数，不需要提供账号密码或 Cookie。

可选补充：最近多少天、指定日期范围、图文／视频、点赞门槛、最多多少篇、排序方式，以及需要对比的历史 CSV。没有额外要求时，直接按默认范围开始。

只有昵称时需要确认具体账号；单篇笔记链接不能当作主页链接使用。“UP主”未明确平台时先确认是否指小红书，不采集其他平台的账号。

最后交付什么

• 笔记清单 CSV：标题、图文／视频类型、点赞数、发布时间、封面图 URL、笔记直链，并附博主、笔记 ID、采集时间及字段状态。
• 采集摘要：成功账号、实际去重条数、筛选后条数、时间覆盖、缺失字段和是否翻页完成。
• 异常与续采信息：中断时保存进度及续采位置，交付已取得的有效部分。
• 按需分析：内容类型分布、发布节奏、点赞分布或与历史清单的变化；只基于实际数据推断。

封面图以链接交付，CSV 不内嵌图片。默认按发布时间降序排列，时间未知的排在末尾；可按要求改为点赞排序或保留采集顺序。

能力说明

“全部”指本次接口可访问范围内的完整分页结果。 只有收到明确结束信号且中间无未解决的缺页，才标记“分页完成”。私密、删除、受限或接口未返回的笔记不在保证范围内；首屏返回、空页或条数碰巧相等都不能单独证明采全。

字段按实际返回整理。 主页结果缺少发布时间等必要字段时，按需补采已取得笔记的详情；仍无法取得则留空并标注原因，不从笔记 ID 推算发布时间、不把缺失点赞写成0。

直链保留每篇笔记自己的访问参数。 有实际笔记链接时优先保留原链接；有笔记 ID 和对应 token 时才构造直链，不把主页 token 套到所有笔记上。token 缺失、链接失效或尚未验证时如实标记，不承诺永久可访问。

内容观察不等于商业转化评估。 公开点赞不能替代曝光、成交或报价数据，不据此保证达人投放效果。账号监测默认是本次采集或历史对比，不自动创建定时任务，也不自动联系达人。

可以直接这样用

> 把这个小红书博主主页能采集到的全部笔记导出 CSV，要标题、类型、点赞、发布时间、封面和带 token 的笔记链接。
> [粘贴主页链接]

> 采集这个达人最近90天的笔记，只保留点赞大于1000的图文，按点赞数排序。

> 帮我盘点这3个小红书博主的全部笔记，合并到一个 CSV，保留博主名称，方便选号。

> 这是上次的笔记清单和博主主页，重新采集一次，列出新增笔记和点赞变化。

使用前需要准备

当前 Agent 需要配置并能实际使用小题 ai-tool-center MCP。不会配置时，Agent 会按下方流程协助处理；真实 Key 只在安全入口填写。

CSV 导出脚本使用 Python 3 标准库。执行前检查环境；没有 Python 时可用当前可用的文件工具按相同格式导出，不要求安装其他采集器。需要写入飞书或钉钉时，另行检查对应 CLI 的安装、登录、目标表格权限与字段映射；CSV 导出本身不依赖这些 CLI。

以下为 Agent 执行规则。能力介绍不改变顺序：业务执行第一步始终检查小题 MCP，未通过时不读取主页或开始采集。

小题 XT MCP 强制前置闸门

本节优先于正文中任何旧版配置、手动兜底或“选择是否使用 MCP”的说明。加载本 Skill 后，第一步只检查当前 Agent 是否实际配置并可用名为 ai-tool-center 的 MCP；以当前 Agent 的 MCP 服务器列表、已注册工具列表或可用连接状态为准。已检测到且可用时直接继续，不重复询问配置、不索取 API Key；未检测到、无法确认或连接失败时，只发送配置提醒并停止，不得先读取外部链接、调用平台数据、生成/分析媒体或使用其他能力绕过闸门。

用户只说“已配置”、只提供 URL/API Key，或配置后尚未重启验证，均不算可用。用户明确不配置时，只有在其再次明确授权无 MCP 继续后，才可执行不依赖 MCP 的部分，并标记受影响能力，不得伪称 MCP 调用成功。

MCP 配置提醒

未检测到可用 MCP 时，向用户发送：

> 当前未检测到可用的 ai-tool-center MCP。请到 xt.gbotai.cn 申请 API Key，并把 MCP 配置发给我，我会帮助你完成配置。发送前请把真实 API Key 替换成 <YOUR_API_KEY>，真实 Key 稍后在安全配置入口填写。

不要在首次提醒中直接堆出手动配置教程。用户不懂“配置”或没有配置模板时，Agent 提供以下模板，并协助完成后续步骤，不要求用户自己写 JSON：

{
  "mcpServers": {
    "ai-tool-center": {
      "url": "https://middle-aitool.gbotai.cn/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

Agent 协助配置流程

用户请求协助或发来配置后，只开展配置工作；笔记采集与外部资料处理仍须等待闸门通过。

1. 识别使用环境：优先依据当前环境确认 Agent／客户端及其支持的配置入口；无法确认时只问用户正在用哪个应用。不猜配置文件路径，不照搬其他客户端的 JSON 格式。
2. 准备配置：检查用户提供的脱敏配置，或使用上述模板。按当前客户端的实际配置规范调整；保留其他服务器与已有设置，不覆盖整份配置。
3. 协助完成：有可用配置工具、设置界面操作能力或明确可编辑的配置文件且已获用户配置授权时，在允许范围内完成操作。真实 Key 通过客户端安全输入框、密钥存储或其支持的安全方式填写，不索取聊天明文 Key、不把 Key 回显到命令或日志。没有安全输入方式时，让用户只完成 Key 填写这一步，不擅自代填。
4. 能力不足时逐步引导：无法直接操作设置时，说明当前能协助到哪一步，根据用户使用的客户端一次给一个明确操作。避免笼统要求“自行配置”，也不声称已自动完成。
5. 重启与复检：配置保存后，提示用户完全退出并重启 Agent。重新检查已注册工具或连接状态；只有实际可用才继续原任务。“已配置”回复、配置文件已写入、Key 已填写都不等于连接验证成功。

真实 Key 不得写入 Skill、对话回复、日志或交付物。配置过程如有失败，说明具体失败步骤并保留其他设置；未复检通过前保持业务能力“待确认／不可用”。

MCP 错误提醒

调用 ai-tool-center 时按返回错误或状态分流，不要反复重试或猜测原因：

• 如果返回 Key 无效、未授权、认证失败或类似错误，提醒用户到 xt.gbotai.cn 重新申请 Key，更新配置并重启 Agent 后再重试。
• 如果返回钱包余额不足、额度不足或类似计费错误，提醒用户到 xt.gbotai.cn 进行充值，确认余额恢复后再重试。
• 错误处理完成前，将对应能力标记为“待确认/不可用”，不得声称任务成功，也不要索取或展示真实 Key、钱包或支付信息。

具体调用工具与执行顺序

以下均通过小题 ai-tool-center MCP 调用，不使用浏览器或脚本代替平台采集。

parse_xhs_user_summary 虽然名称含 summary，其当前参数说明明确实际查询用户笔记列表。不要因为名称而改用关键词搜索。完整主页直接交给主页工具；fetch_content_detail 仅用于上述分享短链兼容解析或单篇详情，不用它代替主页分页。

分享短链先调用 mcp__ai_tool_center__fetch_content_detail：

{
  "request": {
    "plant": "xhs",
    "link": "<用户提供的分享短链>",
    "auto_cookie": true,
    "include_comments": false
  }
}

主页短链返回的 data.post_id 可能实际承载用户 ID，data.user_xsec_token 不能据字段名直接当每篇笔记 token。按照 短链识别规则 验证账号后再采列表；只有确认是笔记 ID 和该篇 token 时，才拼 /explore/{note_id}?xsec_token=...。

首屏调用参数：

{
  "request": {
    "url": "<真实的 https://www.xiaohongshu.com/user/profile/... 完整主页链接>",
    "timeout": 30
  }
}

下一页调用参数：

{
  "request": {
    "url": "<同一完整主页链接>",
    "lastCursor": "<上一页非空 data.next_cursor，否则 data.items[-1].cursor>",
    "platform": "<本账号已确认的同一数据源：tikhub、tiktok 或 justone>",
    "timeout": 30
  }
}

上述占位内容仅说明结构，游标必须使用真实返回值。列表从 data.items 读取，先判断 data.has_more：为 false 时结束，不因末条仍有 cursor 而继续；为 true 时按上述优先级取续页游标。数据源可沿用本账号前页已确认值，或用户／服务配置明确确认的值，不要求每页都返回 platform。两处游标都缺失或数据源仍不明确时才停止并标部分完成；不以笔记 ID 替代缺失 cursor。成功、结束信号、字段映射和异常处理见 工具与分页规则。

Agent 执行入口

1. 检查 MCP：通过闸门后检查 parse_xhs_user_summary；短链解析或详情补齐时还须有 fetch_content_detail。
2. 确定账号与范围：提取主页链接并保留原参数，分享短链先通过真实可用的 MCP 转为完整主页链接；默认全部、时间不限、互动不限。只问缺失的主页或含糊条件，不重新确认已有指令。
3. 分页采集与记录断点：严格按 工具与分页规则 传递游标及数据源，保存每页结果、去重标识、覆盖状态和异常。
4. 整理与补齐字段：按 字段与导出规则 建立实际响应到标准字段的映射。需要带 token 直链时，无 token 的笔记须调用 fetch_content_detail 尝试补取，再检查返回 URL 或对应 token 字段；接口200不等于补取成功。按结果继续或报告受限，逐篇标注状态。
5. 筛选、排序与导出：采集覆盖和字段完整性分别计数。用 CSV 导出脚本 导出标准化结果；也可按同一格式使用可用文件工具。
6. 检查交付：核对行数、去重、中文、链接参数和缺失字段；报告真实覆盖状态，提供文件链接，不只贴前几条冒充完整清单。

任务范围

不把关键词搜索结果当作某博主完整笔记列表，不用账号验证配置工具采集内容，不绕过 MCP 抓网页。没有授权不自动写外部表格、创建定时任务、发送私信或建联。用户明确要求写表时先验证 CLI、权限和目标结构，在其授权范围内写入并回读核验。