Claude Code 集成指南

本项目可作为 Claude Code 的 Skill 使用，让 AI 助手能够自动发布和搜索小红书内容。

安装

将项目复制到 Claude Code 的 skills 目录：

cp -r xiaohongshu-skill ~/.claude/skills/xiaohongshu-skill

创建 SKILL.md

在 ~/.claude/skills/xiaohongshu-skill/ 目录下创建 SKILL.md 文件：

# 小红书内容发布

根据用户输入自动判断发布方式，简化发布流程。

## 工作流程

- 用户提供完整内容 + 图片/图片URL → 直接进入发布流程
- 用户提供网页 URL → WebFetch 提取内容和图片 → 适当总结 → 发布流程

## 发布命令

### 无头模式（推荐）

```bash
python scripts/publish_pipeline.py --headless \
    --title-file title.txt \
    --content-file content.txt \
    --image-urls "URL1" "URL2"

有窗口模式

python scripts/publish_pipeline.py \
    --title-file title.txt \
    --content-file content.txt \
    --image-urls "URL1" "URL2"

标题规则

标题长度 ≤ 38，计算规则：

• 中文字符和中文标点：每个计 2
• 英文字母/数字/空格/ASCII标点：每个计 1

注意事项

• 发布前必须让用户确认内容
• 小红书发布必须有图片
• 如需登录，脚本会自动切换到有窗口模式

## 搜索功能

支持在小红书上搜索笔记，可选筛选条件：

```bash
# 基本搜索
python scripts/cdp_search.py search --keyword "关键词"

# 带筛选条件
python scripts/cdp_search.py search --keyword "关键词" --sort-by 最新 --note-type 图文

# 限制结果数量
python scripts/cdp_search.py search --keyword "关键词" --limit 5

# 无头模式
python scripts/cdp_search.py --headless search --keyword "关键词"

# 输出原始 JSON
python scripts/cdp_search.py search --keyword "关键词" --raw

筛选选项

参数	可选值
--sort-by	综合、最新、最多点赞、最多评论、最多收藏
--note-type	不限、视频、图文
--publish-time	不限、一天内、一周内、半年内
--search-scope	不限、已看过、未看过、已关注
--location	不限、同城、附近

搜索结果格式

默认输出精简摘要（JSON），包含 id、标题、作者、点赞数、链接等。 使用 --raw 输出完整原始数据。

使用示例

配置完成后，在 Claude Code 中可以这样使用：

用户: 发布这个链接到小红书 https://example.com/article

Claude: [使用 WebFetch 提取内容和图片]
        [总结内容，生成标题]
        [请求用户确认]
        [执行发布脚本]

搜索示例

用户: 搜一下小红书上关于"Python 学习"的笔记

Claude: [执行 cdp_search.py 搜索]
        [展示搜索结果摘要]

用户: 搜索小红书上最近一周最多点赞的旅游攻略

Claude: [执行 cdp_search.py --sort-by 最多点赞 --publish-time 一周内]
        [展示搜索结果]

账号管理

支持多账号发布：

# 添加账号
python scripts/cdp_publish.py add-account work --alias "工作账号"

# 登录账号
python scripts/cdp_publish.py --account work login

# 使用指定账号发布
python scripts/publish_pipeline.py --account work --headless ...