Feature Video

Feature: Video

事实来源：主仓 pr-88 @ a312645 的 src/souwen/video/、CLI 子命令 youtube/bilibili。

SouWen 内置两个视频平台：YouTube（官方 API）+ Bilibili（爬虫 + 可选登录态）。

---

1. 能力对比

能力	YouTube	Bilibili
search	✓（API）	✓（爬虫）
get_detail	✓	✓
get_trending	✓（按地区/分类）	—
get_transcript	✓（零配额，页面抓取）	—
search_users	—	✓
search_articles	—	✓（专栏）

---

2. 配置

youtube_api_key: AIzaSy-xxx        # 必需，10K 单位/日配额
bilibili_sessdata: ""              # 可选，启用登录态

详见 Config API Keys#2.4-视频。

---

3. CLI

# YouTube
souwen youtube trending --region US --max 20
souwen youtube video <video_id>
souwen youtube transcript <video_id> --lang en        # 零配额

# Bilibili
souwen bilibili search "编程" --max 20 --order pubdate
souwen bilibili video BV1xx411c7m9
souwen bilibili search-users "雷军"
souwen bilibili search-articles "AI"

order ∈ totalrank / click / pubdate / dm / stow。

---

4. HTTP API

curl "http://localhost:8000/api/v1/youtube/trending?region=US&max_results=20"
curl "http://localhost:8000/api/v1/youtube/video/dQw4w9WgXcQ"
curl "http://localhost:8000/api/v1/youtube/transcript/dQw4w9WgXcQ?lang=en"

curl "http://localhost:8000/api/v1/bilibili/video/BV1xx411c7m9"
curl "http://localhost:8000/api/v1/bilibili/search?keyword=编程&max_results=20&order=pubdate"

---

5. 错误码（Bilibili）

HTTP	异常	含义
401	BilibiliAuthRequired	接口需要 SESSDATA
403	BilibiliRiskControl	触发风控
404	BilibiliNotFound	资源不存在
429	BilibiliRateLimited	限流
502	BilibiliError	其他错误

YouTube 缺 youtube_api_key 时返 503。

---

6. 接下来

• Sources/视频
• Source-youtube · Source-bilibili
• HTTP API#5-多媒体端点