小红书自动化发布与互动助手

这是什么

小红书自动化发布与互动助手是一个基于 Chrome DevTools 协议（CDP）的命令行工具，能够自动完成小红书（Xiaohongshu/RED）的内容发布、评论互动、数据抓取等操作。

它支持图文和视频发布、多账号管理、无头模式运行，并适配了 2026 年 2-3 月小红书创作者中心的页面改版。该项目由 white0dew 开发，采用 MIT 协议开源，在 GitHub 上已获得 3450 个 Star 和 343 个 Fork，社区关注度较高。

适合谁

这个工具特别适合以下人群：

内容创作者：需要频繁发布图文或视频笔记，希望自动化流程节省时间。
社交媒体运营：管理多个小红书账号，需要批量发布和互动。
数据分析爱好者：希望抓取小红书内容数据（如曝光、观看、点赞等）用于分析。
技术型用户：熟悉命令行操作，愿意通过脚本控制浏览器行为。

能做什么

该工具功能丰富，覆盖小红书运营的多个环节：

自动化发布：自动填写标题、正文，支持上传图片或视频，支持从 URL 下载图片并自动添加 Referer 绕过防盗链。
多账号管理：支持添加、切换、删除多个账号，各账号 Cookie 隔离，互不干扰。
内容检索与详情读取：支持搜索笔记、获取笔记详情（含评论数据），并可滚动加载更多评论。
评论互动：支持对指定笔记发表一级评论、回复指定评论（可按评论 ID、作者或文本片段定位）。
互动动作控制：支持点赞/取消点赞、收藏/取消收藏。
用户页信息提取：支持抓取用户主页快照与主页笔记列表。
通知评论抓取：支持在通知页面抓取提及（mentions）接口返回。
内容数据看板抓取：支持抓取“笔记基础信息”表（曝光/观看/点赞等）并导出 CSV。
无头模式与远程 CDP：支持后台运行，也可连接远程 Chrome 调试端口。

使用前准备

在开始使用之前，请确保满足以下条件：

Python 3.10 或更高版本
Google Chrome 浏览器（建议最新版）
Windows 操作系统（目前仅测试 Windows）
安装项目依赖：requests 和 websockets

安装方法

首先，将项目克隆到本地：

git clone https://github.com/white0dew/xiaohongshuskills.git
cd xiaohongshuskills

然后安装依赖：

pip install -r requirements.txt

如果要将此项目作为 Claude Code 或 Codex 的 Skill 使用，可以将项目复制到 .claude/skills/post-to-xhs/ 目录，并添加 SKILL.md 文件（详见项目文档）。

使用示例

首次登录

运行以下命令，在弹出的 Chrome 窗口中扫码登录小红书：

python scripts/cdp_publish.py login

发布图文笔记

python scripts/publish_pipeline.py --headless \
    --title "文章标题" \
    --content "文章正文" \
    --image-urls "https://example.com/image.jpg"

发布视频笔记

python scripts/publish_pipeline.py --headless \
    --title "视频标题" \
    --content "视频正文" \
    --video "C:\path\to\video.mp4"

搜索笔记

python scripts/cdp_publish.py search-feeds --keyword "春招"

发表评论

python scripts/cdp_publish.py post-comment-to-feed \
    --feed-id 67abc1234def567890123456 \
    --xsec-token YOUR_XSEC_TOKEN \
    --content "写得很实用，感谢分享！"

抓取内容数据

python scripts/cdp_publish.py content-data --csv-file "/abs/path/content_data.csv"

风险与注意事项

重要风险提示：使用本项目进行小红书自动化，存在被平台风控、限流、封号或封禁账号的风险。建议仅先在测试号上验证，控制发布频率和流量规模，并对最终发布内容进行人工复核。使用者需自行评估并承担由此带来的账号、内容、流量及其他相关风险。

此外，请注意以下几点：

仅供学习研究：请遵守小红书平台规则，不要用于违规内容发布。
登录安全：Cookie 存储在本地 Chrome Profile 中，请勿泄露。
选择器更新：如果小红书页面结构变化导致发布失败，需要更新 cdp_publish.py 中的选择器。
平台改版适配：当前发布链路已按 2026 年 2-3 月的小红书创作者中心改版调整过选择器与等待策略；如果后续再次改版，优先检查 scripts/cdp_publish.py 中的 SELECTORS、多图上传等待和发布按钮点击逻辑。
远程 CDP 注意：当 --host 非 127.0.0.1/localhost 时为远程模式，会跳过本地 chrome_launcher.py 的自动启动/重启逻辑，请确保远程 CDP 地址可达。

总之，这个工具功能强大，但使用时务必谨慎，遵守平台规则，避免账号风险。