# Global Content Search

> 全域内容搜索｜当提到小红书/B站/抖音关键词搜索、笔记/视频详情、评论、博主/UP主作品监控时使用。优先基于 Agent Reach / OpenCLI / bili-cli / 公开只读接口访问；Agent Reach 不可用时，小红书可用 Guaikei API 作为最后兜底。

- Skill: `spacezephyr/global-content-search` (Agent Skill, multi-file: 21 files)
- Install (CLI): `npx skillmds@latest add spacezephyr/global-content-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/spacezephyr/global-content-search/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: MIT
- Author: spacezephyr (https://skillmd.com/u/spacezephyr)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/spacezephyr/global-content-search

---


# 全域内容搜索

> 一句话价值主张：先用 Agent Reach 搜全网内容，搜不到再用 Guaikei API 兜底，把小红书、B站和可扩展的抖音内容搜索统一到一套 CLI。

## 1. 技能概述

这个 Skill 的访问顺序是：

1. 优先使用 Agent Reach 生态中的只读后端
2. Agent Reach 没有可用小红书后端时，再尝试 Guaikei API 兜底
3. 如果没有配置 `GUAIKEI_API_TOKEN`，则提示用户配置，而不是直接失败成未知错误

当前后端：

- 小红书：`opencli xiaohongshu`、`xiaohongshu-mcp` 或 `xhs-cli`
- 小红书兜底：`GUAIKEI_API_TOKEN`
- B站：`bili-cli`、`opencli bilibili` 或 B站公开搜索/详情 API
- 抖音：Agent Reach 当前未内置 channel，预留 `DOUYIN_COMMAND` 自定义只读 CLI 适配

## 2. 核心能力

| 使用场景 | 具体价值 |
| --- | --- |
| 内容创作选题 | 输入关键词，跨平台搜索热门内容，快速找到选题方向 |
| 竞品监控 | 输入创作者主页链接，查看公开作品与内容方向 |
| 评论/详情分析 | 读取笔记或视频详情，必要时抓取评论 |
| 趋势洞察 | 用同一个命令比较小红书、B站、抖音的内容分布 |

## 3. 快速使用

### 3.1 小红书关键词搜索

```bash
node src/xiaohongshu/search-cli.js --platform xiaohongshu --keyword "夏季穿搭" --limit 10
```

### 3.2 小红书笔记详情及评论

```bash
node src/xiaohongshu/detail-cli.js \
  --platform xiaohongshu \
  --url "https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy" \
  --limit 100
```

### 3.3 小红书博主作品

```bash
node src/xiaohongshu/post-cli.js \
  --platform xiaohongshu \
  --url "https://www.xiaohongshu.com/user/profile/xxx?xsec_token=yyy" \
  --limit 20
```

### 3.4 B站搜索与视频详情

```bash
node src/xiaohongshu/search-cli.js --platform bilibili --keyword "AI编程" --limit 10
node src/xiaohongshu/detail-cli.js --platform bilibili --url "BVxxxx"
```

### 3.5 抖音扩展入口

Agent Reach 当前版本没有抖音 channel。若你有本地只读 CLI，可以这样接入：

```bash
export DOUYIN_COMMAND="/path/to/douyin-readonly-cli"
node src/xiaohongshu/search-cli.js --platform douyin --keyword "AI工具"
```

该 CLI 需支持：

```bash
$DOUYIN_COMMAND search <keyword> --limit <n>
$DOUYIN_COMMAND detail <url-or-id>
$DOUYIN_COMMAND user <user-url-or-id> --limit <n>
```

## 4. 后端检查

使用前建议运行：

```bash
agent-reach doctor --json
```

如果小红书显示 `active_backend: null`，工具会继续检查 `GUAIKEI_API_TOKEN`：

```bash
export GUAIKEI_API_TOKEN="your_api_token_here"
```

配置后，小红书搜索、详情和博主作品会走 Guaikei API 兜底。

## 5. 重要限制

- 本工具只读公开数据，不支持发帖、评论、点赞等写操作。
- 小红书受 `xsec_token` 机制限制，详情页建议使用搜索结果返回的完整 URL。
- Guaikei API 只作为小红书兜底，不会替代 B站或抖音后端。
- B站公开 API 不保证所有详情字段稳定；安装 `bili-cli` 后能力更完整。
- 抖音当前是扩展位，不随仓库内置可用后端。
- 所有任务结果会自动保存到 `logs/`，该目录默认不提交。

更多选项见 [完整选项说明](references/options.md)。