---
name: content-search
description: 通过 API 快速搜索指定内容平台（可选择小红书/B站/知乎/GitHub/YouTube/X 等）的帖子和视频，返回结构化数据。无需打开浏览器、无需处理登录/反爬问题，但有时不稳定。需要深度交互或访问API不支持的平台或功能时，请改用浏览器工具。
---

# Content Search

跨 11 个平台搜索内容，支持 小红书/公众号/视频号/GitHub/头条/抖音/B站/知乎/微博/YouTube/X。

## 前置

需要 `cyber-agent` 包已 editable install（`pip install -e /path/to/Agent`）。
本 skill 通过 `-m` 形式调用模块，从任意 CWD 都能跑。

## 用法

```bash
# 查看所有平台
python -m agent.tools.builtin.content.tools platforms

# 查看指定平台的参数（支持模糊匹配：ID/中文名/别名）
python -m agent.tools.builtin.content.tools platforms --platform=小红书

# 搜索
python -m agent.tools.builtin.content.tools search --platform=xhs --keyword=胶片摄影
python -m agent.tools.builtin.content.tools search --platform=youtube --keyword=Claude

# 查看详情（index 来自搜索结果）
python -m agent.tools.builtin.content.tools detail --platform=xhs --index=3

# 搜索建议词（仅 xhs/toutiao/douyin/bili/zhihu）
python -m agent.tools.builtin.content.tools suggest --platform=xhs --keyword=摄影
```

## 平台专属参数

通过 `--extras` 传 JSON，如小红书筛选：

```bash
python -m agent.tools.builtin.content.tools search \
  --platform=xhs --keyword=摄影 --extras='{"sort_type":"最新发布","publish_time":"近7天"}'
```

不确定参数时先 `platforms --platform=<name>` 查看。

## trace_id

同一 session 内 search → detail 需共享 trace_id（detail 从磁盘缓存取数据）：

```bash
export TRACE_ID=my-session
python -m agent.tools.builtin.content.tools search --platform=github --keyword=agent
python -m agent.tools.builtin.content.tools detail --platform=github --index=1
```

## 注意

- 磁盘缓存（用于 search → detail 复用）默认落在运行时的临时目录，由 cyber-agent 内部管理
- 为什么不像 toolhub 那样把脚本复制过来：content-search 是 8 个文件的子包（tools.py + registry.py + cache.py + 3 个 platform 模块 + 图片工具），复制出去维护成本高，所以保留 `-m` 形式依赖 editable install
