Pnant
91 lines
2.8 KiB
Markdown
91 lines
2.8 KiB
Markdown
# 小红书配置指南
|
||
|
||
## 功能说明
|
||
读取和搜索小红书笔记。通过 [xhs-cli](https://github.com/jackwener/xiaohongshu-cli)（⭐1.5K，pipx 一行安装）实现。
|
||
|
||
## 前置条件
|
||
- Python 3.10+（pipx 安装）
|
||
- 浏览器已登录 xiaohongshu.com（用于导出 Cookie）
|
||
|
||
## Agent 可自动完成的步骤
|
||
|
||
### 1. 安装 xhs-cli
|
||
```bash
|
||
pipx install xiaohongshu-cli
|
||
```
|
||
|
||
### 2. 登录（从浏览器提取 Cookie）
|
||
```bash
|
||
xhs login
|
||
```
|
||
|
||
> 这会自动从浏览器提取 Cookie。如果自动提取失败，可以手动导入（见下方）。
|
||
|
||
### 3. 验证
|
||
```bash
|
||
agent-reach doctor
|
||
```
|
||
|
||
应该看到小红书显示为 ✅。
|
||
|
||
## 需要用户手动做的步骤
|
||
|
||
如果 `xhs login` 自动提取失败，需要手动导入 cookies：
|
||
|
||
> **推荐方式：Cookie-Editor 浏览器导出（最可靠）**
|
||
>
|
||
> 1. 在 Chrome 中安装 [Cookie-Editor](https://chromewebstore.google.com/detail/cookie-editor/hlkenndednhfkekhgcdicdfddnkalmdm) 扩展
|
||
> 2. 浏览器登录 xiaohongshu.com
|
||
> 3. 点击 Cookie-Editor 图标 → Export → Header String
|
||
> 4. 把导出的字符串发给 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 方案，也会保留兼容导入文件。
|
||
|
||
## 使用示例
|
||
|
||
搜索笔记：
|
||
```bash
|
||
xhs search "关键词"
|
||
```
|
||
|
||
阅读笔记详情：
|
||
```bash
|
||
xhs read NOTE_ID
|
||
```
|
||
|
||
查看评论：
|
||
```bash
|
||
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](https://github.com/xpzouying/xiaohongshu-mcp) Docker 方案，它也能正常工作：
|
||
|
||
```bash
|
||
docker run -d \
|
||
--name xiaohongshu-mcp \
|
||
-p 18060:18060 \
|
||
xpzouying/xiaohongshu-mcp
|
||
|
||
mcporter config add xiaohongshu http://localhost:18060/mcp
|
||
```
|
||
|
||
xhs-cli 是当前推荐方案，不需要 Docker，安装更简单。
|