가이드 및 튜토리얼

각 연동 방식에 대한 단계별 설정.

Quick Start

첫 스크립트까지 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.