Xiaohongshu Browser / 小红书浏览器
用 Playwright 自动化浏览小红书，搜索关键词并截图帖子弹窗预览。
Automate Xiaohongshu browsing — search keywords and screenshot post modal previews.
前置要求 / Prerequisites
Python 3.x + Playwright：
pip install playwright
playwright install chromium
使用步骤
第一步：首次登录（只需要做一次）
- 运行登录脚本，会弹出浏览器窗口：
python <skill_dir>/scripts/xhs_open.py
-
在弹出的浏览器里手动登录小红书（扫码或账号密码都行）
-
登录成功后，创建一个控制文件来保存登录状态：
# Windows (PowerShell):
Set-Content "$env:USERPROFILE\.openclaw\.close_browser" "CLOSE"
# Windows (CMD):
echo CLOSE > %USERPROFILE%\.openclaw\.close_browser
# Linux / macOS:
echo CLOSE > ~/.openclaw/.close_browser
- 看到终端输出
AUTH_SAVED就说明登录状态保存好了
💡 登录状态保存在
~/.openclaw/xhs_data，以后搜索时会自动使用，不需要重复登录。
第二步：搜索并截图
python <skill_dir>/scripts/xhs_search.py "关键词" 数量
参数说明：
- 第一个参数：搜索关键词（默认：
御姐） - 第二个参数：截图几个帖子（默认：
5）
示例：
# 搜索"美食"，截图前3个帖子
python <skill_dir>/scripts/xhs_search.py "美食" 3
# 搜索"穿搭"，截图前10个
python <skill_dir>/scripts/xhs_search.py "穿搭" 10
# 不传参数，用默认值
python <skill_dir>/scripts/xhs_search.py
输出结果
截图保存在 <skill_dir>/output/ 目录，文件名格式：post_序号_时间戳.png
每张截图包含帖子弹窗预览（图文详情）。
常见问题
需要重新登录？
小红书的登录会过期，如果搜索时遇到登录弹窗，需要重新登录：
# 1. 删除旧的登录数据
# Windows:
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw\xhs_data"
# Linux / macOS:
rm -rf ~/.openclaw/xhs_data
# 2. 重新运行登录脚本
python <skill_dir>/scripts/xhs_open.py
搜索没结果？
- 小红书可能会限制频繁访问，等几分钟再试
- 关键词不要太长，2-6个字最佳
- 不要带
#号，直接搜关键词
目录结构
xiaohongshu-browser/
├── SKILL.md # 本说明文件
├── scripts/
│ ├── xhs_open.py # 登录脚本（首次使用）
│ └── xhs_search.py # 搜索+截图脚本
└── output/ # 截图输出目录
注意事项
- 使用无头浏览器（headless），不会弹出窗口
- 操作间有随机延迟，降低被检测风险
- 频繁使用可能触发小红书的反爬机制
- 帖子链接需要
xsec_token才能直接访问（搜索结果中已包含）