小红书评论回复工具

支持两种模式，AI 智能生成评论回复，人工审核后发送到小红书。

适用场景

• - 手动回复小红书评论
• AI 辅助生成回复内容
• 需要人工审核后发送
• 批量管理多篇笔记的评论（Notion）

与 xhs-publish 的区别

• - xhs-publish — 发布小红书笔记（图文/视频）
• xhs-auto-reply — 回复小红书评论

一、选择数据源

提供两种数据源模式：

• - 单篇笔记 — 输入一个小红书笔记链接，快速回复单篇笔记的评论
• Notion 批量 — 从 Notion 数据库获取多个笔记链接，批量管理多篇笔记的评论

1.1 单篇笔记模式

输入：小红书笔记链接

CODEBLOCK0

流程：

输入链接 → MCP 获取评论 → AI 生成回复 → 人工审核 → 发送到小红书

1.2 Notion 批量模式

输入：Notion 数据库配置（API Token + Database ID）

流程：

连接 Notion → 获取笔记链接列表 → 遍历每个笔记获取评论 → 汇总所有评论 → AI 批量生成回复 → 人工审核 → 批量发送 → 更新 Notion 状态

Notion 数据库结构要求：

• - 笔记地址（URL，必填）— 小红书笔记链接
• 笔记标题（文本，可选）— 方便识别，可手动填写
• 状态（选择，可选）— 待处理/已完成

二、前置检查

2.1 检查 MCP 服务

两种模式都需要检查 MCP 服务是否运行：

CODEBLOCK1

检查结果：

1. 1. 有 Mcp-Session-Id 响应 → MCP 正常，继续流程
2. 无响应 → MCP 未启动，进入「六、安装 MCP 服务」
3. 返回"未登录" → 进入「七、获取登录二维码」

2.2 检查 Notion 配置

仅 Notion 批量模式需要检查：

CODEBLOCK2

检查结果：

1. 1. 200 — 正常，继续流程
2. 401 — Token 无效或被撤销，进入「八、Notion 配置」重新获取
3. 403 — 无数据库权限，提示添加 Integration 连接
4. 404 — 数据库 ID 无效，检查 database_id
5. 500/502/503 — Notion 服务异常，等待后重试
6. 超时 — 网络问题，检查网络连接

401 错误提示：

⚠️ Notion API 错误（401）：Token 无效或已被撤销
请按以下步骤重新配置：

1. 1. 访问 https://www.notion.so/my-integrations
2. 找到对应的 Integration，复制新的 Token
3. 重新运行脚本，输入新的 Token

403 错误提示：

⚠️ Notion API 错误（403）：无权限访问数据库
请按以下步骤添加权限：

1. 1. 打开 Notion 数据库
2. 点击右上角「...」→「Add connections」
3. 选择你的 Integration

三、获取评论

3.1 单篇笔记模式

运行交互式脚本：

CODEBLOCK3

脚本执行流程：

1. 1. 检测 AI 模型配置
2. 连接 MCP 服务
3. 检查登录状态
4. 提示输入笔记链接
5. 获取评论列表（一级评论、子评论、楼中楼）
6. 筛选待回复评论（排除已回复的）
7. 展示评论列表供选择

3.2 Notion 批量模式

步骤 1：获取笔记链接列表

从 Notion 数据库查询所有包含「笔记地址」的记录。

步骤 2：遍历笔记获取评论

对每个笔记链接：

1. 1. 解析笔记 ID
2. 调用 MCP get_feed_detail 获取评论
3. 筛选待回复评论
4. 汇总到总列表

步骤 3：展示汇总结果

📋 从 Notion 获取到 M 篇笔记，共 N 条待回复评论：

1. 1. 笔记A - @用户1：评论内容...
2. 笔记A - @用户2：评论内容...
3. 笔记B - @用户3：评论内容...

请选择要回复的评论：

• - 输入序号（如 1,2,3）
• 或输入 INLINECODE3

四、生成回复

4.1 AI 批量生成

脚本自动调用 AI 生成回复：

1. 1. 读取模型配置 — 优先使用当前对话模型，详见「九、模型配置」
2. 读取人设配置 — INLINECODE4
3. 读取回复规则 — reply_rules.json（安全铁律、回复模板）
4. 批量生成 — 对每条评论调用 AI API

4.2 人工审核（必需）

展示回复预览，必须人工审核：

📋 回复预览：

1. 1. 笔记A - @用户1 - 评论：... → 回复：...🐾
2. 笔记B - @用户2 - 评论：... → 回复：...🐾

请审核：

1. 1. 确认发送 — 发送到小红书
2. 修改 — 调整某条回复
3. 仅复制 — 不发送，复制回复内容
4. 取消 — 不发送

选择"修改"：

请输入序号和新回复（如：1 这是新的回复内容🐾）：

修改后重新展示预览，再次确认。

五、发送回复

5.1 发送到小红书

通过 MCP reply_comment_in_feed 发送：

CODEBLOCK4

5.2 更新 Notion 状态

仅 Notion 批量模式需要。

更新逻辑：每条评论发送成功后，立即更新该笔记对应 Notion 记录的状态为「已完成」。

CODEBLOCK5

注意：Notion 状态更新是「尽力而为」的，即使更新失败也不影响回复已发送到小红书。

5.3 发送结果

全部成功：

✅ 已发送 N 条回复

部分失败：

⚠️ 发送结果：

• - 成功：N 条
• 失败：M 条

失败原因及处理：

• - 未登录 → 获取登录二维码
• 评论已删除 → 自动跳过
• 网络超时 → 询问是否重试

六、安装 MCP 服务

当前置检查发现 MCP 未运行时执行。

6.1 安装依赖

Ubuntu/Debian：

CODEBLOCK6

CentOS/RHEL：

CODEBLOCK7

6.2 启动虚拟显示

CODEBLOCK8

6.3 下载并启动 MCP

CODEBLOCK9

6.4 验证安装

CODEBLOCK10

返回 Mcp-Session-Id 表示安装成功。

七、获取登录二维码

当 MCP 返回"未登录"时执行。

7.1 获取二维码

CODEBLOCK11

7.2 展示给用户

📱 请用小红书 App 扫码登录：
[二维码图片]

八、Notion 配置

8.1 创建 Integration

1. 1. 访问 https://www.notion.so/my-integrations
2. 点击「New integration」
3. 填写名称（如：小红书评论助手）
4. 复制「Internal Integration Token」（以 secret_ 开头）

8.2 创建数据库

新建 Notion 数据库，添加字段：

• - 笔记地址（URL）— 小红书笔记链接（必填）
• 笔记标题（文本）— 方便识别（可选）
• 状态（选择）— 待处理/已完成

8.3 添加数据库权限

1. 1. 打开数据库页面
2. 点击右上角「...」→「Add connections」
3. 选择刚创建的 Integration

8.4 获取 Database ID

数据库 URL 格式：

CODEBLOCK12

INLINECODE9 是 ? 前面那段 32 位字符（含连字符）。

8.5 保存配置

配置保存在 {baseDir}/.notion_config.json：

CODEBLOCK13

九、模型配置

9.1 自动检测顺序

1. 1. 当前对话模型 — OpenClaw 传递的模型配置
2. 已保存配置 — INLINECODE12
3. 交互式配置 — 脚本提示选择

9.2 支持的模型

1. 1. GLM-4-Flash — 环境变量：INLINECODE13
2. GLM-5 — 环境变量：INLINECODE14
3. Doubao Pro — 环境变量：INLINECODE15
4. GPT-4o Mini — 环境变量：INLINECODE16
5. DeepSeek Chat — 环境变量：INLINECODE17
6. 自定义 — 手动输入

9.3 首次配置流程

CODEBLOCK14

十、故障排查

10.1 MCP 连接失败

CODEBLOCK15

10.2 AI 生成失败

CODEBLOCK16

10.3 Notion API 失败

错误码处理：

1. 1. 401 — 重新获取 Token，更新 INLINECODE18
2. 403 — 在 Notion 中添加 Integration 连接
3. 404 — 检查 URL 中的 database_id
4. 500+ — 等待 1-2 分钟后重试

更新配置文件：

CODEBLOCK17

10.4 回复发送失败

• - 未登录 — 重新扫码登录
• 评论已删除 — 自动跳过
• 网络超时 — 重试

配置文件

文件列表：

• - identity.json — 人设配置（身份、性格、语气）
• INLINECODE20 — 回复规则（安全铁律、回复模板）
• INLINECODE21 — AI 模型配置
• INLINECODE22 — Notion API 配置（Notion 批量模式需要）

identity.json 示例：

CODEBLOCK18

reply_rules.json 示例：

CODEBLOCK19

前置条件

单篇笔记模式：

• - ✅ 小红书 MCP 服务
• ✅ 已登录小红书账号
• ✅ AI 模型配置

Notion 批量模式：

• - ✅ 小红书 MCP 服务
• ✅ 已登录小红书账号
• ✅ AI 模型配置
• ✅ Notion API Token
• ✅ Notion 数据库（含「笔记地址」字段）