ガイド

各連携手法のステップバイステップ設定。

クイックスタート

最初の文字起こしまでの 3 ステップ：

1. サインアップ subdownload.com/account で 1,000 無料クレジットを取得。
2. コピー API キー（sk_live_ で始まる）を控える。
3. 呼び出し キーを Authorization ヘッダーに入れて API を呼ぶ。

curl -H "Authorization: Bearer sk_live_xxx" \
  "https://api.subdownload.com/v1/youtube/transcript?video_id=dQw4w9WgXcQ"

import requests

API_KEY = "sk_live_xxx"
BASE = "https://api.subdownload.com/v1"

r = requests.get(
    f"{BASE}/youtube/transcript",
    params={"video_id": "dQw4w9WgXcQ"},
    headers={"Authorization": f"Bearer {API_KEY}"},
)
r.raise_for_status()
data = r.json()
print(data["data"]["text"][:200])

const API_KEY = "sk_live_xxx";

const res = await fetch(
  "https://api.subdownload.com/v1/youtube/transcript?video_id=dQw4w9WgXcQ",
  { headers: { Authorization: "Bearer " + API_KEY } }
);
if (!res.ok) throw new Error("HTTP " + res.status);
const data = await res.json();
console.log(data.data.text.slice(0, 200));

// API キーをクライアントコードに直書きしないでください。
// 自前のバックエンドでプロキシしてください。
const res = await fetch("/api/my-proxy/transcript?video_id=dQw4w9WgXcQ");
const data = await res.json();
console.log(data);

認証

全 API リクエストは Authorization ヘッダーに Bearer トークンが必要です：

Authorization: Bearer sk_live_xxxxx

• • API キーの接頭辞は sk_live_。
• • 手動で取り消し・再生成しない限り失効しません。
• • 環境変数に保存 —— クライアントコードや公開リポジトリに置かない。
• • キー管理は subdownload.com/account。

キーの確認：GET /v1/verify（無料、クレジット消費なし）。

Claude（Desktop / Code）設定

Claude は OAuth + Dynamic Client Registration に対応 —— 事前にクレデンシャルを作る必要はありません。

{
  "mcpServers": {
    "subdownload": {
      "url": "https://api.subdownload.com/mcp"
    }
  }
}

Claude がブラウザを開いて認可します。トークンは自動更新されます。

または静的 API キーを使う（OAuth なし）：

{
  "mcpServers": {
    "subdownload": {
      "url": "https://api.subdownload.com/mcp",
      "headers": { "Authorization": "Bearer sk_live_xxx" }
    }
  }
}

ChatGPT（GPT Actions / Custom Connectors）

ChatGPT は 静的 OAuth クライアントを使います。手順：

1. アカウント → MCP / OAuth タブへ。
2. Client ID と Client Secret をコピー。
3. ChatGPT で新しい Connector / Action を追加：
   • MCP URL：https://api.subdownload.com/mcp
   • 認証：OAuth、Client ID と Secret を入力

OpenAI Agent Builder

API キーを認証方式（Bearer token）としてそのまま貼り付け。サーバー URL は https://api.subdownload.com/mcp。