XiaohongshuSkills快速上手教程：10分钟完成第一次小红书自动发布（附登录流程与避坑）

XiaohongshuSkills快速上手教程：10分钟完成第一次小红书自动发布（附登录流程与避坑）

【免费下载链接】XiaohongshuSkills支持小红书自动发布、自动评论、自动检索的 Skill。支持 OpenClaw、Codex、CC 等项目地址: https://gitcode.com/gh_mirrors/xi/XiaohongshuSkills

XiaohongshuSkills 是一个支持小红书自动发布、自动评论、自动检索的开源 Skill 工具，基于 Chrome DevTools Protocol（CDP）实现自动化操作，支持图文发布、视频发布、多账号管理和无头模式运行，兼容 OpenClaw、Codex、Claude Code 等 AI 助手。本文将带你从零开始，在 10 分钟内完成第一次小红书自动发布，并附上完整的登录流程与常见避坑清单。

一、它能帮你做什么？

在动手之前，先看看这个小红书自动发布工具的核心能力：

⚠️风险提示：使用小红书自动化存在被平台风控、限流、封号的风险。建议先用测试号验证，控制发布频率，并对发布内容做人工复核。

二、环境准备：3 步装好依赖

环境要求：

• Python 3.10+
• Google Chrome 浏览器
• Windows 操作系统（目前仅测试 Windows）

第 1 步：获取项目

git clone https://gitcode.com/gh_mirrors/xi/XiaohongshuSkills cd XiaohongshuSkills

第 2 步：安装依赖

依赖非常轻量，只有 requirements.txt 中的requests和websockets两个库：

pip install -r requirements.txt

第 3 步：确认项目结构

项目核心逻辑都在 scripts/ 目录下，三个关键文件值得了解：

• scripts/publish_pipeline.py：统一发布入口，一条命令完成全流程
• scripts/cdp_publish.py：CDP 底层自动化控制、登录与账号命令
• scripts/chrome_launcher.py：Chrome 浏览器生命周期管理

更多细节可参考 docs/claude-code-integration.md 和根目录 SKILL.md。

三、第一次登录：扫码即可（约 2 分钟）

首次使用必须先登录小红书账号，只需一条命令：

python scripts/cdp_publish.py login

执行后会自动弹出一个 Chrome 窗口，用小红书 App 扫码登录即可。Cookie 会保存在本地独立的 Chrome Profile 中，之后无需重复登录（登录状态默认本地缓存 12 小时）。

如果不确定当前是否已登录，随时可以检查：

python scripts/cdp_publish.py check-login

💡 如果你的 Chrome 在另一台机器上，还可以用远程 CDP 模式登录：

python scripts/cdp_publish.py --host 10.0.0.12 --port 9222 login

四、发布第一篇笔记：一条命令搞定

登录完成后，我们就能发布第一篇图文笔记了。推荐先用预览模式（只填内容、不点发布）来熟悉流程：

python scripts/publish_pipeline.py --preview \ --title "我的第一篇自动发布笔记" \ --content "正文内容写在这里" \ --image-urls "https://example.com/image.jpg"

浏览器会打开创作者中心发布页，自动填好标题、正文和图片，然后停在那里等你人工确认，检查无误后手动点发布。

熟悉之后，加--headless参数即可切换为无头自动发布（自动点击发布按钮）：

python scripts/publish_pipeline.py --headless \ --title "我的第一篇自动发布笔记" \ --content "正文内容写在这里" \ --image-urls "https://example.com/image.jpg"

常用变体：

• 本地图片：把--image-urls换成--images "C:\path\to\image.jpg"
• 本地视频：用--video "C:\path\to\video.mp4"（图片与视频二选一，不可混用）
• 从文件读内容：用--title-file title.txt --content-file content.txt，适合长正文
• 话题标签：在正文最后一行写#标签1 #标签2（最多 10 个），会被自动识别为话题标签

五、多账号管理：一个命令切换账号

如果你有工作号和生活号，XiaohongshuSkills 支持多账号管理，各账号 Cookie 隔离、互不串号：

# 查看所有账号 python scripts/cdp_publish.py list-accounts # 添加新账号（可加别名） python scripts/cdp_publish.py add-account work --alias "工作号" # 登录指定账号 python scripts/cdp_publish.py --account work login # 用指定账号发布 python scripts/publish_pipeline.py --account work --headless \ --title "标题" --content "正文" --image-urls "https://example.com/1.jpg"

账号配置模板见 config/accounts.json.example，复制为config/accounts.json后按需修改即可。

六、进阶玩法：检索、评论与数据看板

完成第一次发布后，还可以解锁这些小红书自动化能力（均在 scripts/cdp_publish.py 中）：

# 搜索笔记（自动抓取下拉推荐词） python scripts/cdp_publish.py search-feeds --keyword "春招" --sort-by 最新 --note-type 图文 # 给指定笔记发表评论 python scripts/cdp_publish.py post-comment-to-feed \ --feed-id FEED_ID --xsec-token TOKEN --content "写得很实用！" # 点赞 / 收藏 python scripts/cdp_publish.py note-upvote --feed-id FEED_ID --xsec-token TOKEN python scripts/cdp_publish.py note-bookmark --feed-id FEED_ID --xsec-token TOKEN # 抓取创作者中心"笔记基础信息"数据表（曝光/观看/点赞等），可导出 CSV python scripts/cdp_publish.py content-data --csv-file "C:/abs/path/content_data.csv"

feed-id与xsec-token可直接从search-feeds的搜索结果中获取，无需手工查找。

七、避坑清单：新手最常踩的 6 个坑 🕳️

八、让 AI 助手帮你发布

XiaohongshuSkills 最大的亮点是它能作为Skill直接接入 Claude Code、OpenClaw、Codex 等 AI 工具：把项目复制到~/.claude/skills/post-to-xhs/目录，AI 助手就能理解 SKILL.md 中定义的工作流，用自然语言直接说"把这个链接发到小红书"即可完成提取、生成、确认、发布的全流程。详细步骤见 docs/claude-code-integration.md。

写在最后

回看整个流程：装依赖 → 扫码登录 → 一条命令发布，全程不到 10 分钟。之后无论是批量图文、视频发布，还是自动评论、数据抓取，都可以在 scripts/ 下找到对应命令；遇到页面改版问题，重点排查 scripts/cdp_publish.py 的选择器配置即可。

最后再提醒一次：自动化发布仅供学习研究使用，请遵守小红书平台规则，控制频率、人工复核，保护好你的账号安全。

【免费下载链接】XiaohongshuSkills支持小红书自动发布、自动评论、自动检索的 Skill。支持 OpenClaw、Codex、CC 等项目地址: https://gitcode.com/gh_mirrors/xi/XiaohongshuSkills