Skill: ling-qian/chaceclaw-xiaohongshu-enhanced (version 1.0.1)

--- name: xiaohongshu description: | 小红书（RED/XHS）自动化助手。提供完整的小红书操作能力：登录、发布图文/视频、搜索笔记、浏览详情、点赞收藏评论、查看博主主页、内容策划。 当用户提到小红书、红书、XHS、RED、发笔记、搜笔记、小红书运营等任何与小红书相关的操作时使用此 skill，即使用户没有明确说"小红书"但描述的场景明显是小红书（如"发一篇种草笔记"、"帮我分析这个博主"）也应触发。 --- 你是小红书自动化助手，通过 xiaohongshu-mcp 的 MCP 工具帮助用户操作小红书。 ## 前置检查（每次执行必做） 所有小红书操作依赖 xiaohongshu-mcp 提供的 MCP 工具（如 `check_login_status`、`search_feeds` 等）。执行任何操作前，先确认这些工具是否可用： **判断方法**：检查当前可用的 MCP 工具列表中是否存在 `check_login_status`。 - **工具存在** → 正常执行后续流程 - **工具不存在** → 说明 xiaohongshu-mcp 服务未配置。直接告知用户：「小红书 MCP 服务尚未连接，请先运行 `/setup-xhs-mcp` 完成部署和配置。」不要尝试用其他工具（如 Playwright、WebFetch）代替。 ## 意图识别与路由 根据用户输入判断意图，然后直接按对应子 skill 的指令执行。如果意图不明确，先询问用户想做什么。 | 用户意图 | 执行 | 典型说法 | |---|---|---| | 安装部署 | 按 `setup-xhs-mcp` 执行 | 安装、部署、配置、第一次用、连不上 | | 登录 | 按 `xhs-login` 执行 | 登录、扫码、切换账号、检查登录 | | 发布内容 | 按 `post-to-xhs` 执行 | 发笔记、发图文、发视频、写一篇、上传 | | 搜索 | 按 `xhs-search` 执行 | 搜索、找笔记、搜一下、有没有 | | 浏览详情 | 按 `xhs-explore` 执行 | 推荐、首页、看详情、看评论 | | 互动 | 按 `xhs-interact` 执行 | 点赞、收藏、评论、回复 | | 查看用户 | 按 `xhs-profile` 执行 | 博主主页、看看这个作者 | | 内容策划 | 按 `xhs-content-plan` 执行 | 选题、竞品分析、热门、涨粉 | ## 全局约束 1. **MCP 连接优先**：必须通过前置检查确认 MCP 工具可用后才能执行任何操作——不可用时只提示用户运行 `/setup-xhs-mcp`，禁止用 Playwright、WebFetch 或其他非 xiaohongshu-mcp 的工具替代 2. **登录优先**：MCP 连接就绪后，除安装部署外，操作前先用 `check_login_status` 确认登录状态——未登录的情况下调用其他工具会失败 3. **用户确认**：发布、评论等写操作执行前展示内容让用户确认——因为这些操作发出后无法撤回，代表用户的公开行为 4. **参数来源**：`feed_id` 和 `xsec_token` 必须从搜索或浏览结果中获取，不可编造——编造的参数会导致 MCP 工具报错

path: _meta.json
content: {
  "name": "xiaohongshu-mcp-skills",
  "version": "1.0.0",
  "emoji": "📕",
  "description": "小红书（XHS）自动化助手 MCP Skill Pack。提供登录、发布图文/视频、搜索笔记、浏览详情、点赞收藏评论、查看博主主页、内容策划等完整操作能力。",
  "author": "xmznini",
  "maintainer": "Chaceclaw",
  "created": "2026-04-20",
  "updated": "2026-04-23",
  "license": "MIT",
  "category": "social-media",
  "tags": ["小红书", "XHS", "RED", "xiaohongshu", "社交媒体", "内容运营", "种草"],
  "triggers": [
    "小红书",
    "红书",
    "XHS",
    "RED",
    "发笔记",
    "搜笔记",
    "小红书运营",
    "种草",
    "博主"
  ],
  "platform": "clawhub",
  "requires_mcp": "xiaohongshu-mcp",
  "mcp_tools": [
    "check_login_status",
    "search_feeds",
    "get_note_detail",
    "get_user_profile",
    "post_note",
    "post_video",
    "like_note",
    "collect_note",
    "comment_note"
  ],
  "rate_limits": {
    "search": {"max_per_hour": 30, "cooldown_seconds": 120},
    "like": {"max_per_hour": 60, "cooldown_seconds": 60},
    "collect": {"max_per_hour": 60, "cooldown_seconds": 60},
    "comment": {"max_per_day": 30, "cooldown_seconds": 300},
    "post": {"max_per_day": 3, "cooldown_seconds": 3600}
  },
  "files": [
    "SKILL.md",
    "xhs-login/SKILL.md",
    "xhs-post/SKILL.md",
    "xhs-search/SKILL.md",
    "xhs-explore/SKILL.md",
    "xhs-interact/SKILL.md",
    "xhs-profile/SKILL.md",
    "xhs-content-plan/SKILL.md",
    "setup-xhs-mcp/SKILL.md",
    "xhs-rate-limits.md",
    "xhs-compliance.md",
    "_meta.json"
  ]
}

path: xhs-compliance.md
content: # 小红书内容合规检查表

> 发布前必读。违规内容将导致笔记被限流、删除，账号被封禁。本表适用于图文和视频笔记。

---

## 🚨 一、绝对禁止内容（零容忍）

以下内容一经发现直接封号，无申诉通道：

| 类别 | 具体内容 |
|------|---------|
| **政治** | 任何国家领导人、政党、军警、国旗相关；历史虚无主义内容 |
| **色情低俗** | 裸露、性暗示、擦边内容；低俗色情小说/影视剪辑 |
| **暴力血腥** | 暴力行为、血腥画面、虐待动物 |
| **赌博彩票** | 彩票预测、赌博平台推广、赌术教学 |
| **毒品** | 毒品制作、贩卖、使用；吸毒相关内容 |
| **诈骗** | 杀猪盘、刷单诈骗、仿冒品牌、虚假宣传 |
| **违禁品** | 枪支、管制刀具、危险化学品买卖 |
| **邪教迷信** | 宗教极端、邪教组织、封建迷信活动 |
| **未成年人** | 涉及未成年人不良内容；未成年人保护相关违规 |

---

## ⚠️ 二、平台限流内容（软性限制）

以下内容不会封号，但会被限流或推荐降权：

| 类别 | 说明 | 优化建议 |
|------|------|---------|
| **医疗养生** | 不能说"治愈"等绝对化词汇；未经审核的医疗建议 | 用"改善/缓解"；加"请遵医嘱" |
| **金融理财** | 不能推荐具体股票/基金；不能承诺收益 | 只做知识科普，不给投资建议 |
| **品牌对比** | 不得贬低竞品；对比需有依据 | 客观陈述差异，不说"吊打/完败" |
| **政治隐喻** | 任何看似政治隐喻的梗、图案、数字 | 避免政治相关联想内容 |
| **外链二维码** | 笔记中不能出现其他平台外链/二维码 | 引导至评论区或私信 |
| **联系方式** | 手机号、微信号等直接联系方式 | 通过小红书号或私信功能 |
| **侵权内容** | 未授权的品牌 logo、剧照、截图、表情包 | 使用原创或正版授权素材 |
| **虚假信息** | 夸大宣传、虚假数据、伪科普 | 引用正规来源，标注数据出处 |

---

## 📋 三、标题合规规范

### ✅ 合格标题示例
```
"这款面霜用了3个月，皮肤真的变好了｜真实测评"
"上海周边1小时直达｜适合周末遛娃的小众农场"
"手把手教你做3道简单家常菜，新手也能成功"
```

### ❌ 违规标题示例
```
"抹平皱纹的神药！三天见效！" → 绝对化医疗宣传
"LV、Gucci、Chanel 哪个最垃圾" → 恶意品牌对比
"只需一招，白嫖平台全额退款" → 教唆欺诈
```

### 标题用词红线
```
绝对化词：100%、绝对、保证、必须、神器、神药
欺诈类词：免费、白嫖、薅羊毛、漏洞
比较类词：最垃圾、吊打、完败、碾压（除非客观数据）
```

---

## 📝 四、正文合规规范

### 敏感话题处理
| 话题 | 风险点 | 安全写法 |
|------|-------|---------|
| **医美/整形** | 不得描述手术过程；不得对比效果承诺 | "本人体验，不构成医疗建议" |
| **减肥/瘦身** | 不得出现具体减重数字承诺 | "配合运动，效果因人而异" |
| **金融理财** | 不得出现具体收益数字；不得推荐具体产品 | "本内容仅供科普，不构成投资建议" |
| **教育** | 不得出现具体分数承诺；不得贬低其他教育方式 | "个人经验分享，理性参考" |
| **宗教** | 不得宣传特定宗教；不得贬低宗教信仰 | 完全避免宗教话题 |

### 违禁词清单（部分）
```
最、第一、顶级、极品、奇迹、神效、特效
立即、马上、马上见效
退款保证、100%退款
全网最低价、最便宜
根治、永不复发
```

### 正确标注格式
```markdown
## 数据来源声明（合规必备）
- 本文数据来源：[权威平台名称+链接]
- 个人体验分享，实际效果因人而异
- 本文不构成医疗/投资/法律建议
- 如有疑问请咨询专业人士
```

---

## 🖼️ 五、图片/视频合规

| 类型 | 合规要求 |
|------|---------|
| **人像** | 必须获得本人授权；未成年人需监护人同意 |
| **品牌 logo** | 避免完整展示；用马赛克遮盖部分 |
| **影视剧截图** | 不得超过总时长的 20%；需标注来源 |
| **地图** | 需使用正规导航截图；禁止使用军事设施照片 |
| **二维码/水印** | 禁止任何第三方平台二维码/水印 |
| **国旗国徽** | 禁止在背景/装饰中出现 |
| **野生动物** | 禁止保护动物制品展示 |

---

## 📌 六、评论互动合规

| 场景 | 风险 | 合规做法 |
|------|------|---------|
| **引导私信** | "私信我获取"可能被判定为引流 | "点击主页链接" |
| **评论回复** | 不能留微信号/手机号 | 引导至评论区或小红书群 |
| **私信回复** | 不能发送外链 | 仅小红书站内内容 |
| **置顶评论** | 不能置顶引流内容 | 置顶正面互动内容 |

---

## ✅ 七、发布前检查流程

### 强制检查项（发布前必须全部通过）

```markdown
## 发布前合规自检

### 标题检查
- [ ] 无绝对化词汇（最/第一/绝对/保证/神器）
- [ ] 无欺诈词汇（免费/白嫖/退款保证）
- [ ] 无恶意品牌对比（吊打/完败/最垃圾）
- [ ] 字数在 20 字以内

### 正文检查
- [ ] 无违禁词（见违禁词清单）
- [ ] 无具体医疗/投资承诺
- [ ] 有数据来源标注（若有数据）
- [ ] 有"个人体验/效果因人而异"声明
- [ ] 无外链/二维码/联系方式

### 图片检查
- [ ] 无他人人像（除非获得授权）
- [ ] 无品牌完整 logo
- [ ] 无二维码/其他平台水印
- [ ] 无国旗/军警元素
- [ ] 图片清晰度达标（≥1080p）

### 标签检查
- [ ] 无品牌硬植入话题
- [ ] 话题数量 3-10 个
- [ ] 无政治相关话题

### 互动设置
- [ ] 开启/关闭评论（根据内容决定）
- [ ] 开启/关闭收藏（根据内容决定）
- [ ] 开启/关闭转发（根据内容决定）
```

---

## 🔧 八、合规辅助工具

### 违禁词检测推荐
- **句意检测**：使用自然语言处理工具分析语义
- **官方工具**：小红书创作者中心-内容自检
- **第三方工具**：(不推荐，可能有数据泄露风险)

### 存证保存
发布前建议截图保存，包含：
1. 最终标题
2. 正文全文
3. 所有图片
4. 标签设置
5. 发布时间

---

*Last updated: 2026-04-23 | Chaceclaw Enhanced*

path: xhs-rate-limits.md
content: # 小红书 MCP 限流指南与防封策略

> 所有操作均有严格频率限制，超限将导致账号封禁或功能禁用。本文档为所有小红书操作的统一限流参考。

---

## ⚠️ 限流核心原则

1. **宁可慢，不要封** — 账号安全永远第一
2. **间隔 > 次数** — 保持足够冷却时间比限制操作次数更重要
3. **梯度操作** — 新账号前2周减少操作频率
4. **热操作分散** — 避免集中短时间大量操作

---

## 📊 官方限流阈值

| 操作类型 | 每小时上限 | 每天上限 | 最小冷却时间 | 备注 |
|---------|-----------|---------|------------|------|
| **搜索** | 30次 | 200次 | 120秒 | 搜索最容易被限流 |
| **点赞** | 60次 | 300次 | 60秒 | 批量点赞极易封号 |
| **收藏** | 60次 | 300次 | 60秒 | 与点赞合并计算 |
| **评论** | 15次 | 30次 | 300秒 | 最严格，超限直接禁言 |
| **关注/取关** | 20次 | 50次 | 180秒 | 批量取关比关注更危险 |
| **发布图文** | — | 3篇 | 3600秒 | 新账号1篇/天更安全 |
| **发布视频** | — | 2篇 | 7200秒 | 视频审核更严 |

---

## 🛡️ 防封操作模式

### 黄金间隔公式
```
安全间隔 = 基础冷却时间 × (1 + 随机抖动比例10-30%)
```

### 推荐操作模式

#### 模式 A：保守模式（新手账号/刚注册）
- 所有操作间隔 × 1.5
- 每天总操作数不超过上限的 50%
- 仅在白天（9:00-22:00）操作

#### 模式 B：标准模式（稳定运营账号）
- 所有操作按基础冷却时间
- 每天总操作数不超过上限的 70%
- 分散操作时间

#### 模式 C：激进模式（高权重老账号）
- 所有操作间隔 × 0.8
- 每天总操作数不超过上限的 85%
- 仍需遵守硬性上限

---

## 🔄 Token 刷新机制

### Token 有效期
- Cookie 方式：通常 7-30 天
- MCP 服务 token：通常 24 小时
- 建议每 12 小时主动刷新一次

### 刷新触发条件
```
任意 MCP 工具返回以下错误码时，触发刷新：
- 401 Unauthorized
- 403 Forbidden  
- 10003 (token过期)
- 操作返回空数据（非正常情况）
```

### 刷新流程
```python
# 伪代码 - token 刷新
def safe_call(mcp_tool, *args, **kwargs):
    try:
        result = mcp_tool(*args, **kwargs)
        return result
    except TokenExpiredError:
        # 1. 调用刷新接口
        refresh_token()
        # 2. 重试一次
        return mcp_tool(*args, **kwargs)
    except RateLimitError:
        # 1. 等待冷却
        wait(cooldown_seconds * random.uniform(1.5, 2.0))
        # 2. 重试一次
        return mcp_tool(*args, **kwargs)
```

### Token 存储位置
```
~/.config/xiaohongshu/
├── cookies.json      # 浏览器 Cookie
├── tokens.json       # API Token
└── accounts/
    └── {account_id}/
        └── token.json
```

---

## 🚫 封禁等级与应对

### 等级 1：功能限制
- **表现**：点赞/收藏失败，但仍可浏览
- **持续**：1-24 小时
- **应对**：停止所有操作，等待自然恢复

### 等级 2：账号限流
- **表现**：所有操作返回"操作过于频繁"
- **持续**：24-72 小时
- **应对**：完全停止 24 小时，之后按 30% 频率恢复

### 等级 3：临时封禁
- **表现**：需要验证，或某个功能完全不可用
- **持续**：3-7 天
- **应对**：停止所有操作 → 联系客服申诉 → 等待解封

### 等级 4：永久封禁
- **表现**：无法登录，账号回收
- **应对**：无法恢复，准备新账号

---

## 📋 操作前检查清单

每次批量操作前，必须确认：

```markdown
- [ ] 今日操作计数：
  - 搜索：X/200
  - 点赞：X/300
  - 收藏：X/300
  - 评论：X/30
  - 发布：X/3
- [ ] 上次操作时间已间隔 ≥ 60秒
- [ ] Token 有效期确认
- [ ] 账号无异常提示
- [ ] MCP 服务状态正常
```

---

## 🔧 自动保护实现

```python
class RateLimiter:
    def __init__(self):
        self.counters = {
            'search': {'count': 0, 'reset_at': 0},
            'like': {'count': 0, 'reset_at': 0},
            'comment': {'count': 0, 'reset_at': 0},
            'post': {'count': 0, 'reset_at': 0},
        }
        self.cooldowns = {
            'search': 120,
            'like': 60,
            'comment': 300,
            'post': 3600,
        }
    
    def can_proceed(self, action: str) -> tuple[bool, int]:
        """返回 (是否可以操作, 需等待秒数)"""
        now = time.time()
        c = self.counters[action]
        
        if now > c['reset_at']:
            c['count'] = 0
            c['reset_at'] = now + 3600
        
        limits = {'search': 30, 'like': 60, 'comment': 15, 'post': 3}
        if c['count'] >= limits[action]:
            return False, c['reset_at'] - now
        
        jitter = random.uniform(1.1, 1.3)
        time.sleep(self.cooldowns[action] * jitter)
        return True, 0
```

---

*Last updated: 2026-04-23 | Chaceclaw Enhanced*

Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (CRITICAL)