YouTube Reader

YouTube リーダー

YouTube 動画をテキストに変換します。動画を見られない AI エージェント向けです。

動画リンクを渡すと、タイトル、チャンネル名、タイムスタンプ付きの音声全文の文字起こしが返されます。1 回の呼び出しで、整った 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

ツールは 1 つです：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. Railway の URL で API を利用できます：POST https://<your-app>.up.railway.app/read

料金

• メタデータ（タイトル／チャンネル名）：無料
• MCP 経由の文字起こし（youtube_reader ツール）：x402 経由で Base 上の USDC にて、呼び出し 1 回あたり $0.02。登録も API キーも不要です。PAYMENTS.md を参照してください。
• HTTP API 直接利用（POST /read）：ベータ期間中は無料
• ヘビーユーザー向け：月額 $19 のプランを予定（Stripe、フェーズ 2）

収益化（MCPize）

呼び出しごとの料金は、mcpize.yaml と MCPize ダッシュボード（Payments タブ）で設定します。セットアップ手順、ウォレットの利用方法、テストネットの手順、注意事項については、PAYMENTS.md を参照してください。