市面上的小红书工具要么只能爬数据，要么只能发笔记，要么需要手动复制粘贴到 AI 平台再贴回来。 XHS_ALL_IN_ONE 是第一个把「采集 → 内容库 → AI 改写 → 图片润色 → 一键发布 → 定时自动运营」全链路打通的开源平台。 一个浏览器标签页，完成别人用 5 个工具才能做的事。
| 传统方案 | XHS_ALL_IN_ONE | |
|---|---|---|
| 数据采集 | 写脚本 / 用第三方爬虫 | 平台内搜索 + 一键入库，素材自动下载到本地 |
| 内容管理 | Excel / 文件夹 / 各种笔记软件 | 统一内容库，标签筛选，卡片预览 |
| AI 改写 | 复制到 ChatGPT → 手动粘贴回来 | 编辑器内一键改写，标题/正文/标签全覆盖 |
| 图片处理 | Photoshop / 在线工具 | AI 图片润色 + 参考图，原位替换 |
| 发布 | 手动打开创作者平台上传 | 选账号 → 点发布，支持定时 |
| 自动化 | 没有 / 需要写代码 | 配置关键词 + 频率，全自动：搜索→改写→发布 |
| 多账号 | 反复切换浏览器 | 账号矩阵统一管理，2h 自动健康巡检 |
支持绑定多个 PC / Creator 账号，扫码登录、手机验证码、Cookie 导入三种方式。Cookie 加密存储，2 小时自动健康巡检，过期自动通知。
输入关键词一键搜索小红书全站笔记，支持排序、类型、时间等多维筛选。点击笔记卡片打开详情抽屉，查看无水印原图、互动数据、评论区，一键保存到内容库。
所有采集到的笔记统一沉淀在内容库，属于平台用户而非某个 XHS 账号。卡片/列表双视图，支持自定义标签、关键词搜索、批量操作、JSON/CSV 导出。
三栏布局：草稿队列 + 编辑器 + AI 助手。从内容库深拷贝笔记进入草稿，AI 一键改写正文、润色标题、生成标签，拖拽排序图片素材，编辑完成直接送入发布中心。
选择草稿中的任意图片，添加参考图，输入润色指令，AI 生成优化后的图片并原位替换。当前素材和优化结果并排对比，点击即可放大预览。
预览草稿内容和图片素材，选择 Creator 账号，设置可见性和发布模式（立即/定时），发布校验通过后一键发布到小红书创作者平台。
设置关键词和调度频率（每日/每周/自定义间隔），系统自动执行完整管线：搜索热门笔记 → AI 改写标题+正文 → 上传图片素材 → 通过 Creator API 自动发布。真正的无人值守。
| 模块 | 功能 | 状态 |
|---|---|---|
| 小红书 PC 端 | 二维码登录 / 手机验证码登录 | ✅ |
| 搜索笔记 & 搜索用户 | ✅ | |
| 获取笔记详情（无水印图片 & 视频） | ✅ | |
| 获取笔记评论 | ✅ | |
| 获取用户发布 / 喜欢 / 收藏的笔记 | ✅ | |
| 获取用户主页信息 / 自己的账号信息 | ✅ | |
| 获取主页推荐 / 未读消息 | ✅ | |
| 创作者平台 | 二维码登录 / 手机验证码登录 | ✅ |
| 上传图集 / 视频作品 | ✅ | |
| 查看已发布作品列表 | ✅ | |
| 蒲公英平台 | KOL 博主列表 & 粉丝画像 & 合作邀请 | ✅ |
| 千帆平台 | 分销商列表 & 合作品类 / 商品信息 | ✅ |
| 模块 | 功能 |
|---|---|
| 账号矩阵 | 多 PC / Creator 账号绑定、Cookie 加密存储、2h 自动健康巡检、过期通知 |
| 笔记发现 | 关键词搜索、URL 直查、多维筛选、已保存标记、一键入库 |
| 数据抓取 | 批量 URL / 搜索 / 评论抓取、Excel 导出、素材本地下载 |
| 内容库 | 卡片/列表双视图、自定义标签、批量操作、JSON/CSV 导出、查看原文 |
| 草稿工坊 | 三栏编辑器、AI 改写正文、润色标题/标签、拖拽排序素材、AI 图片润色 |
| 图片工坊 | AI 图片生成（支持参考图）、图片描述、AI/普通图片资产管理 |
| 发布中心 | 图集发布、定时发布、发布校验、状态追踪、重试/取消 |
| 自动运营 | 定时任务（每日/每周/自定义间隔）、全自动管线：搜索→AI改写→上传→发布 |
| 数据洞察 | 仪表盘总览、互动趋势、Top 内容、热门话题、评论分析 |
| 竞品监控 | 关键词/账号/品牌/URL 监控、自动爬取刷新、快照历史 |
| 任务中心 | 全量任务审计、调度器状态、耗时追踪 |
| 通知系统 | Cookie 过期 / 任务失败自动通知、铃铛实时展示 |
| 模型配置 | 支持任意 OpenAI 兼容 API（火山引擎、阿里云百炼、OpenAI 中转等） |
| 平台 | 状态 |
|---|---|
| 小红书 (XHS) | ✅ 已实现 |
| 抖音 (Douyin) | Coming Soon |
| 快手 (Kuaishou) | Coming Soon |
| 微博 (Weibo) | Coming Soon |
| 闲鱼 (Xianyu) | Coming Soon |
| 淘宝 (Taobao) | Coming Soon |
当前项目已支持基于 skills 的能力接入，可直接作为底层能力仓库使用，也可通过标准化 skills 方式被上层 Agent 工具链引入。
封装好的 skills 请查看 XhsSkills，可被 Clawbot、Claude Code、Codex 等工具直接引入与集成。
- Python 3.10+
- Node.js 20+
git clone https://github.com/cv-cat/XHS_ALL_IN_ONE.git
cd XHS_ALL_IN_ONE
pip install -r requirements.txt
npm install
cd frontend && npm install && cd ..# 一键启动（后端 + 前端）
python main.py --with-frontend启动后访问：
- 前端: http://localhost:5173
- API 文档: http://localhost:8000/docs
首次启动自动创建数据库，注册账号即可使用。
docker compose up -dXHS_ALL_IN_ONE/
├── main.py # 统一启动入口
├── config/ # YAML 配置（default / production）
├── apis/ # XHS 底层 SDK（逆向签名 + HTTP 接口）
├── xhs_utils/ # 签名算法封装
├── static/ # 签名核心 JS 文件
├── backend/
│ └── app/
│ ├── main.py # FastAPI 应用
│ ├── core/ # 配置、数据库、安全、时区
│ ├── models/ # SQLAlchemy 数据模型（20+ 张表）
│ ├── api/ # API 路由
│ ├── services/ # 业务逻辑 + 定时调度
│ ├── adapters/xhs/ # XHS SDK 适配层
│ └── storage/ # 媒体文件 + 导出文件
├── frontend/
│ └── src/
│ ├── pages/platforms/xhs/ # 各功能页面
│ ├── components/layout/ # 侧边栏 + 通知系统
│ ├── lib/api.ts # HTTP 客户端
│ └── types/ # TypeScript 类型
├── tests/ # 后端测试（126 passed）
├── Dockerfile # 多阶段构建
└── docker-compose.yml # 编排文件
分层配置，优先级：config/default.yaml < CONFIG_FILE < .env < 环境变量
database:
type: "sqlite" # sqlite 或 mysql
security:
secret_key: "change-me" # JWT 签名密钥
scheduler:
enabled: false # 启用定时任务（自动运营/监控/Cookie巡检）主要环境变量：SECRET_KEY、DATABASE_TYPE、DATABASE_URL、SCHEDULER_ENABLED
apis/是底层 SDK 层，请勿直接修改，上层通过backend/app/adapters/中转调用- Cookie 有时效性，平台内置 2 小时自动健康巡检 + 过期通知
- 所有敏感数据（Cookie、API Key）使用 Fernet 加密存储
- AI 功能需在「模型配置」页面配置 OpenAI 兼容的 API 端点（支持火山引擎、阿里云百炼等）
- 感谢 Star ⭐ 和 Follow，项目会持续更新
- 作者联系方式在主页，有问题随时联系
- 欢迎 PR 和 Issue，也欢迎关注作者其他项目
如果你对爬虫和 AI Agent 感兴趣，请加作者主页 wx 通过邀请加入群聊
ps: 请加群4、17、18，人满或者过期 issue | wx 提醒
| group14 | group17 | group18 |
|---|---|---|
 |
 |
 |
MIT License - see LICENSE for details.