bubu-xhs-scraper-skill 1.1.0

package/README.en.md

@@ -0,0 +1,198 @@
+# xhs-scraper-skill
+
+[**中文文档**](./README.md)
+
+> A [Claude Code](https://claude.ai/claude-code) skill for scraping Xiaohongshu (小红书 / RedNote) data via [TikHub API](https://tikhub.io).
+> Compatible with **Claude Code** and **Openclaw**.
+
+---
+
+## Why I Built This
+
+I got my Xiaohongshu account restricted — and this is why.
+
+![XHS violation notice](./xhs-violation-notice.png)
+
+> **Violation notice (translated):** *"Your account has repeatedly used AI automation for posting/interactions. We will restrict your account functions. The platform does not support any third-party tools, software, or mini programs for auto-publishing content or inflating data. Repeated violations may result in a permanent ban."*
+
+Previously, I was scraping Xiaohongshu data using tools that required **logging in with my account** — including Playwright-based scrapers, Openclaw monitoring workflows, and `xiaohongshu-cli` type tools. All of them triggered XHS's upgraded AI automation detection. The problem is clear: **any tool that logs in with your account will be flagged**, regardless of what it's actually doing.
+
+**This skill takes a different approach.** It uses TikHub's API — a third-party data service that accesses public Xiaohongshu data through its own infrastructure. You never log in to XHS, never run a browser, and never touch your account's session. Your account stays safe.
+
+> Use this skill for reading and analyzing **public** Xiaohongshu data only — not for automating interactions (posting, liking, commenting) on your account.
+
+---
+
+## What it does
+
+Talk to Claude in plain language — no commands, no code. Claude will automatically pick the right API, extract IDs from URLs, paginate results, and export data.
+
+```
+帮我抓取这条小红书笔记的数据：https://www.xiaohongshu.com/explore/68304ca2...
+
+抓取用户「美食探店小王」的所有笔记，导出成 Excel
+
+搜索小红书上关于「护肤」的用户，列出粉丝数排名
+
+获取这个笔记的所有评论
+```
+
+**Supported Platforms:**
+
+| Platform | User Info | Content List | Content Detail | Comments | Search |
+|----------|-----------|-------------|----------------|----------|--------|
+| Xiaohongshu (XHS) | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Douyin | ✅ | ✅ | ✅ | ✅ | ✅ |
+| TikTok | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Bilibili | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Weibo | ✅ | ✅ | ✅ | — | ✅ |
+| WeChat MP (公众号) | — | ✅ | ✅ | ✅ | — |
+| WeChat Channels (视频号) | ✅ | — | ✅ | ✅ | ✅ |
+| Twitter / X | ✅ | ✅ | — | — | ✅ |
+| YouTube | — | — | — | — | ✅ |
+
+**Supports:**
+- Search users / content / topics across platforms
+- Get user profile (followers, post count, bio)
+- Fetch all content from a user (auto-pagination)
+- Get content detail — title, description, stats, cover image, topics
+- Get comments
+- Export to Excel / JSON
+
+---
+
+## Quick Start
+
+### 1. Install the skill
+
+```bash
+npx bubu-xhs-scraper-skill
+```
+
+This copies the skill into `~/.claude/skills/bubu-xhs-scraper-skill/`.
+
+---
+
+### 2. Get a TikHub API key
+
+1. Register at [user.tikhub.io](https://user.tikhub.io)
+2. Copy your API key from the dashboard
+
+> TikHub provides the underlying Xiaohongshu data API. Pricing: ~**$0.001 per call**, with 24h response caching (repeated identical requests are free). See [full pricing](https://user.tikhub.io/dashboard/pricing).
+
+---
+
+### 3. Add the API key to Claude Code
+
+Edit `~/.claude/settings.json`:
+
+```json
+{
+  "env": {
+    "TIKHUB_API_KEY": "your-api-key-here"
+  }
+}
+```
+
+> **Lazy mode:** Don't want to edit the file manually? Just paste your API key into Claude Code or Openclaw and say "add this to my config: `your-key`" — it'll handle the rest.
+
+---
+
+### 4. Install Python dependency
+
+```bash
+pip3 install httpx
+```
+
+---
+
+### 5. Restart Claude Code
+
+The skill activates automatically. Try asking:
+
+```
+帮我抓取这条小红书笔记的数据：https://www.xiaohongshu.com/explore/68304ca2...
+```
+
+---
+
+## Requirements
+
+| Requirement | Details |
+|-------------|---------|
+| Claude Code | [claude.ai/claude-code](https://claude.ai/claude-code) |
+| Node.js | ≥ 18 (for installer) |
+| Python 3 + `httpx` | `pip3 install httpx` |
+| TikHub API key | [user.tikhub.io](https://user.tikhub.io) |
+
+---
+
+## Supported Endpoints
+
+| Feature | Endpoint |
+|---------|----------|
+| Search users | `GET /api/v1/xiaohongshu/web/search_users` |
+| Get user info | `GET /api/v1/xiaohongshu/app/get_user_info` |
+| Get user notes | `GET /api/v1/xiaohongshu/app/get_user_notes` |
+| Get note detail | `GET /api/v1/xiaohongshu/app/get_note_info` |
+| Get note comments | `GET /api/v1/xiaohongshu/app/get_note_comments` |
+| Get notes by topic | `GET /api/v1/xiaohongshu/app/get_notes_by_topic` |
+| Home feed | `GET /api/v1/xiaohongshu/web/get_home_recommend` |
+
+---
+
+## How to Extract IDs from URLs
+
+**User ID** — from profile URL:
+```
+https://www.xiaohongshu.com/user/profile/5c1b1234...
+                                          ^^^^^^^^^^^
+```
+
+**Note ID** — from note URL:
+```
+https://www.xiaohongshu.com/explore/68304ca200000000...
+                                    ^^^^^^^^^^^^^^^^
+```
+
+> You don't need to extract IDs manually — just paste the full URL and Claude will handle it.
+
+---
+
+## Note Detail Fields
+
+| Field | Description |
+|-------|-------------|
+| `title` | Note title |
+| `desc` | Note description |
+| `type` | `"normal"` (image) or `"video"` |
+| `liked_count` | Like count |
+| `collected_count` | Collect/save count |
+| `comments_count` | Comment count |
+| `shared_count` | Share count |
+| `view_count` | View count |
+| `topics` | Topic tags |
+| `time` | Publish timestamp (seconds) |
+| `ip_location` | Author's IP location |
+| `images_list` | Image URLs (multiple resolutions) |
+| `video` | Video info (for video notes) |
+
+> ⚠️ `interact_info` in the raw response is always empty — the skill reads the correct top-level fields (`liked_count`, etc.) instead.
+
+---
+
+## Troubleshooting
+
+| Error | Likely Cause | Fix |
+|-------|-------------|-----|
+| `400` | Note deleted, or needs `share_text` | Paste the full share URL instead of just the note ID |
+| `401` | API key missing | Check `TIKHUB_API_KEY` in `~/.claude/settings.json` |
+| `429` | Rate limited | The skill adds delays automatically; wait a moment and retry |
+| Timeout | VPN / proxy conflict | Try toggling your VPN — `api.tikhub.io` may need direct access |
+| Cover URL broken | CDN URLs expire | Download cover images right away, don't save URLs for later use |
+
+---
+
+## License
+
+MIT

package/README.md

@@ -0,0 +1,205 @@
+# xhs-scraper-skill
+
+[**English**](./README.en.md)
+
+> 基于 [TikHub API](https://tikhub.io) 的小红书数据抓取工具，适用于 [Claude Code](https://claude.ai/claude-code) 和 **Openclaw**。
+
+---
+
+## 为什么做这个
+
+因为我的小红书账号被限流了。
+
+![小红书违规通知](./xhs-violation-notice.png)
+
+**违规原因：** 账号多次利用 AI 托管进行发文/互动，平台检测到自动化行为，限制了账号的发布、评论、私信等功能，有效期一周。
+
+在这之前，我用了不少工具来采集小红书数据，包括：
+
+- 基于 Playwright 的爬虫脚本（需要登录账号）
+- Openclaw 的小红书笔记监控流程
+- 各种 `xiaohongshu-cli` 类型的命令行工具
+
+这些工具有一个共同点：**都需要登录我的小红书账号**。而小红书现在升级了 AI 自动化检测，只要账号有可疑的自动化行为，就会被无差别封控——哪怕你只是在采集数据、没有发布任何内容。
+
+**这个 Skill 的解决思路完全不同。** 它调用的是 TikHub 的第三方数据接口，TikHub 通过自己的基础设施访问小红书的公开数据。你不需要登录小红书账号，不需要打开浏览器，也不会产生任何账号操作记录。你的账号安全。
+
+> 本工具仅用于读取和分析小红书**公开数据**，请勿用于自动化互动（发帖、点赞、评论）等可能违反平台规则的行为。
+
+---
+
+## 能做什么
+
+用自然语言告诉 Claude 你要抓什么，不需要写代码，不需要记命令。Claude 会自动识别意图、从链接中提取 ID、自动翻页，并导出结果。
+
+```
+帮我抓取这条小红书笔记的数据：https://www.xiaohongshu.com/explore/68304ca2...
+
+抓取用户「美食探店小王」的所有笔记，导出成 Excel
+
+搜索小红书上关于「护肤」的用户，列出粉丝数排名
+
+获取这个笔记的所有评论
+```
+
+**支持平台：**
+
+| 平台 | 用户信息 | 内容列表 | 内容详情 | 评论 | 搜索 |
+|------|---------|---------|---------|------|------|
+| 小红书 | ✅ | ✅ | ✅ | ✅ | ✅ |
+| 抖音 | ✅ | ✅ | ✅ | ✅ | ✅ |
+| TikTok | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Bilibili | ✅ | ✅ | ✅ | ✅ | ✅ |
+| 微博 | ✅ | ✅ | ✅ | — | ✅ |
+| 微信公众号 | — | ✅ | ✅ | ✅ | — |
+| 微信视频号 | ✅ | — | ✅ | ✅ | ✅ |
+| Twitter / X | ✅ | ✅ | — | — | ✅ |
+| YouTube | — | — | — | — | ✅ |
+
+**支持功能：**
+- 搜索用户 / 内容 / 话题
+- 获取用户主页数据（粉丝数、发帖数、简介等）
+- 获取用户所有内容（自动翻页）
+- 获取内容详情（标题、正文、互动数、封面图、话题标签）
+- 获取评论
+- 导出为 Excel / JSON
+
+---
+
+## 快速开始
+
+### 第一步 — 安装 Skill
+
+```bash
+npx bubu-xhs-scraper-skill
+```
+
+安装完成后，skill 文件会复制到 `~/.claude/skills/bubu-xhs-scraper-skill/`。
+
+---
+
+### 第二步 — 获取 TikHub API Key
+
+1. 前往 [user.tikhub.io](https://user.tikhub.io) 注册账号
+2. 在控制台中复制你的 API Key
+
+> TikHub 提供小红书底层数据接口。计费方式：约 **$0.001/次**，成功请求会缓存 24 小时（重复请求不额外计费）。详细定价见 [TikHub Pricing](https://user.tikhub.io/dashboard/pricing)。
+
+---
+
+### 第三步 — 配置 API Key
+
+编辑 `~/.claude/settings.json`，添加以下内容：
+
+```json
+{
+  "env": {
+    "TIKHUB_API_KEY": "你的-api-key"
+  }
+}
+```
+
+> **懒人方式：** 不想手动改文件？直接把 API Key 丢给 Claude Code 或 Openclaw，说一句「帮我把这个写入配置：`你的key`」，它会自动帮你完成配置。
+
+---
+
+### 第四步 — 安装 Python 依赖
+
+```bash
+pip3 install httpx
+```
+
+---
+
+### 第五步 — 重启 Claude Code
+
+重启后 skill 自动生效。试试这句话：
+
+```
+帮我抓取这条小红书笔记的数据：https://www.xiaohongshu.com/explore/68304ca2...
+```
+
+---
+
+## 环境要求
+
+| 要求 | 说明 |
+|------|------|
+| Claude Code | [claude.ai/claude-code](https://claude.ai/claude-code) |
+| Node.js | ≥ 18（安装脚本需要） |
+| Python 3 + `httpx` | `pip3 install httpx` |
+| TikHub API Key | [user.tikhub.io](https://user.tikhub.io) 注册获取 |
+
+---
+
+## 支持的接口
+
+| 功能 | 接口路径 |
+|------|---------|
+| 搜索用户 | `GET /api/v1/xiaohongshu/web/search_users` |
+| 获取用户信息 | `GET /api/v1/xiaohongshu/app/get_user_info` |
+| 获取用户笔记列表 | `GET /api/v1/xiaohongshu/app/get_user_notes` |
+| 获取笔记详情 | `GET /api/v1/xiaohongshu/app/get_note_info` |
+| 获取笔记评论 | `GET /api/v1/xiaohongshu/app/get_note_comments` |
+| 按话题获取笔记 | `GET /api/v1/xiaohongshu/app/get_notes_by_topic` |
+| 首页推荐 | `GET /api/v1/xiaohongshu/web/get_home_recommend` |
+
+---
+
+## 如何从链接中找到 ID
+
+**用户 ID** — 来自主页链接：
+```
+https://www.xiaohongshu.com/user/profile/5c1b1234...
+                                          ^^^^^^^^^^^
+                                          这就是 user_id
+```
+
+**笔记 ID** — 来自笔记链接：
+```
+https://www.xiaohongshu.com/explore/68304ca200000000...
+                                    ^^^^^^^^^^^^^^^^
+                                    这就是 note_id
+```
+
+> 不需要手动提取 ID，直接把完整链接发给 Claude，它会自动处理。
+
+---
+
+## 笔记详情字段说明
+
+| 字段 | 含义 |
+|------|------|
+| `title` | 笔记标题 |
+| `desc` | 笔记正文 |
+| `type` | `"normal"`（图文）或 `"video"`（视频） |
+| `liked_count` | 点赞数 |
+| `collected_count` | 收藏数 |
+| `comments_count` | 评论数 |
+| `shared_count` | 分享数 |
+| `view_count` | 浏览数 |
+| `topics` | 话题标签列表 |
+| `time` | 发布时间戳（秒） |
+| `ip_location` | 发布 IP 归属地 |
+| `images_list` | 图片列表（多档清晰度） |
+| `video` | 视频信息（视频笔记专有） |
+
+> ⚠️ 原始响应中 `interact_info` 字段始终为空，Skill 会自动读取顶层的 `liked_count` 等字段，无需关心。
+
+---
+
+## 常见问题
+
+| 报错 | 可能原因 | 解决方法 |
+|------|---------|---------|
+| `400` | 笔记已删除，或需要分享链接 | 换用完整的分享链接（而不是单独的 note_id） |
+| `401` | API Key 未配置 | 检查 `~/.claude/settings.json` 中的 `TIKHUB_API_KEY` |
+| `429` | 触发限流 | Skill 已自动加延迟，稍等片刻后重试 |
+| 请求超时 | VPN 或代理冲突 | 尝试切换 VPN 状态，`api.tikhub.io` 可能需要直连 |
+| 封面链接失效 | CDN 链接带时效签名 | 抓到封面链接后立即下载，不要只保存 URL |
+
+---
+
+## 开源协议
+
+MIT

package/README.zh-CN.md

@@ -0,0 +1,190 @@
+# xhs-scraper-skill
+
+[**English**](./README.en.md)
+
+> 基于 [TikHub API](https://tikhub.io) 的小红书数据抓取工具，适用于 [Claude Code](https://claude.ai/claude-code) 和 **Openclaw**。
+
+---
+
+## 为什么做这个
+
+因为我的小红书账号被限流了。
+
+![小红书违规通知](./xhs-violation-notice.png)
+
+**违规原因：** 账号多次利用 AI 托管进行发文/互动，平台检测到自动化行为，限制了账号的发布、评论、私信等功能，有效期一周。
+
+在这之前，我用了不少工具来采集小红书数据，包括：
+
+- 基于 Playwright 的爬虫脚本（需要登录账号）
+- Openclaw 的小红书笔记监控流程
+- 各种 `xiaohongshu-cli` 类型的命令行工具
+
+这些工具有一个共同点：**都需要登录我的小红书账号**。而小红书现在升级了 AI 自动化检测，只要账号有可疑的自动化行为，就会被无差别封控——哪怕你只是在采集数据、没有发布任何内容。
+
+**这个 Skill 的解决思路完全不同。** 它调用的是 TikHub 的第三方数据接口，TikHub 通过自己的基础设施访问小红书的公开数据。你不需要登录小红书账号，不需要打开浏览器，也不会产生任何账号操作记录。你的账号安全。
+
+> 本工具仅用于读取和分析小红书**公开数据**，请勿用于自动化互动（发帖、点赞、评论）等可能违反平台规则的行为。
+
+---
+
+## 能做什么
+
+用自然语言告诉 Claude 你要抓什么，不需要写代码，不需要记命令。Claude 会自动识别意图、从链接中提取 ID、自动翻页，并导出结果。
+
+```
+帮我抓取这条小红书笔记的数据：https://www.xiaohongshu.com/explore/68304ca2...
+
+抓取用户「美食探店小王」的所有笔记，导出成 Excel
+
+搜索小红书上关于「护肤」的用户，列出粉丝数排名
+
+获取这个笔记的所有评论
+```
+
+**支持功能：**
+- 按关键词搜索用户
+- 获取用户主页数据（粉丝数、发帖数、简介等）
+- 获取用户所有笔记（自动翻页）
+- 获取笔记详情（标题、正文、互动数、封面图、话题标签）
+- 获取笔记评论
+- 按话题获取笔记 / 获取首页推荐
+- 导出为 Excel / JSON
+
+---
+
+## 快速开始
+
+### 第一步 — 安装 Skill
+
+```bash
+npx bubu-xhs-scraper-skill
+```
+
+安装完成后，skill 文件会复制到 `~/.claude/skills/bubu-xhs-scraper-skill/`。
+
+---
+
+### 第二步 — 获取 TikHub API Key
+
+1. 前往 [user.tikhub.io](https://user.tikhub.io) 注册账号
+2. 在控制台中复制你的 API Key
+
+> TikHub 提供小红书底层数据接口。计费方式：约 **$0.001/次**，成功请求会缓存 24 小时（重复请求不额外计费）。详细定价见 [TikHub Pricing](https://user.tikhub.io/dashboard/pricing)。
+
+---
+
+### 第三步 — 配置 API Key
+
+编辑 `~/.claude/settings.json`，添加以下内容：
+
+```json
+{
+  "env": {
+    "TIKHUB_API_KEY": "你的-api-key"
+  }
+}
+```
+
+---
+
+### 第四步 — 安装 Python 依赖
+
+```bash
+pip3 install httpx
+```
+
+---
+
+### 第五步 — 重启 Claude Code
+
+重启后 skill 自动生效。试试这句话：
+
+```
+帮我抓取这条小红书笔记的数据：https://www.xiaohongshu.com/explore/68304ca2...
+```
+
+---
+
+## 环境要求
+
+| 要求 | 说明 |
+|------|------|
+| Claude Code | [claude.ai/claude-code](https://claude.ai/claude-code) |
+| Node.js | ≥ 18（安装脚本需要） |
+| Python 3 + `httpx` | `pip3 install httpx` |
+| TikHub API Key | [user.tikhub.io](https://user.tikhub.io) 注册获取 |
+
+---
+
+## 支持的接口
+
+| 功能 | 接口路径 |
+|------|---------|
+| 搜索用户 | `GET /api/v1/xiaohongshu/web/search_users` |
+| 获取用户信息 | `GET /api/v1/xiaohongshu/app/get_user_info` |
+| 获取用户笔记列表 | `GET /api/v1/xiaohongshu/app/get_user_notes` |
+| 获取笔记详情 | `GET /api/v1/xiaohongshu/app/get_note_info` |
+| 获取笔记评论 | `GET /api/v1/xiaohongshu/app/get_note_comments` |
+| 按话题获取笔记 | `GET /api/v1/xiaohongshu/app/get_notes_by_topic` |
+| 首页推荐 | `GET /api/v1/xiaohongshu/web/get_home_recommend` |
+
+---
+
+## 如何从链接中找到 ID
+
+**用户 ID** — 来自主页链接：
+```
+https://www.xiaohongshu.com/user/profile/5c1b1234...
+                                          ^^^^^^^^^^^
+                                          这就是 user_id
+```
+
+**笔记 ID** — 来自笔记链接：
+```
+https://www.xiaohongshu.com/explore/68304ca200000000...
+                                    ^^^^^^^^^^^^^^^^
+                                    这就是 note_id
+```
+
+> 不需要手动提取 ID，直接把完整链接发给 Claude，它会自动处理。
+
+---
+
+## 笔记详情字段说明
+
+| 字段 | 含义 |
+|------|------|
+| `title` | 笔记标题 |
+| `desc` | 笔记正文 |
+| `type` | `"normal"`（图文）或 `"video"`（视频） |
+| `liked_count` | 点赞数 |
+| `collected_count` | 收藏数 |
+| `comments_count` | 评论数 |
+| `shared_count` | 分享数 |
+| `view_count` | 浏览数 |
+| `topics` | 话题标签列表 |
+| `time` | 发布时间戳（秒） |
+| `ip_location` | 发布 IP 归属地 |
+| `images_list` | 图片列表（多档清晰度） |
+| `video` | 视频信息（视频笔记专有） |
+
+> ⚠️ 原始响应中 `interact_info` 字段始终为空，Skill 会自动读取顶层的 `liked_count` 等字段，无需关心。
+
+---
+
+## 常见问题
+
+| 报错 | 可能原因 | 解决方法 |
+|------|---------|---------|
+| `400` | 笔记已删除，或需要分享链接 | 换用完整的分享链接（而不是单独的 note_id） |
+| `401` | API Key 未配置 | 检查 `~/.claude/settings.json` 中的 `TIKHUB_API_KEY` |
+| `429` | 触发限流 | Skill 已自动加延迟，稍等片刻后重试 |
+| 请求超时 | VPN 或代理冲突 | 尝试切换 VPN 状态，`api.tikhub.io` 可能需要直连 |
+| 封面链接失效 | CDN 链接带时效签名 | 抓到封面链接后立即下载，不要只保存 URL |
+
+---
+
+## 开源协议
+
+MIT

package/bin/install.mjs

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+/**
+ * bubu-xhs-scraper-skill installer
+ * Installs the XHS Scraper skill to ~/.claude/skills/
+ *
+ * Usage:
+ *   npx bubu-xhs-scraper-skill
+ *   npx bubu-xhs-scraper-skill install
+ */
+
+import { readFileSync, mkdirSync, writeFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const SKILL_NAME = 'bubu-xhs-scraper-skill';
+const SKILLS_DIR = join(homedir(), '.claude', 'skills');
+const TARGET_DIR = join(SKILLS_DIR, SKILL_NAME);
+const SKILL_FILE = join(__dirname, '..', 'skills', SKILL_NAME, 'SKILL.md');
+
+function printBanner() {
+  console.log('\x1b[36m');
+  console.log('╔══════════════════════════════════╗');
+  console.log('║     bubu-xhs-scraper-skill v1.1.0     ║');
+  console.log('║   Claude Code Skill Installer    ║');
+  console.log('╚══════════════════════════════════╝');
+  console.log('\x1b[0m');
+}
+
+function install() {
+  printBanner();
+
+  // Create skills directory if needed
+  if (!existsSync(SKILLS_DIR)) {
+    mkdirSync(SKILLS_DIR, { recursive: true });
+    console.log(`\x1b[32m✓ Created ${SKILLS_DIR}\x1b[0m`);
+  }
+
+  // Create skill directory
+  mkdirSync(TARGET_DIR, { recursive: true });
+
+  // Copy SKILL.md
+  const skillContent = readFileSync(SKILL_FILE, 'utf8');
+  writeFileSync(join(TARGET_DIR, 'SKILL.md'), skillContent);
+
+  console.log(`\x1b[32m✓ Installed skill to: ${TARGET_DIR}\x1b[0m\n`);
+
+  console.log('\x1b[33m📋 Setup required:\x1b[0m');
+  console.log('  1. Get a TikHub API key at \x1b[4mhttps://user.tikhub.io\x1b[0m');
+  console.log('  2. Add to ~/.claude/settings.json:');
+  console.log('\x1b[90m     {');
+  console.log('       "env": {');
+  console.log('         "TIKHUB_API_KEY": "your-api-key-here"');
+  console.log('       }');
+  console.log('     }\x1b[0m\n');
+
+  console.log('  3. Install Python dependency:');
+  console.log('\x1b[90m     pip3 install httpx\x1b[0m\n');
+
+  console.log('\x1b[32m✨ Done! Restart Claude Code and ask it to scrape XHS data.\x1b[0m');
+  console.log('\x1b[90m   Example: "帮我抓取这条小红书笔记的数据：<url>"\x1b[0m\n');
+}
+
+const args = process.argv.slice(2);
+const cmd = args[0];
+
+if (cmd === '--help' || cmd === '-h') {
+  console.log('Usage: npx bubu-xhs-scraper-skill [install]');
+  console.log('Installs the XHS Scraper skill for Claude Code.');
+} else {
+  // Default action is install
+  install();
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "bubu-xhs-scraper-skill",
+  "version": "1.1.0",
+  "description": "Multi-platform social media scraper skill for Claude Code & Openclaw, powered by TikHub API. Supports XHS, Douyin, TikTok, Bilibili, Weibo, YouTube, WeChat, Twitter/X.",
+  "type": "module",
+  "bin": {
+    "bubu-xhs-scraper-skill": "bin/install.mjs"
+  },
+  "files": [
+    "bin/",
+    "skills/"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "openclaw",
+    "skill",
+    "xiaohongshu",
+    "xhs",
+    "scraper",
+    "tikhub",
+    "douyin",
+    "tiktok",
+    "bilibili",
+    "weibo",
+    "youtube",
+    "wechat",
+    "twitter"
+  ],
+  "author": "wushijing123",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wushijing123/xhs-scraper-skill.git"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  }
+}

package/skills/bubu-xhs-scraper-skill/SKILL.md

@@ -0,0 +1,367 @@
+---
+name: bubu-xhs-scraper-skill
+description: 多平台社交媒体数据抓取工具，基于 TikHub API。支持小红书、抖音、TikTok、Bilibili、微博、YouTube、微信公众号、视频号、Twitter/X。触发词：「小红书」「抖音」「TikTok」「B站」「bilibili」「微博」「YouTube」「公众号」「视频号」「Twitter」「X平台」「抓取数据」「获取用户」「搜索」「评论」「笔记」「视频」。只要用户提到这些平台 + 数据需求，立即触发此 skill。
+version: 1.1.0
+metadata:
+  openclaw:
+    requires:
+      env:
+        - TIKHUB_API_KEY
+      bins:
+        - python3
+    primaryEnv: TIKHUB_API_KEY
+    emoji: 🔍
+    homepage: https://github.com/wushijing123/xhs-scraper-skill
+    setup:
+      command: pip3 install httpx
+---
+
+# 多平台数据抓取 Skill（TikHub API）
+
+## 概述
+
+通过 TikHub API 直接 HTTP 调用抓取多平台数据。API key 存储在环境变量 `TIKHUB_API_KEY` 中，**无需用户提供**。
+
+> **重要**：不要使用 `tikhub` Python SDK，它的端点已过时。直接用 `httpx` 调用 API。
+
+## 支持平台一览
+
+| 平台 | 用户信息 | 内容列表 | 内容详情 | 评论 | 搜索 | 热搜 |
+|------|---------|---------|---------|------|------|------|
+| 小红书 | ✅ | ✅ | ✅ | ✅ | ✅ | — |
+| 抖音 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| TikTok | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Bilibili | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| 微博 | ✅ | ✅ | ✅ | — | ✅ | ✅ |
+| 微信公众号 | — | ✅ | ✅ | ✅ | — | — |
+| 微信视频号 | ✅ | — | ✅ | ✅ | ✅ | ✅ |
+| Twitter / X | ✅ | ✅ | — | — | ✅ | — |
+| YouTube | — | — | — | — | ✅ | — |
+
+## 安装依赖
+
+```bash
+pip3 install httpx
+```
+
+## 标准代码模板
+
+```python
+import asyncio, os, httpx
+
+BASE_URL = "https://api.tikhub.io"
+HEADERS = {"Authorization": f"Bearer {os.environ.get('TIKHUB_API_KEY')}"}
+
+async def api_get(endpoint: str, params: dict) -> dict:
+    async with httpx.AsyncClient() as client:
+        r = await client.get(f"{BASE_URL}{endpoint}", params=params, headers=HEADERS, timeout=30)
+        r.raise_for_status()
+        return r.json()
+```
+
+---
+
+## 平台一：小红书（Xiaohongshu）
+
+### 端点列表
+
+| 功能 | 端点 | 主要参数 |
+|------|------|---------|
+| 搜索用户 | `GET /api/v1/xiaohongshu/web/search_users` | `keyword`, `page` |
+| 获取用户信息（Web） | `GET /api/v1/xiaohongshu/web/get_user_info` | `user_id` |
+| 获取用户信息（App） | `GET /api/v1/xiaohongshu/app/get_user_info` | `user_id` |
+| 获取用户笔记（Web） | `GET /api/v1/xiaohongshu/web/get_user_notes_v2` | `user_id`, `cursor` |
+| 获取用户笔记（App） | `GET /api/v1/xiaohongshu/app/get_user_notes` | `user_id`, `cursor` |
+| 获取笔记详情 | `GET /api/v1/xiaohongshu/app/get_note_info` | `note_id` 或 `share_text` |
+| 获取笔记评论 | `GET /api/v1/xiaohongshu/app/get_note_comments` | `note_id` |
+| 按话题获取笔记 | `GET /api/v1/xiaohongshu/app/get_notes_by_topic` | `topic_id` |
+| 首页推荐 | `GET /api/v1/xiaohongshu/web/get_home_recommend` | 无 |
+
+### 响应要点
+
+- **笔记详情路径**：`data["data"][0]["note_list"][0]`
+- **互动数**：`liked_count` / `collected_count` / `comments_count` / `shared_count` 在顶层，`interact_info` 始终为空
+- **时间戳**：秒级，用 `datetime.fromtimestamp(ts)`
+- **封面图**：`images_list[0]["original"]`（原图）或 `["url"]`（压缩版），CDN 有时效，立即下载
+- `note_id` 优先于 `share_text`；`xhslink.com` 短链可直接作为 `share_text`
+
+### ID 提取
+
+```
+用户ID：https://www.xiaohongshu.com/user/profile/{user_id}
+笔记ID：https://www.xiaohongshu.com/explore/{note_id}
+```
+
+---
+
+## 平台二：抖音（Douyin）
+
+### 端点列表
+
+| 功能 | 端点 | 主要参数 |
+|------|------|---------|
+| 获取用户主页 | `GET /api/v1/douyin/web/handler_user_profile` | `unique_id` 或 `sec_user_id` |
+| 获取用户视频列表 | `GET /api/v1/douyin/web/fetch_user_post_videos` | `sec_user_id`, `max_cursor` |
+| 获取单条视频 | `GET /api/v1/douyin/web/fetch_one_video` | `aweme_id` |
+| 通过分享链接获取视频 | `GET /api/v1/douyin/web/fetch_one_video_by_share_url` | `share_url` |
+| 获取视频评论 | `GET /api/v1/douyin/web/fetch_video_comments` | `aweme_id`, `cursor` |
+| 搜索用户 | `GET /api/v1/douyin/web/fetch_user_search_result` | `keyword`, `cursor` |
+| 搜索视频 | `GET /api/v1/douyin/web/fetch_video_search_result` | `keyword`, `cursor` |
+| 热搜榜 | `GET /api/v1/douyin/web/fetch_hot_search_result` | 无 |
+
+### 备用端点（App 版，Web 失败时用）
+
+| 功能 | 端点 | 主要参数 |
+|------|------|---------|
+| 获取用户主页 | `GET /api/v1/douyin/app/v3/handler_user_profile` | `sec_user_id` |
+| 获取用户视频 | `GET /api/v1/douyin/app/v3/fetch_user_post_videos` | `sec_user_id`, `max_cursor` |
+| 获取单条视频 | `GET /api/v1/douyin/app/v3/fetch_one_video` | `aweme_id` |
+| 通过分享链接获取视频 | `GET /api/v1/douyin/app/v3/fetch_one_video_by_share_url` | `share_url` |
+| 搜索视频 | `GET /api/v1/douyin/app/v3/fetch_video_search_result` | `keyword`, `cursor` |
+
+### 响应要点
+
+- `unique_id` = 抖音号（@xxx），`sec_user_id` = URL 中的长 ID
+- 视频列表翻页用 `max_cursor`（不是 `cursor`）
+- 从 URL 提取 `aweme_id`：`douyin.com/video/{aweme_id}`
+
+### ID 提取
+
+```
+sec_user_id：https://www.douyin.com/user/{sec_user_id}
+aweme_id：https://www.douyin.com/video/{aweme_id}
+```
+
+---
+
+## 平台三：TikTok
+
+### 端点列表
+
+| 功能 | 端点 | 主要参数 |
+|------|------|---------|
+| 获取用户主页 | `GET /api/v1/tiktok/web/fetch_user_profile` | `uniqueId` |
+| 获取用户视频 | `GET /api/v1/tiktok/web/fetch_user_post` | `secUid`, `cursor`, `count` |
+| 获取视频详情 | `GET /api/v1/tiktok/web/fetch_post_detail` | `itemId` |
+| 通过分享链接获取视频 | `GET /api/v1/tiktok/app/v3/fetch_one_video_by_share_url` | `share_url` |
+| 获取视频评论 | `GET /api/v1/tiktok/web/fetch_post_comment` | `aweme_id`, `cursor` |
+| 搜索用户 | `GET /api/v1/tiktok/web/fetch_search_user` | `keyword`, `cursor` |
+| 搜索视频 | `GET /api/v1/tiktok/web/fetch_search_video` | `keyword`, `count`, `offset` |
+| 热门话题 | `GET /api/v1/tiktok/web/fetch_trending_searchwords` | 无 |
+
+### 备用端点（App 版，Web 失败时用）
+
+| 功能 | 端点 | 主要参数 |
+|------|------|---------|
+| 获取用户主页 | `GET /api/v1/tiktok/app/v3/handler_user_profile` | `sec_user_id` |
+| 获取用户视频 | `GET /api/v1/tiktok/app/v3/fetch_user_post_videos` | `sec_user_id`, `max_cursor` |
+| 获取单条视频 | `GET /api/v1/tiktok/app/v3/fetch_one_video` | `aweme_id` |
+| 搜索用户 | `GET /api/v1/tiktok/app/v3/fetch_user_search_result` | `keyword`, `cursor` |
+| 搜索视频 | `GET /api/v1/tiktok/app/v3/fetch_video_search_result` | `keyword`, `cursor` |
+
+### 响应要点
+
+- `uniqueId` = @用户名（不含@），`secUid` = URL 中的长 ID
+- 先用 `uniqueId` 调用 `fetch_user_profile` 拿到 `secUid`，再翻页获取视频
+- 视频列表翻页用 `cursor`
+
+### ID 提取
+
+```
+uniqueId：https://www.tiktok.com/@{uniqueId}
+itemId：https://www.tiktok.com/@xxx/video/{itemId}
+```
+
+---
+
+## 平台四：Bilibili
+
+### 端点列表
+
+| 功能 | 端点 | 主要参数 |
+|------|------|---------|
+| 获取用户主页 | `GET /api/v1/bilibili/web/fetch_user_profile` | `uid` |
+| 获取用户视频 | `GET /api/v1/bilibili/web/fetch_user_post_videos` | `uid`, `page`, `pagesize` |
+| 获取视频详情 | `GET /api/v1/bilibili/web/fetch_one_video` | `bvid` 或 `aid` |
+| 获取视频详情 v2 | `GET /api/v1/bilibili/web/fetch_video_detail` | `bvid` |
+| 获取视频评论 | `GET /api/v1/bilibili/web/fetch_video_comments` | `bvid`, `page` |
+| 综合搜索 | `GET /api/v1/bilibili/web/fetch_general_search` | `keyword`, `page` |
+| 热搜 | `GET /api/v1/bilibili/web/fetch_hot_search` | 无 |
+
+### 备用端点（App 版，Web 失败时用）
+
+| 功能 | 端点 | 主要参数 |
+|------|------|---------|
+| 获取用户信息 | `GET /api/v1/bilibili/app/fetch_user_info` | `uid` |
+| 获取用户视频 | `GET /api/v1/bilibili/app/fetch_user_videos` | `uid`, `page` |
+| 获取视频详情 | `GET /api/v1/bilibili/app/fetch_one_video` | `bvid` |
+| 获取视频评论 | `GET /api/v1/bilibili/app/fetch_video_comments` | `bvid`, `page` |
+| 综合搜索 | `GET /api/v1/bilibili/app/fetch_search_all` | `keyword`, `page` |
+
+### 响应要点
+
+- `uid` = 数字用户 ID
+- `bvid` = BV 号（如 `BV1xx411c7mD`），`aid` = AV 号（数字）
+- 视频列表翻页用 `page`（从 1 开始），`pagesize` 默认 30
+
+### ID 提取
+
+```
+uid：https://space.bilibili.com/{uid}
+bvid：https://www.bilibili.com/video/{bvid}
+```
+
+---
+
+## 平台五：微博（Weibo）
+
+### 端点列表
+
+| 功能 | 端点 | 主要参数 |
+|------|------|---------|
+| 获取用户信息 | `GET /api/v1/weibo/app/fetch_user_info` | `uid` 或 `screen_name` |
+| 获取用户微博 | `GET /api/v1/weibo/web/fetch_user_posts` | `uid`, `page` |
+| 获取用户视频 | `GET /api/v1/weibo/web_v2/fetch_user_video_list` | `uid`, `page` |
+| 搜索（综合） | `GET /api/v1/weibo/web/fetch_search` | `keyword`, `page` |
+| 搜索用户 | `GET /api/v1/weibo/web_v2/fetch_user_search` | `keyword`, `page` |
+| 搜索视频 | `GET /api/v1/weibo/web_v2/fetch_video_search` | `keyword`, `page` |
+| 热搜榜 | `GET /api/v1/weibo/app/fetch_hot_search` | 无 |
+| AI 热点搜索 | `GET /api/v1/weibo/web_v2/fetch_ai_search` | `keyword` |
+| 高级搜索 | `GET /api/v1/weibo/web_v2/fetch_advanced_search` | `keyword`, `page` |
+
+### 响应要点
+
+- `uid` = 数字 ID，`screen_name` = 微博昵称
+- 翻页用 `page`（从 1 开始）
+
+### ID 提取
+
+```
+uid：https://weibo.com/u/{uid}
+     https://weibo.com/{screen_name}（昵称直接用）
+```
+
+---
+
+## 平台六：YouTube
+
+> ⚠️ **目前仅支持搜索**，暂无频道详情或视频详情端点。
+
+### 端点列表
+
+| 功能 | 端点 | 主要参数 |
+|------|------|---------|
+| 综合搜索 | `GET /api/v1/youtube/web_v2/get_general_search` | `keyword` |
+| 搜索频道 | `GET /api/v1/youtube/web_v2/search_channels` | `keyword` |
+| 搜索视频 | `GET /api/v1/youtube/web/search_video` | `keyword` |
+| 搜索 Shorts | `GET /api/v1/youtube/web_v2/get_shorts_search` | `keyword` |
+| 搜索建议词 | `GET /api/v1/youtube/web_v2/get_search_suggestions` | `keyword` |
+
+---
+
+## 平台七：微信公众号（WeChat MP）
+
+### 端点列表
+
+| 功能 | 端点 | 主要参数 |
+|------|------|---------|
+| 获取文章详情（JSON） | `GET /api/v1/wechat_mp/web/fetch_mp_article_detail_json` | `url` |
+| 获取文章详情（HTML） | `GET /api/v1/wechat_mp/web/fetch_mp_article_detail_html` | `url` |
+| 获取公众号文章列表 | `GET /api/v1/wechat_mp/web/fetch_mp_article_list` | `url` 或 `biz` |
+| 获取文章评论 | `GET /api/v1/wechat_mp/web/fetch_mp_article_comment_list` | `url` |
+| 获取文章阅读数 | `GET /api/v1/wechat_mp/web/fetch_mp_article_read_count` | `url` |
+| 获取相关文章 | `GET /api/v1/wechat_mp/web/fetch_mp_related_articles` | `url` |
+| 获取文章广告 | `GET /api/v1/wechat_mp/web/fetch_mp_article_ad` | `url` |
+
+### 响应要点
+
+- 所有端点主要参数为文章 `url`（`mp.weixin.qq.com/s/...`）
+- `biz` = 公众号唯一标识，从文章 URL 中提取：`__biz=MzI...`
+
+---
+
+## 平台八：微信视频号（WeChat Channels）
+
+### 端点列表
+
+| 功能 | 端点 | 主要参数 |
+|------|------|---------|
+| 搜索创作者 | `GET /api/v1/wechat_channels/fetch_user_search` | `keyword` |
+| 搜索创作者 v2 | `GET /api/v1/wechat_channels/fetch_user_search_v2` | `keyword` |
+| 综合搜索 | `GET /api/v1/wechat_channels/fetch_default_search` | `keyword` |
+| 最新内容搜索 | `GET /api/v1/wechat_channels/fetch_search_latest` | `keyword` |
+| 普通内容搜索 | `GET /api/v1/wechat_channels/fetch_search_ordinary` | `keyword` |
+| 获取视频详情 | `GET /api/v1/wechat_channels/fetch_video_detail` | `video_id` 或 `url` |
+| 获取视频评论 | `GET /api/v1/wechat_channels/fetch_comments` | `video_id` |
+| 主页内容 | `GET /api/v1/wechat_channels/fetch_home_page` | `username` |
+| 热词 | `GET /api/v1/wechat_channels/fetch_hot_words` | 无 |
+| 直播历史 | `GET /api/v1/wechat_channels/fetch_live_history` | `username` |
+
+---
+
+## 平台九：Twitter / X
+
+### 端点列表
+
+| 功能 | 端点 | 主要参数 |
+|------|------|---------|
+| 获取用户主页 | `GET /api/v1/twitter/web/fetch_user_profile` | `screen_name` 或 `user_id` |
+| 获取用户推文 | `GET /api/v1/twitter/web/fetch_user_post_tweet` | `user_id`, `cursor` |
+| 搜索推文 | `GET /api/v1/twitter/web/fetch_search_timeline` | `keyword`, `cursor` |
+
+### 响应要点
+
+- `screen_name` = @用户名（不含@），`user_id` = 数字 ID
+- 先用 `screen_name` 调 `fetch_user_profile` 获取 `user_id`，再翻页
+
+### ID 提取
+
+```
+screen_name：https://twitter.com/{screen_name}
+             https://x.com/{screen_name}
+```
+
+---
+
+## 批量翻页通用模板
+
+```python
+async def fetch_all_pages(endpoint, base_params, cursor_key="cursor", data_key="list"):
+    """通用翻页抓取"""
+    all_items = []
+    cursor = None
+    while True:
+        params = {**base_params}
+        if cursor:
+            params[cursor_key] = cursor
+        result = await api_get(endpoint, params)
+        inner = result.get("data", {}).get("data", {})
+        items = inner.get(data_key, [])
+        all_items.extend(items)
+        has_more = inner.get("has_more", False)
+        cursor = inner.get(cursor_key)
+        if not has_more or not cursor:
+            break
+        await asyncio.sleep(0.5)
+    return all_items
+```
+
+> ⚠️ cursor_key 差异：小红书/TikTok/Twitter 用 `cursor`，抖音用 `max_cursor`，Bilibili/微博用 `page`（数字递增）
+
+---
+
+## 常见问题
+
+| 报错 | 可能原因 | 解决方法 |
+|------|---------|---------|
+| `400` | 端点需要额外参数或内容已删除 | 换分享链接方式，或换 v2/v3 备用端点 |
+| `401` | API Key 未配置 | 检查 `TIKHUB_API_KEY` 环境变量 |
+| `429` | 限流 | 每次请求间加 `await asyncio.sleep(0.5~1)` |
+| 超时 | VPN/代理冲突 | 切换 VPN 状态，`api.tikhub.io` 可能需要直连 |
+
+## API 基础信息
+
+- **Base URL**: `https://api.tikhub.io`（国内备用：`https://api.tikhub.dev`）
+- **鉴权**: `Authorization: Bearer {TIKHUB_API_KEY}`
+- **定价**: $0.001/次，详见 [TikHub Pricing](https://user.tikhub.io/dashboard/pricing)
+- **缓存**: 成功请求缓存 24 小时，重复请求不额外计费