xiaohongshu-skills

小红书自动化 Skills，直接使用你已登录的浏览器和真实账号，以普通用户的方式操作小红书。

支持 OpenClaw 及所有兼容 SKILL.md 格式的 AI Agent 平台（如 Claude Code）。

⚠️ 使用建议：虽然本项目使用真实的用户浏览器和账号环境，但仍建议控制使用频率，避免短时间内大量操作。频繁的自动化行为可能触发小红书的风控机制，导致账号受限。

功能概览

技能	说明	核心能力
xhs-auth	认证管理	登录检查、扫码登录、手机验证码登录
xhs-publish	内容发布	图文 / 视频 / 长文发布、定时发布、分步预览
xhs-explore	内容发现	关键词搜索、笔记详情、用户主页、首页推荐
xhs-interact	社交互动	评论、回复、点赞、收藏
xhs-content-ops	复合运营	竞品分析、热点追踪、批量互动、内容创作

支持连贯操作 — 你可以用自然语言下达复合指令，Agent 会自动串联多个技能完成任务。例如：

"搜索刺客信条最火的图文帖子，收藏它，然后告诉我讲了什么"

Agent 会自动执行：搜索 → 筛选图文 → 按点赞排序 → 收藏 → 获取详情 → 总结内容。

安装

前置条件

• Python >= 3.11
• uv 包管理器
• Google Chrome 浏览器

第一步：安装项目

方法一：下载 ZIP（推荐）

1. 在 GitHub 仓库页面点击 Code → Download ZIP，下载并解压到你的 Agent skills 目录：

# OpenClaw 示例
<openclaw-project>/skills/xiaohongshu-skills/

# Claude Code 示例
<your-project>/.claude/skills/xiaohongshu-skills/

方法二：Git Clone

cd <your-agent-project>/skills/
git clone https://github.com/autoclaw-cc/xiaohongshu-skills.git

2. 安装 Python 依赖：

cd xiaohongshu-skills
uv sync

第二步：安装浏览器扩展

扩展让 AI 能够在你的浏览器中以你的身份操作小红书，使用的是你真实的登录状态和账号信息。

1. 打开 Chrome，地址栏输入 chrome://extensions/
2. 右上角开启开发者模式
3. 点击加载已解压的扩展程序，选择本项目的 extension/ 目录
4. 确认扩展 XHS Bridge 已启用

安装完成后即可使用 — 所有操作都发生在你自己的浏览器里，使用你的真实账号和浏览器环境。

使用方式

作为 AI Agent 技能使用（推荐）

安装到 skills 目录后，直接用自然语言与 Agent 对话即可。Agent 会根据你的意图自动路由到对应技能。

认证登录：

"登录小红书" / "检查登录状态"

搜索浏览：

"搜索关于露营的笔记" / "查看这条笔记的详情"

发布内容：

"帮我发一条图文笔记，标题是…，配图是…"

社交互动：

"给这条笔记点赞" / "收藏这条帖子" / "评论：写得太好了"

复合操作：

"搜索竞品账号最近的爆款笔记，分析他们的选题方向"

作为 CLI 工具使用

所有功能也可以通过命令行直接调用，输出 JSON 格式，便于脚本集成。

# 检查登录状态
python scripts/cli.py check-login

# 扫码登录
python scripts/cli.py login

# 搜索笔记
python scripts/cli.py search-feeds --keyword "关键词"

# 带筛选条件
python scripts/cli.py search-feeds \
  --keyword "关键词" \
  --sort-by "最多点赞" \
  --note-type "图文"

# 查看笔记详情
python scripts/cli.py get-feed-detail \
  --feed-id FEED_ID --xsec-token XSEC_TOKEN

# 图文发布（分步：填写 → 预览 → 确认）
python scripts/cli.py fill-publish \
  --title-file title.txt \
  --content-file content.txt \
  --images "/abs/path/pic1.jpg" "/abs/path/pic2.jpg"
python scripts/cli.py click-publish

# 一步发布图文
python scripts/cli.py publish \
  --title-file title.txt \
  --content-file content.txt \
  --images "/abs/path/pic1.jpg" \
  --tags "标签1" "标签2"

# 视频发布
python scripts/cli.py publish-video \
  --title-file title.txt \
  --content-file content.txt \
  --video "/abs/path/video.mp4"

# 点赞 / 收藏 / 评论
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_TOKEN
python scripts/cli.py post-comment --feed-id FEED_ID --xsec-token XSEC_TOKEN --content "评论内容"

第一次运行时，若 Chrome 未打开，CLI 会自动启动它。

CLI 命令参考

子命令	说明
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	一步发布视频
fill-publish	填写图文表单（不发布，供预览）
fill-publish-video	填写视频表单（不发布，供预览）
click-publish	确认发布（点击发布按钮）
save-draft	保存为草稿
long-article	长文模式：填写 + 一键排版
select-template	选择长文排版模板
next-step	长文下一步 + 填写描述

退出码：0 成功 · 1 未登录 · 2 错误

项目结构

xiaohongshu-skills/
├── extension/                      # Chrome 扩展
│   ├── manifest.json
│   ├── background.js
│   └── content.js
├── scripts/                        # Python 自动化引擎
│   ├── xhs/                        # 核心自动化包
│   │   ├── bridge.py               # 扩展通信客户端
│   │   ├── selectors.py            # CSS 选择器（集中管理）
│   │   ├── login.py                # 登录 + 用户信息获取
│   │   ├── feeds.py                # 首页 Feed
│   │   ├── search.py               # 搜索 + 筛选
│   │   ├── feed_detail.py          # 笔记详情 + 评论加载
│   │   ├── user_profile.py         # 用户主页
│   │   ├── comment.py              # 评论、回复
│   │   ├── like_favorite.py        # 点赞、收藏
│   │   ├── publish.py              # 图文发布
│   │   ├── publish_video.py        # 视频发布
│   │   ├── publish_long_article.py # 长文发布
│   │   ├── types.py                # 数据类型
│   │   ├── errors.py               # 异常体系
│   │   ├── urls.py                 # URL 常量
│   │   ├── cookies.py              # Cookie 持久化
│   │   └── human.py                # 行为模拟
│   ├── cli.py                      # 统一 CLI 入口
│   ├── bridge_server.py            # 本地通信服务
│   ├── image_downloader.py         # 媒体下载（SHA256 缓存）
│   ├── title_utils.py              # UTF-16 标题长度计算
│   └── run_lock.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
└── README.md

开发

uv sync                    # 安装依赖
uv run ruff check .        # Lint 检查
uv run ruff format .       # 代码格式化
uv run pytest              # 运行测试

License

MIT

Star History