$npx -y skills add SpaceZephyr/creator-buddy --skill global-content-search全域内容搜索|当提到小红书/B站/抖音关键词搜索、笔记/视频详情、评论、博主/UP主作品监控时使用。优先基于 Agent Reach / OpenCLI / bili-cli / 公开只读接口访问;Agent Reach 不可用时,小红书可用 Guaikei API 作为最后兜底。
| 1 | # 全域内容搜索 |
| 2 | |
| 3 | > 一句话价值主张:先用 Agent Reach 搜全网内容,搜不到再用 Guaikei API 兜底,把小红书、B站和可扩展的抖音内容搜索统一到一套 CLI。 |
| 4 | |
| 5 | ## 1. 技能概述 |
| 6 | |
| 7 | 这个 Skill 的访问顺序是: |
| 8 | |
| 9 | 1. 优先使用 Agent Reach 生态中的只读后端 |
| 10 | 2. Agent Reach 没有可用小红书后端时,再尝试 Guaikei API 兜底 |
| 11 | 3. 如果没有配置 `GUAIKEI_API_TOKEN`,则提示用户配置,而不是直接失败成未知错误 |
| 12 | |
| 13 | 当前后端: |
| 14 | |
| 15 | - 小红书:`opencli xiaohongshu`、`xiaohongshu-mcp` 或 `xhs-cli` |
| 16 | - 小红书兜底:`GUAIKEI_API_TOKEN` |
| 17 | - B站:`bili-cli`、`opencli bilibili` 或 B站公开搜索/详情 API |
| 18 | - 抖音:Agent Reach 当前未内置 channel,预留 `DOUYIN_COMMAND` 自定义只读 CLI 适配 |
| 19 | |
| 20 | ## 2. 核心能力 |
| 21 | |
| 22 | | 使用场景 | 具体价值 | |
| 23 | | --- | --- | |
| 24 | | 内容创作选题 | 输入关键词,跨平台搜索热门内容,快速找到选题方向 | |
| 25 | | 竞品监控 | 输入创作者主页链接,查看公开作品与内容方向 | |
| 26 | | 评论/详情分析 | 读取笔记或视频详情,必要时抓取评论 | |
| 27 | | 趋势洞察 | 用同一个命令比较小红书、B站、抖音的内容分布 | |
| 28 | |
| 29 | ## 3. 快速使用 |
| 30 | |
| 31 | ### 3.1 小红书关键词搜索 |
| 32 | |
| 33 | ```bash |
| 34 | node src/xiaohongshu/search-cli.js --platform xiaohongshu --keyword "夏季穿搭" --limit 10 |
| 35 | ``` |
| 36 | |
| 37 | ### 3.2 小红书笔记详情及评论 |
| 38 | |
| 39 | ```bash |
| 40 | node src/xiaohongshu/detail-cli.js \ |
| 41 | --platform xiaohongshu \ |
| 42 | --url "https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy" \ |
| 43 | --limit 100 |
| 44 | ``` |
| 45 | |
| 46 | ### 3.3 小红书博主作品 |
| 47 | |
| 48 | ```bash |
| 49 | node src/xiaohongshu/post-cli.js \ |
| 50 | --platform xiaohongshu \ |
| 51 | --url "https://www.xiaohongshu.com/user/profile/xxx?xsec_token=yyy" \ |
| 52 | --limit 20 |
| 53 | ``` |
| 54 | |
| 55 | ### 3.4 B站搜索与视频详情 |
| 56 | |
| 57 | ```bash |
| 58 | node src/xiaohongshu/search-cli.js --platform bilibili --keyword "AI编程" --limit 10 |
| 59 | node src/xiaohongshu/detail-cli.js --platform bilibili --url "BVxxxx" |
| 60 | ``` |
| 61 | |
| 62 | ### 3.5 抖音扩展入口 |
| 63 | |
| 64 | Agent Reach 当前版本没有抖音 channel。若你有本地只读 CLI,可以这样接入: |
| 65 | |
| 66 | ```bash |
| 67 | export DOUYIN_COMMAND="/path/to/douyin-readonly-cli" |
| 68 | node src/xiaohongshu/search-cli.js --platform douyin --keyword "AI工具" |
| 69 | ``` |
| 70 | |
| 71 | 该 CLI 需支持: |
| 72 | |
| 73 | ```bash |
| 74 | $DOUYIN_COMMAND search <keyword> --limit <n> |
| 75 | $DOUYIN_COMMAND detail <url-or-id> |
| 76 | $DOUYIN_COMMAND user <user-url-or-id> --limit <n> |
| 77 | ``` |
| 78 | |
| 79 | ## 4. 后端检查 |
| 80 | |
| 81 | 使用前建议运行: |
| 82 | |
| 83 | ```bash |
| 84 | agent-reach doctor --json |
| 85 | ``` |
| 86 | |
| 87 | 如果小红书显示 `active_backend: null`,工具会继续检查 `GUAIKEI_API_TOKEN`: |
| 88 | |
| 89 | ```bash |
| 90 | export GUAIKEI_API_TOKEN="your_api_token_here" |
| 91 | ``` |
| 92 | |
| 93 | 配置后,小红书搜索、详情和博主作品会走 Guaikei API 兜底。 |
| 94 | |
| 95 | ## 5. 重要限制 |
| 96 | |
| 97 | - 本工具只读公开数据,不支持发帖、评论、点赞等写操作。 |
| 98 | - 小红书受 `xsec_token` 机制限制,详情页建议使用搜索结果返回的完整 URL。 |
| 99 | - Guaikei API 只作为小红书兜底,不会替代 B站或抖音后端。 |
| 100 | - B站公开 API 不保证所有详情字段稳定;安装 `bili-cli` 后能力更完整。 |
| 101 | - 抖音当前是扩展位,不随仓库内置可用后端。 |
| 102 | - 所有任务结果会自动保存到 `logs/`,该目录默认不提交。 |
| 103 | |
| 104 | 更多选项见 [完整选项说明](references/options.md)。 |