Fastdown
한국어한

문서

명령 하나로 영상 분석을 에이전트에

설치부터 로그인, 에이전트 호출까지 모든 명령을 한 페이지에. 실제 분석 응답도 함께.

명령 모음
  • 명령 하나로 연결
  • Google OAuth 로그인
  • 하루 50회 무료
01

설치

블록 전체를 Codex, Claude Code, Open Code 또는 터미널 명령을 실행할 수 있는 코딩 에이전트에 붙여넣으세요. CLI를 설치하고 연결 키를 저장하며, 감지된 모든 에이전트에 MCP 서버를 등록합니다.

Codex / Claude Code / Open Code에 붙여넣기
Agent: install Fastdown in this environment and connect its MCP tools.
You can run this from Codex, Claude Code, Open Code, or another terminal-based coding agent.
Replace <connect-key> with the key from https://fastdown.pro/account, then run the command below.
Restart the agent app if it was already open, then use `download_video` for public share links.

curl -fsSL 'https://fastdown.pro/mcp?key=<connect-key>' | sh

CLI만 설치, 에이전트 연결 없음

bash
curl -fsSL https://fastdown.pro/cli | sh -s -- --agent auto
예제 코드 · GitHub

에이전트 앱이 이미 열려 있었다면 다시 실행한 뒤, 공개 공유 링크를 붙여넣고 동영상을 받게 하세요.

02

로그인과 할당량

웹 로그인과 CLI는 같은 계정을 공유합니다. 브라우저가 없는 서버에서는 이메일 코드나 연결 키를 사용하세요.

quota
$ fast-download quota --json
{
  "quota": { "plan_id": "free", "used": 12, "daily_limit": 50, "remaining": 38 }
}

할당량은 성공한 분석만 세며, 웹 앱과 같은 시각에 초기화됩니다.

03

명령 모음

로그인, 할당량, 분석, 다운로드, MCP 서버를 바이너리 하나로. 모든 명령이 --json을 지원합니다.

fast-download auth login로그인
fast-download quota --json할당량 확인
fast-download parse "<share link>" --json공개 링크 분석
fast-download download "<share link>" --output ./downloads분석 후 로컬 저장
fast-download setup agent --auto에이전트 설정 기록
fast-download mcp --stdioMCP 서버 실행
04

분석 예시

분석 한 번이면 아래 정규화 구조가 돌아옵니다. 플랫폼, 제목, 작성자, 미디어 링크, 남은 할당량. 미디어는 저희 서버를 거치지 않습니다.

입력
fast-download parse \
  "https://www.tiktok.com/@aespa_official/video/7614804615174917396" \
  --json
결과
플랫폼tiktok
결과동영상 + 오디오 링크
저장분석 로그만 저장, 미디어 전송 없음
종료 코드할당량 초과 시 종료 코드 5
정규화된 응답
{
  "ok": true,
  "data": {
    "platform": "tiktok",
    "title": "@aespa_official video",
    "author": "aespa_official",
    "media": [
      { "type": "video", "url": "https://...", "watermark": false, "quality": "hd" },
      { "type": "audio", "url": "https://...", "watermark": false }
    ],
    "quota": { "plan_id": "free", "used": 12, "daily_limit": 50, "remaining": 38 }
  }
}
05

MCP 도구

도구는 세 개뿐이며 전체 기능을 담당합니다. 에이전트가 의도에 맞게 고르고 구조화된 결과를 받습니다.

parse_video

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

url · media_type

download_video

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

url · output · name

quota

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

—

설치 스크립트가 자동으로 등록합니다. 사용하지 않았다면 fast-download setup agent --auto를 실행하거나 연동 페이지의 stdio 설정을 붙여넣으세요.