에이전트와 앱 연결하기

명령 하나로 Fastdown을 Codex, Claude Code, Cursor에 연결합니다. 같은 키를 백엔드에서 쓰면 파싱 결과·할당량·미디어 직링크를 REST로 받습니다.

MCP · stdio + HTTP
CLI · macOS / Linux / Windows
REST · /api/v1

API KEY

로그인하면 API 키를 만들고 기존 키를 확인할 수 있습니다.

로그인

STEP 01

명령 하나 붙여넣기

CLI를 설치하고 키를 저장한 뒤, 찾은 모든 에이전트 앱에 MCP 설정을 기록합니다.

STEP 02

에이전트 재시작

Codex, Claude Code, Cursor는 시작할 때만 MCP 설정을 읽습니다.

STEP 03

링크를 넘기기

“이 TikTok 링크를 ./downloads에 받아줘” — 에이전트가 도구를 호출하고 파일이 로컬에 저장됩니다.

mcp 연결

$curl -fsSL "https://fastdown.pro/mcp?key=$FASTDOWN_KEY" | sh

위 카드의 키를 FASTDOWN_KEY에 설정하세요. 스크립트가 CLI를 설치하고 fast-download setup agent --auto를 실행하며 auth login --key로 키를 저장합니다.

지원 클라이언트

CodexClaude CodeCursorVS CodeOpenCodeGemini CLIWindsurf

세 가지 MCP 도구

parse_video

정규화된 media[] JSON을 반환합니다. 미디어 바이트는 서버를 거치지 않아 빠르고 저렴합니다.

url · prefer.watermark

download_video

재생 가능한 최적 파일을 ./downloads에 저장하고 경로를 출력합니다.

url · output

quota

오늘의 잔여·한도·리셋 시각. 에이전트가 소진 전에 멈출 수 있습니다.

no arguments

직접 설정하려면

{
  "mcpServers": {
    "fastdown": {
      "command": "fast-download",
      "args": ["mcp", "--stdio"]
    }
  }
}

CLI로 스크립트하려면

터미널MCP 불필요

fast-download auth login
fast-download parse "<share url>" --json
fast-download download "<share url>" --output ./downloads
fast-download quota --json

AUTH

Bearer 키 하나

모든 호출은 위 카드의 키를 Authorization: Bearer로 전달합니다. 키는 계정 단위라 할당량과 결제도 계정을 따릅니다.

QUOTA

성공할 때만 차감

요금제별 하루 50 / 1,000 / 3,000회, UTC 00:00 리셋. 실패한 파싱은 차감되지 않고 429는 당일 소진을 뜻합니다.

요청POST /api/v1/parse

curl -X POST https://fastdown.pro/api/v1/parse \
  -H "authorization: Bearer $FASTDOWN_KEY" \
  -H "content-type: application/json" \
  -d '{"url":"https://www.tiktok.com/@aespa_official/video/7614804615174917396"}'

응답 200application/json

{
  "ok": true,
  "request_id": "req_8f2c41",
  "data": {
    "platform": "tiktok",
    "media": [{
      "type": "video",
      "url": "https://cdn.example/video.mp4",
      "watermark": false,
      "quality": "hd"
    }],
    "quota": { "used": 12, "limit": 1000 }
  }
}

엔드포인트

메서드	경로	역할
POST	`/api/v1/parse`	URL을 넣으면 media[]가 나옵니다. 핵심 엔드포인트.
GET	`/api/v1/quota`	오늘의 카운터. 에이전트가 보는 값과 같습니다.
GET	`/api/v1/me`	사용자, 요금제, 구독 상태.
GET	`/api/v1/health`	상태 확인용. 인증 없이 모니터링에 사용.
POST	`/api/v1/billing/checkout`	Pro / Max용 Stripe Checkout URL을 반환합니다.

처리해야 할 오류

400 INVALID_URL401 UNAUTHORIZED422 NO_MEDIA429 RATE_LIMITED503 UPSTREAM_ERROR

모든 플래그와 오류 코드가 필요하신가요? 문서에 전체 버전이 있으며 종료 코드와 OpenAPI 파일도 포함됩니다.

문서 열기 연결 키 받기