抖音快手小红书采集监控

项目介绍

本地运行的多平台内容管理面板，支持 抖音 / 小红书 / 快手 / 视频号。

平台能力

功能	抖音	小红书	快手	视频号
登录	扫码 / 创作者 / Cookie	扫码	扫码 / 创作者	扫码
作品监控	✅	✅ 创作者 / 关键词	✅	仅本账号
评论监控	✅	✅	✅	仅本账号
短视频弹幕监控	✅ 播放页 / 创作中心	—	—	—
内容下载	✅ 可选画质	✅ 图集 / 视频	✅	—
发布	✅	✅	✅	✅
自动评论 / 回复	✅	✅	✅	—
本账号管理	作品 / 关注 / 粉丝 / 私信	作品 / 关注 / 粉丝 / 私信	作品 / 关注 / 粉丝	作品 / 数据 / 评论
通知	Bark / 钉钉 / Telegram	Bark / 钉钉 / Telegram	Bark / 钉钉 / Telegram	Bark / 钉钉 / Telegram

视频号只支持创作者助手中的本账号数据，不支持监控或下载他人作品。

快速开始

环境要求

• Python 3.10+
• 桌面环境（扫码登录时需要弹出浏览器）
• Google Chrome 稳定版（可选，但小红书扫码登录建议安装）
• Node.js 18+（仅小红书发布需要）
• 系统 ffmpeg（可选；未安装时自动使用 Python 依赖附带的 ffmpeg）

一键启动

克隆项目：

git clone https://github.com/3441293738/creatorhub.git
cd creatorhub

Windows：

.\start.cmd

macOS / Linux：

chmod +x start.sh
./start.sh

首次运行会自动创建虚拟环境、安装依赖和 Chromium、生成 config.yaml，随后打开：

http://127.0.0.1:8000

小红书登录建议： 尽量使用本机系统中已安装的稳定版 Google Chrome。CreatorHub 会优先调用系统 Chrome，并为每个账号使用独立的持久化 Profile，不会复用个人 Chrome 的默认 Profile；未安装 Chrome 时会自动回退到 Playwright Chromium，功能仍可使用，但更容易遇到平台设备安全验证。

常用命令：

.\start.cmd install        # 重新安装或更新依赖
.\start.cmd check          # 环境自检
.\start.cmd --no-open      # 启动后不自动打开页面
.\start.cmd --port 8080    # 使用其他端口
.\start.cmd --reload       # 开发模式

macOS / Linux 将 .\start.cmd 换成 ./start.sh。

手动安装

python -m venv .venv

# Windows
.venv\Scripts\activate

# macOS / Linux
source .venv/bin/activate

python -m pip install -r requirements.txt
python -m playwright install chromium

# 复制 config.example.yaml 为 config.yaml 后启动
python selftest.py
python -m uvicorn app.main:app --host 0.0.0.0 --port 8000

使用小红书发布功能时，还需安装 Node.js 依赖：

npm install

界面预览

截图使用脱敏示例数据；界面配色会跟随当前平台切换。

更多界面

账号与代理

基本使用

1. 添加账号

1. 在顶部选择平台。
2. 打开左侧「账号」。
3. 选择扫码、创作者登录或 Cookie 登录。
4. 登录完成后，可在账号列表中刷新资料、检测状态或重新登录。

小红书扫码登录只获取主站读取态；需要发布时，请再使用独立的「创作者登录」入口。添加笔记或创作者监控时，建议使用包含 xsec_token 的完整链接。

2. 监控与下载

• 作品监控：添加创作者主页、作品链接、短链或平台 ID，发现新作品后自动入库。
• 评论监控：可订阅单条作品，也可监控账号近期作品的评论。
• 短视频弹幕监控：独立于评论区，按视频内时间轴渐进探测并排序；支持时间范围、关键词、文本长度、点赞数和容量上限过滤，记录持久化到 SQLite；自己的视频走创作中心，公开视频走播放器拦截。
• 链接下载：粘贴完整分享文案或链接，自动提取地址并下载。
• 历史内容：新增目标默认只监控订阅后的作品，也可选择回填最近若干条。

下载支持断点续传和失败重试；抖音可选画质，小红书支持图集和视频。

3. 发布与转发

• 小红书支持图集、视频和定时发布。
• 抖音、快手和视频号通过对应创作平台发布。
• 已下载的抖音作品可转发到小红书或视频号，小红书作品可转发到抖音；发布前可修改标题、正文和话题。

4. 本账号与通知

• 「本账号」中可同步自己的作品、关注、粉丝和私信，具体能力因平台而异。
• 可启用作品健康监控，对零播放、违规或下架状态发送提醒。
• 通知渠道支持 Bark、钉钉和 Telegram。

自动评论、回复、私信及关注操作受平台风控影响，建议低频使用。

配置

首次启动会从 config.example.yaml 生成 config.yaml。大部分常用选项也可以在 Web 面板的「设置」中修改。

engine:
  scan_interval_seconds: 300         # 默认轮询间隔
  monitor_initial_backfill_count: 0  # 0=只监控新作品，-1=尽可能回填
  worker_pool_size: 2                # 下载并发数
  scan_concurrency: 2                # 抓取并发数
  account_check_interval_seconds: 1800
  media_dir: ./data/media
  work_health_enabled: false

storage:
  db_path: ./data/creatorhub.db

proxies: []
  # - http://user:pass@host:port
  # - socks5://user:pass@host:port

完整配置及说明见 config.example.yaml。

• config.yaml、数据库、登录态和媒体文件默认不会提交到 Git。
• 每个账号使用独立浏览器配置目录；如使用代理，建议为账号绑定稳定的独立代理。
• 数据库字段会在启动时自动迁移，升级后通常无需删除旧数据库。

分享链接命令行下载

只解析链接，不访问网络：

python -m app.engine.share_downloader --links-only "完整分享文案或链接"

下载内容：

python -m app.engine.share_downloader "完整分享文案或链接" -o ./data/media/share -q 1080

在 Web 面板中也可以直接使用「链接下载」。

统一平台风控

默认启用 risk_control.mode: conservative。它不会删除或关闭现有的登录、监控、下载、发布、评论、关注、取关和私信功能，而是把平台操作统一送入持久化闸门：

• 同一账号的评论、账号动作、私信和发布共享写操作间隔与额度，立即执行也不会绕过冷却。
• 使用同一网络出口的账号串行访问；未配置代理的账号统一归入 direct 出口组。
• conservative 模式中的写间隔、小时/每日额度和同出口并发是不可放宽的保护线；配置 0 表示沿用保护线，而不是取消限制。切换为 custom 后才完全按自定义值执行。
• 轻读取与重读取分别计时，评论区、弹幕、作品健康等重读取默认至少间隔 60 秒。
• 命中 403/429/461/471、验证码或明确风控提示后，依次冷却 30 分钟、2 小时、6 小时和 24 小时。
• 冷却结束后只放行间隔式轻量探测；连续 3 次成功才降低一级风险状态。
• 被额度、时段、代理状态或冷却拦下的任务仍保持 pending，服务重启也会恢复中断的执行态。
• 登录态失效时任务保留并等待重新登录；同一代理连续两次连接失败后会将账号和代理池条目标记为不可用。
• 存量账号继续使用 legacy 浏览器画像，避免已有 profile 漂移；新扫码与 Cookie 账号使用 native 模式，不再注入自定义 UA、Client Hints、定位和指纹脚本。

完整参数及保守默认值见 config.example.yaml 的 risk_control 段。

常见问题

问题	处理方式
macOS 安装依赖时报 command /usr/bin/clang++ failed with code 1	更新代码后删除旧的 .venv，再运行 ./start.sh install。旧版 playwright==1.49.1 固定依赖不支持 Python 3.14 wheel 的 greenlet==3.1.1，会错误地退回本地编译；当前依赖已更新，并会先升级 pip/setuptools/wheel。
Playwright 启动失败或找不到浏览器	运行 python -m playwright install chromium
扫码登录没有弹窗	确认当前机器有桌面环境；抖音也可使用 Cookie 登录
小红书扫码登录出现设备安全验证	尽量安装或更新本机稳定版 Google Chrome，并保持同一账号的 Profile 和网络出口稳定；没有 Chrome 时项目会回退到 Playwright Chromium
Windows 下出现 Playwright 子进程错误	使用单 worker 启动，不要添加 --workers
抓取不到作品或评论	检查登录态、目标链接和网络状态，必要时重新登录并降低频率
小红书链接解析失败	重新复制包含有效 xsec_token 的完整链接
仅音频仍得到 MP4，或视频没有声音/画质受限	重新运行安装命令更新依赖；也可安装系统 ffmpeg 并加入 PATH

仍有问题可提交 Issue，并附上平台、操作步骤和服务端错误日志。