Agent/skills4claude/content-search/SKILL.md

---

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 都能跑。

用法

# 查看所有平台
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，如小红书筛选：

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 从磁盘缓存取数据）：

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