RedBookSkills

在小红书（Xiaohongshu/RED）运营中，重复性的发帖、素材整理和数据统计往往占据了大量时间。RedBookSkills 是一款专为小红书打造的命令行自动化工具。它基于 Chrome DevTools Protocol (CDP) 实现深层浏览器自动化，不仅支持一键发布图文笔记，还涵盖了多账号管理、素材自动下载、内容检索、评论互动及数据看板导出等全链路功能。

无论是个人创作者希望提高效率，还是团队需要管理矩阵账号，RedBookSkills 都能通过脚本化操作，将繁琐的运营工作转化为高效的自动化流程。

核心功能亮点

1. 智能自动化发布

• 全流程自动：自动填写标题、正文，上传图片（支持本地路径或 URL）。
• 话题标签识别：智能识别正文最后一行的 #标签，自动逐个写入话题栏，无需手动操作。
• 灵活模式：
  • 无头模式 (Headless)：后台静默运行，无需显示浏览器窗口，适合服务器部署。
  • 预览模式：仅填充内容不点击发布，方便人工二次确认。

2. 强大的多账号管理

• Cookie 隔离：支持管理多个小红书账号，每个账号拥有独立的 Chrome Profile，彻底避免账号关联风险。
• 便捷切换：提供 add-account、switch-account、set-default-account 等命令，轻松在不同账号间切换。
• 登录状态缓存：自动检测登录状态，未登录时唤起窗口扫码；已登录状态本地缓存 12 小时，减少重复校验。

3. 内容生态交互与数据抓取

• 素材与竞品分析：支持搜索笔记、获取笔记详情（含评论数据），自动下载图片并绕过防盗链（自动添加 Referer）。
• 互动自动化：支持按 feed_id + xsec_token 对指定笔记发表一级评论；抓取“评论和@”通知接口数据。
• 数据看板导出：自动抓取创作者中心的“笔记基础信息”表（曝光、观看、点赞等），并支持导出为 CSV 格式，便于后续数据分析。

4. 高级部署与集成

• 远程 CDP 支持：可通过 --host / --port 连接远程 Chrome 调试端口，实现跨机器控制（如本地控制服务器浏览器）。
• AI 技能集成：可作为 Claude Code、OpenCode 等 AI 编程助手的 Skill 工具，只需简单配置即可让 AI 代理自动执行发布任务。

快速开始指南

环境准备

• 系统：Windows（目前主要测试环境）
• 依赖：Python 3.10+, Google Chrome 浏览器
• 安装：

  pip install -r requirements.txt
  

第一步：登录与账号管理

首次使用需扫码登录，工具会自动保存 Cookie。

# 启动登录流程（弹出 Chrome 窗口扫码）
python scripts/cdp_publish.py login

# 查看当前登录状态
python scripts/cdp_publish.py check-login

# 添加新账号（例如命名为 myaccount）
python scripts/cdp_publish.py add-account myaccount --alias "我的主号"

# 切换到指定账号
python scripts/cdp_publish.py --account myaccount login

第二步：发布笔记

支持从命令行参数或文件读取内容，支持本地图片和网络图片。

场景 A：无头模式自动发布（推荐）

python scripts/publish_pipeline.py --headless \
    --title "春招求职指南" \
    --content "这里是正文内容... #春招 #求职 #校招" \
    --image-urls "https://example.com/image.jpg"

注：正文最后一行若为 #标签 格式，工具会自动提取并填入话题栏。

场景 B：使用本地图片与文件内容

python scripts/publish_pipeline.py --headless \
    --title-file title.txt \
    --content-file content.txt \
    --images "C:\Users\Images\cover.jpg"

场景 C：预览模式（仅填充，不发布）

python scripts/publish_pipeline.py --preview \
    --title "测试标题" \
    --content "测试正文" \
    --images "image.jpg"

第三步：数据抓取与互动

# 搜索笔记
python scripts/cdp_publish.py search-feeds --keyword "春招" --sort-by 最新

# 获取笔记详情（需 feed_id 和 xsec_token）
python scripts/cdp_publish.py get-feed-detail --feed-id 67abc... --xsec-token YOUR_TOKEN

# 发表评论
python scripts/cdp_publish.py post-comment-to-feed \
    --feed-id 67abc... \
    --xsec-token YOUR_TOKEN \
    --content "写得很实用，感谢分享！"

# 导出数据看板为 CSV
python scripts/cdp_publish.py content-data --csv-file "./data/report.csv"

第四步：浏览器管理

# 启动测试浏览器（有窗口）
python scripts/chrome_launcher.py

# 无头启动
python scripts/chrome_launcher.py --headless

# 关闭浏览器
python scripts/chrome_launcher.py --kill

高级特性说明

• 远程操控：若 Chrome 运行在另一台机器（IP: 10.0.0.12, Port: 9222），所有命令均可添加 --host 10.0.0.12 --port 9222 参数进行远程控制。
• WSL/UNC 路径支持：在 WSL 环境下操作 Windows 文件时，可使用 --skip-file-check 跳过 Linux 侧的文件存在性校验，直接传递 UNC 路径（如 \\wsl.localhost\Ubuntu\...）。
• Claude Code 集成：将项目复制到 .claude/skills/post-to-xhs/ 目录并配置 SKILL.md 后，可直接通过自然语言指令让 Claude 帮你发帖、查数据。

注意事项与合规提醒

1. 合规使用：本工具仅供学习和研究使用。请务必遵守小红书平台社区规范，严禁用于发布违规内容、刷量、恶意营销等行为，以免导致账号被封禁。
2. 账号安全：Cookie 存储在本地 Chrome Profile 中，请妥善保管，切勿泄露给他人。
3. 维护更新：小红书前端页面结构可能会不定期更新，若发现发布失败，可能需要更新 cdp_publish.py 中的元素选择器。
4. 图片类型：工具默认处理 WB_DFT（默认高清图），列表预览图通常为 WB_PRV。