xiaohongshu-skills
小红书自动化 Claude Code Skills，基于 Python CDP 浏览器自动化引擎。
为 OpenClaw 生态提供小红书操作能力，同时兼容 Claude Code Skills 格式。
功能概览
| 技能 | 说明 | 核心命令 |
|---|---|---|
| xhs-auth | 认证管理 |
check-login, login, delete-cookies
|
| xhs-publish | 内容发布 |
publish, publish-video
|
| xhs-explore | 内容发现 |
list-feeds, search-feeds, get-feed-detail, user-profile
|
| xhs-interact | 社交互动 |
post-comment, reply-comment, like-feed, favorite-feed
|
| xhs-content-ops | 复合运营 | 竞品分析、热点追踪、内容创作、互动管理 |
安装
# 克隆项目
git clone https://github.com/autoclaw-cc/xiaohongshu-skills.git
cd xiaohongshu-skills
# 安装依赖（需要 uv）
uv sync前置条件
- Python >= 3.11
- uv 包管理器
- Google Chrome 浏览器
快速开始
1. 启动 Chrome
# 有窗口模式（推荐首次登录）
python scripts/chrome_launcher.py
# 无头模式
python scripts/chrome_launcher.py --headless2. 登录小红书
# 检查登录状态
python scripts/cli.py check-login
# 登录（扫码）
python scripts/cli.py login3. 搜索笔记
python scripts/cli.py search-feeds --keyword "关键词"
# 带筛选
python scripts/cli.py search-feeds \
--keyword "关键词" --sort-by 最新 --note-type 图文4. 查看笔记详情
python scripts/cli.py get-feed-detail \
--feed-id FEED_ID --xsec-token XSEC_TOKEN5. 发布内容
# 图文发布
python scripts/cli.py publish \
--title-file title.txt \
--content-file content.txt \
--images "/abs/path/pic1.jpg" "/abs/path/pic2.jpg"
# 视频发布
python scripts/cli.py publish-video \
--title-file title.txt \
--content-file content.txt \
--video "/abs/path/video.mp4"6. 社交互动
# 发表评论
python scripts/cli.py post-comment \
--feed-id FEED_ID \
--xsec-token XSEC_TOKEN \
--content "评论内容"
# 点赞
python scripts/cli.py like-feed \
--feed-id FEED_ID --xsec-token XSEC_TOKEN
# 收藏
python scripts/cli.py favorite-feed \
--feed-id FEED_ID --xsec-token XSEC_TOKENCLI 命令参考
所有命令通过 scripts/cli.py 统一入口调用，输出 JSON 格式。
全局选项：
-
--host HOST— Chrome 调试主机（默认 127.0.0.1） -
--port PORT— Chrome 调试端口（默认 9222） -
--account NAME— 指定账号
| 子命令 | 说明 |
|---|---|
check-login |
检查登录状态 |
login |
获取登录二维码，等待扫码 |
delete-cookies |
清除 cookies |
list-feeds |
获取首页推荐 Feed |
search-feeds |
关键词搜索笔记 |
get-feed-detail |
获取笔记详情和评论 |
user-profile |
获取用户主页信息 |
post-comment |
对笔记发表评论 |
reply-comment |
回复指定评论 |
like-feed |
点赞 / 取消点赞 |
favorite-feed |
收藏 / 取消收藏 |
publish |
发布图文内容 |
publish-video |
发布视频内容 |
退出码：0=成功，1=未登录，2=错误
项目结构
xiaohongshu-skills/
├── scripts/ # Python CDP 自动化引擎
│ ├── xhs/ # 核心自动化包（模块化）
│ │ ├── cdp.py # CDP WebSocket 客户端
│ │ ├── stealth.py # 反检测保护
│ │ ├── cookies.py # Cookie 持久化
│ │ ├── types.py # 数据类型
│ │ ├── errors.py # 异常体系
│ │ ├── selectors.py # CSS 选择器
│ │ ├── urls.py # URL 常量
│ │ ├── human.py # 人类行为模拟
│ │ ├── login.py # 登录
│ │ ├── feeds.py # 首页 Feed
│ │ ├── search.py # 搜索
│ │ ├── feed_detail.py # 笔记详情
│ │ ├── user_profile.py # 用户主页
│ │ ├── comment.py # 评论
│ │ ├── like_favorite.py # 点赞/收藏
│ │ ├── publish.py # 图文发布
│ │ └── publish_video.py # 视频发布
│ ├── cli.py # 统一 CLI（13 个子命令）
│ ├── chrome_launcher.py # Chrome 进程管理
│ ├── account_manager.py # 多账号管理
│ ├── image_downloader.py # 媒体下载
│ ├── title_utils.py # 标题长度计算
│ ├── run_lock.py # 单实例锁
│ └── publish_pipeline.py # 发布编排器
├── skills/ # Claude Code Skills 定义
│ ├── xhs-auth/SKILL.md # 认证管理
│ ├── xhs-publish/SKILL.md # 内容发布
│ ├── xhs-explore/SKILL.md # 内容发现
│ ├── xhs-interact/SKILL.md # 社交互动
│ └── xhs-content-ops/SKILL.md # 复合运营
├── SKILL.md # 统一入口
├── CLAUDE.md # 项目开发指南
├── pyproject.toml # uv 项目配置
└── README.md技术架构
双层结构
-
scripts/ — Python CDP 引擎
- 基于 xiaohongshu-mcp Go 源码从零重写
- 通过 Chrome DevTools Protocol (CDP) 直接控制浏览器
- 数据提取使用
window.__INITIAL_STATE__模式 - 内置反检测保护（stealth flags + JS 注入）
- JSON 结构化输出
-
skills/ — Claude Code Skills 定义
- SKILL.md 格式，指导 AI agent 如何调用 scripts/
- 包含输入判断、约束规则、工作流程、失败处理
开发
uv sync # 安装依赖
uv run ruff check . # Lint 检查
uv run ruff format . # 代码格式化
uv run pytest # 运行测试