XHS_ALL_IN_ONE

小红书一站式智能运营平台 — 采集、分析、AI 创作、自动发布，全链路闭环

市面上的小红书工具要么只能爬数据，要么只能发笔记，要么需要手动复制粘贴到 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 一键改写正文、润色标题、生成标签，拖拽排序图片素材，编辑完成直接送入发布中心。

素材优化 — AI 图片润色

选择草稿中的任意图片，添加参考图，输入润色指令，AI 生成优化后的图片并原位替换。当前素材和优化结果并排对比，点击即可放大预览。

发布中心 — 一键发布到小红书

预览草稿内容和图片素材，选择 Creator 账号，设置可见性和发布模式（立即/定时），发布校验通过后一键发布到小红书创作者平台。

自动运营 — 全自动内容生产管线

设置关键词和调度频率（每日/每周/自定义间隔），系统自动执行完整管线：搜索热门笔记 → AI 改写标题+正文 → 上传图片素材 → 通过 Creator API 自动发布。真正的无人值守。

⭐ 完整功能清单

底层 SDK（逆向签名算法，透明封装）

模块	功能	状态
小红书 PC 端	二维码登录 / 手机验证码登录	✅
	搜索笔记 & 搜索用户	✅
	获取笔记详情（无水印图片 & 视频）	✅
	获取笔记评论	✅
	获取用户发布 / 喜欢 / 收藏的笔记	✅
	获取用户主页信息 / 自己的账号信息	✅
	获取主页推荐 / 未读消息	✅
创作者平台	二维码登录 / 手机验证码登录	✅
	上传图集 / 视频作品	✅
	查看已发布作品列表	✅
蒲公英平台	KOL 博主列表 & 粉丝画像 & 合作邀请	✅
千帆平台	分销商列表 & 合作品类 / 商品信息	✅

Web 运营平台

模块	功能
账号矩阵	多 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 的能力接入，可直接作为底层能力仓库使用，也可通过标准化 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 部署

docker compose up -d

📁 项目结构

XHS_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，也欢迎关注作者其他项目

📈 Star History

🍔 交流群

如果你对爬虫和 AI Agent 感兴趣，可以加入群聊一起讨论~

ps: 请加群，人满或者过期 issue | wx 提醒 | qq提醒

group-1	group-2	group-3	group-4 (2000人qq群)

License

MIT License - see LICENSE for details.