YouTube Reader

YouTube Reader

将任意 YouTube 视频转换为文本。适用于无法观看视频的 AI Agent。

提供视频链接，即可获取标题、频道和带时间戳的完整口述文字稿。一次调用，返回整洁的 JSON。无需 API 密钥。

快速示例

你发送：

POST /read
{ "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }

你获取：

{
  "video_id": "dQw4w9WgXcQ",
  "title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)",
  "channel": "Rick Astley",
  "channel_url": "https://www.youtube.com/@RickAstleyYT",
  "thumbnail": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
  "transcript_available": true,
  "language": "English",
  "segment_count": 61,
  "duration_seconds": 213,
  "full_text": "We're no strangers to love...",
  "segments": [
    { "start": 18.5, "text": "We're no strangers to love" },
    { "start": 22.1, "text": "You know the rules and so do I" }
  ]
}

运行

python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/python server.py        # http://127.0.0.1:8081

• 使用 POST /read 并传入 {"url": "<youtube link>"} → 完整报告（JSON）
• GET /health → {"ok": true}

支持 watch?v=、youtu.be/、/shorts/、/embed/、/live/ 链接以及裸视频 ID。

用作 MCP 服务（Claude Desktop、Cursor、Windsurf……）

.venv/bin/pip install fastmcp
.venv/bin/python mcp_server.py

提供一个工具：youtube_reader(url) — 返回与 HTTP API 相同的报告。

字幕文字稿的获取方式（按顺序）

1. youtube-transcript-api — 直接获取，免费
2. Invidious 实例 — 备用方案，免费

已知限制：YouTube 会限制来自数据中心 IP 的自动请求，因此从云服务获取字幕文字稿可能会间歇性失败。元数据（通过官方 oEmbed 获取的标题/频道）不受影响。专业解决方案：将住宅代理作为第 3 步（每 1,000 份文字稿约 $3）。

部署（Railway 免费套餐）

1. 将此文件夹推送到 GitHub
2. 前往 https://railway.app → New Project → Deploy from repo
3. 它会自动读取 requirements.txt + Procfile。完成。
4. 你的 API 将通过 Railway URL 上线：POST https://<your-app>.up.railway.app/read

定价

• 元数据（标题/频道）：免费
• 通过 MCP 获取文字稿（youtube_reader 工具）：每次调用 $0.02，通过 x402 在 Base 上以 USDC 付款 — 无需注册，无需 API 密钥。请参阅 PAYMENTS.md。
• 普通 HTTP API（POST /read）：测试阶段免费
• 高频用户：计划推出 $19/月套餐（Stripe，第二阶段）

盈利方式（MCPize）

按次定价在 mcpize.yaml 和 MCPize 控制面板（Payments 标签页）中配置。完整设置指南、钱包说明、测试网流程及注意事项请参阅 PAYMENTS.md。