Skip to content

CLAUDE.md

Latest commit

 

History

History
80 lines (64 loc) · 2.94 KB

CLAUDE.md

File metadata and controls

80 lines (64 loc) · 2.94 KB

xiaohongshu-skills

小红书自动化 Claude Code Skills，基于 Python CDP 浏览器自动化引擎。

Git 工作流

  • 所有代码修改必须在分支上进行，禁止直接推送 main 分支
  • 分支开发完成后通过 PR 合入 main

开发命令

uv sync                    # 安装依赖
uv run ruff check .        # Lint 检查
uv run ruff format .       # 代码格式化
uv run pytest              # 运行测试

架构

双层结构：scripts/ 是 Python CDP 自动化引擎，skills/ 是 Claude Code Skills 定义（SKILL.md 格式）。

  • scripts/xhs/ — 核心自动化库（模块化，每个功能一个文件）
  • scripts/cli.py — 统一 CLI 入口，23 个子命令，JSON 结构化输出
  • scripts/publish_pipeline.py — 发布编排器（含图片下载和登录检查）
  • skills/*/SKILL.md — 指导 Claude 如何调用 scripts/

调用方式

python scripts/cli.py check-login
python scripts/cli.py search-feeds --keyword "关键词"
python scripts/cli.py publish --title-file t.txt --content-file c.txt --images pic.jpg
python scripts/publish_pipeline.py --title-file t.txt --content-file c.txt --images URL1

代码规范

  • 行长度上限 100 字符
  • 完整 type hints，使用 from __future__ import annotations
  • 异常继承 XHSError（xhs/errors.py）
  • CLI exit code：0=成功，1=未登录，2=错误
  • 用户可见错误信息使用中文
  • JSON 输出 ensure_ascii=False

安全约束

  • 发布类操作必须有用户确认机制
  • 文件路径必须使用绝对路径
  • 敏感内容通过文件传递，不内联到命令行参数
  • Chrome Profile 目录隔离账号 cookies

CLI 子命令对照表

CLI 子命令 对应 MCP 工具 分类
check-login check_login_status 认证
login get_login_qrcode 认证
phone-login — 认证
delete-cookies delete_cookies 认证
list-feeds list_feeds 浏览
search-feeds search_feeds 浏览
get-feed-detail get_feed_detail 浏览
user-profile user_profile 浏览
post-comment post_comment_to_feed 互动
reply-comment reply_comment_in_feed 互动
like-feed like_feed 互动
favorite-feed favorite_feed 互动
publish publish_content 发布
publish-video publish_with_video 发布
fill-publish — 分步发布（图文填写）
fill-publish-video — 分步发布（视频填写）
click-publish — 分步发布（点击发布）
long-article — 长文发布（填写+排版）
select-template — 长文发布（选择模板）
next-step — 长文发布（下一步+描述）
add-account — 账号管理（添加，自动分配端口）
list-accounts — 账号管理（列出所有）
remove-account — 账号管理（删除）
set-default-account — 账号管理（设置默认）