小红书配置指南

功能说明

读取和搜索小红书笔记。通过 xhs-cli（⭐1.5K，pipx 一行安装）实现。

前置条件

Python 3.10+（pipx 安装）
浏览器已登录 xiaohongshu.com（用于导出 Cookie）

Agent 可自动完成的步骤

1. 安装 xhs-cli

pipx install xiaohongshu-cli

xhs login

这会自动从浏览器提取 Cookie。如果自动提取失败，可以手动导入（见下方）。

3. 验证

agent-reach doctor

应该看到小红书显示为 ✅。

需要用户手动做的步骤

如果 xhs login 自动提取失败，需要手动导入 cookies：

推荐方式：Cookie-Editor 浏览器导出（最可靠）

在 Chrome 中安装 Cookie-Editor 扩展

浏览器登录 xiaohongshu.com

点击 Cookie-Editor 图标 → Export → Header String

把导出的字符串发给 Agent，运行：agent-reach configure xhs-cookies "导出的cookie字符串"

注意：不要依赖 QR 扫码登录，Cookie-Editor 导出方式最简单可靠。这个方式也适合 WSL、SSH、容器等无法直接读取桌面浏览器 Cookie 的环境。

agent-reach configure xhs-cookies 会把 Cookie 同步到 ~/.xiaohongshu-cli/cookies.json，供 xhs status/search/read 直接使用；如果你还在用旧的 xiaohongshu-mcp Docker 方案，也会保留兼容导入文件。

使用示例

搜索笔记：

xhs search "关键词"

阅读笔记详情：

xhs read NOTE_ID

查看评论：

xhs comments NOTE_ID

常见问题

Q: Cookie 过期了？ A: 重新运行 xhs login 或通过 Cookie-Editor 重新导出。

Q: 小红书提示 IP 风险？ A: 推荐使用住宅代理：export HTTP_PROXY="http://user:pass@ip:port"。

Q: xhs-cli 不支持我的系统？ A: 确保 Python 3.10+ 和 pipx 已安装。运行 pipx install xiaohongshu-cli 即可。

Q: WSL 里 xhs login 读不到 Windows 浏览器怎么办？ A: 这是常见限制。WSL 里没有直接可读的 Linux 浏览器 Cookie 时，xhs login 自动提取会失败。推荐在 Windows 浏览器用 Cookie-Editor 导出 xiaohongshu.com 的 Header String，然后在 WSL 里运行 agent-reach configure xhs-cookies "..."，再用 xhs status 验证。

备选方案：Docker MCP

如果你已经在使用 xiaohongshu-mcp Docker 方案，它也能正常工作：

docker run -d \
  --name xiaohongshu-mcp \
  -p 18060:18060 \
  xpzouying/xiaohongshu-mcp

mcporter config add xiaohongshu http://localhost:18060/mcp

xhs-cli 是当前推荐方案，不需要 Docker，安装更简单。

2.8 KiB Raw Blame History Unescape Escape