redbeacon — 小红书自动化 CLI

把"选好题"以外的事全部交给 CLI：AI 生成文案 + 渲图 / 出图 → 审核 → 多账号发布 → 排期 → 选题库管理。所有命令都是 JSON in / JSON out，方便接入任何 agent、脚本、CI。

主要被 redbeacon-skill（Claude Code skill 封装）调用，但完全可以独立用。

安装

# 推荐：pipx 隔离环境
pipx install redbeacon

# 或者直接 pip
pip install redbeacon

# Playwright 渲图引擎（图文卡片用）
playwright install chromium

# 校验
redbeacon --version

CloakBrowser 的 stealth Chromium 在首次跑 redbeacon login start 时自动下载到 ~/.cloakbrowser/（约 200MB），不用手动装。

依赖：Python ≥ 3.11。

30 秒看懂

redbeacon readiness                   # 入口：看现在缺什么配
redbeacon config set ai_api_key sk-…  # 配 AI Key
redbeacon accounts create             # 建第 1 个小红书账号（id=1）
redbeacon login start --account-id 1  # 阻塞 + 弹浏览器扫码
redbeacon generate --account-id 1 --image-mode cards   # 生成一篇
redbeacon content list --account-id 1 --status pending_review
redbeacon content approve --account-id 1 --id 1        # 本地审核
redbeacon publish --account-id 1                       # 发布

每个命令成功 → exit 0 + stdout 一行 JSON；失败 → exit ≠0 + stderr {"error", "next"}。

命令总览

redbeacon --help / redbeacon <子命令> --help 看完整参数。

数据位置

环境变量覆盖：REDBEACON_DATA_DIR / REDBEACON_LOG_DIR。

跑 redbeacon status 看当前实际路径。

输出契约

• 默认：{"key": "value", ...} 一行 JSON
• TTY 下自动 indent=2 可读；强制覆盖：REDBEACON_OUT=pretty / REDBEACON_OUT=compact
• 错误：stderr {"error": "...", "next": "redbeacon <修复命令>"}

完整 schema 定义在 src/redbeacon/schemas.py（TypedDict）。

开发

git clone https://github.com/jidouqie/redbeacon-cli.git
cd redbeacon-cli

pip install -e .[dev]

# 测试
pytest tests/

# 本地跑
redbeacon --version
REDBEACON_DATA_DIR=/tmp/rb_dev redbeacon readiness

代码结构：

src/redbeacon/
├── cli.py            # argparse 入口 + dispatch
├── config.py         # settings 表读写（加密支持）
├── config_keys.py    # 所有 settings key 集中定义
├── database.py       # SQLite 初始化 + migrate
├── schemas.py        # 输出 TypedDict
├── render_xhs_v2.py  # 图文卡片渲染（Playwright）
├── routers/          # 子命令处理（accounts / login / config / publish ...）
├── services/
│   ├── xhs/          # CloakBrowser 集成（session/login/publish）
│   ├── feishu_api.py
│   ├── image_gen.py
│   └── proxy_service.py
├── tasks/            # 复杂业务编排（generate / publish / feishu_sync）
└── utils/            # logger / crypto / paths

加新命令：在 routers/ 下加文件 + 在 cli.py:_build_parser 和 _DISPATCH 注册即可。

License

MIT。详见 LICENSE。