xiaohongshu-skills

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

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

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

📰 作者也在运营一个 AI 资讯网站 — 欢迎关注。

功能概览

技能	说明	核心能力
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 命令参考