Skip to content

Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.

docs(skill): add upstream caveats for Reddit, B站, YouTube

Pnant04fd64596691
diff --git a/agent_reach/skill/references/social.md b/agent_reach/skill/references/social.md
index 25009d51..82673208 100644
--- a/agent_reach/skill/references/social.md
+++ b/agent_reach/skill/references/social.md
@@ -183,4 +183,6 @@ rdt popular --limit 10
rdt all --limit 10
```
-> **安装**: `pipx install rdt-cli`。无需登录即可搜索和阅读。
+> **安装**: `pipx install rdt-cli`(确保 v0.4.2+)。无需登录即可搜索和阅读。
+> 需要登录的功能:`rdt feed --subs-only`(订阅列表)、`rdt saved`(收藏)。
+> 建议使用 `--yaml` 输出,对 AI agent 更友好。
diff --git a/agent_reach/skill/references/video.md b/agent_reach/skill/references/video.md
index c79c71e8..7ce12b4d 100644
--- a/agent_reach/skill/references/video.md
+++ b/agent_reach/skill/references/video.md
@@ -20,27 +20,54 @@ yt-dlp --write-sub --write-auto-sub --sub-lang "zh-Hans,zh,en" --skip-download -
cat /tmp/VIDEO_ID.*.vtt
```
+### 获取评论
+
+```bash
+# 提取评论(best-effort,不保证完整)
+yt-dlp --write-comments --skip-download --write-info-json \
+ --extractor-args "youtube:max_comments=20" \
+ -o "/tmp/%(id)s" "URL"
+# 评论在 .info.json 的 comments 字段中
+```
+
### 搜索视频
```bash
yt-dlp --dump-json "ytsearch5:query"
```
-## B站 / Bilibili (yt-dlp)
+> **字幕注意**: 手动上传的字幕提取可靠;自动生成字幕可能存在行间重复,需后处理。
+> **评论注意**: `--write-comments` 基于网页抓取(非 YouTube Data API),部分评论可能丢失。
-### 获取视频元数据
+## B站 / Bilibili (yt-dlp + bili-cli)
+
+### 视频元数据 (yt-dlp)
```bash
yt-dlp --dump-json "https://www.bilibili.com/video/BVxxx"
```
-### 下载字幕
+### 字幕 (yt-dlp)
```bash
yt-dlp --write-sub --write-auto-sub --sub-lang "zh-Hans,zh,en" --convert-subs vtt --skip-download -o "/tmp/%(id)s" "URL"
```
-> **注意**: 服务器 IP 可能遇到 412 错误。使用 `--cookies-from-browser chrome` 或配置代理。
+### 搜索/热门/排行 (bili-cli)
+
+```bash
+# 搜索视频
+bili search "query" --type video -n 5
+
+# 热门视频
+bili hot -n 10
+
+# 排行榜
+bili rank -n 10
+```
+
+> **412 风控**: 海外 IP 必须提供 Cookie(`--cookies-from-browser chrome` 或 `--cookies /path/to/cookies.txt`),国内 IP 一般不受影响。
+> **安装 bili-cli**: `pipx install bilibili-cli`,然后 `bili login` 扫码登录。
## 小宇宙播客 / Xiaoyuzhou Podcast