Docs

Wire an agent to video parsing in one command

Install, sign in and call the parser from an agent — the whole command surface on one page, plus a real parse response.

Command cheat sheet
  • One command
  • Google OAuth
  • 50 free parses a day
01

Install

Paste the whole block into Codex, Claude Code, Open Code or any coding agent that can run terminal commands. It installs the CLI, stores the connect key and registers the MCP server with every agent it finds.

Paste into 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 only, no agent wiring

bash
curl -fsSL https://fastdown.pro/cli | sh -s -- --agent auto
Example code on GitHub

Restart the agent app if it was already open, then paste a public share link and ask for the video.

02

Sign in and quota

Web sign-in and the CLI share one account. On a server or a machine without a browser, use an email code or a connect key instead.

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

Quota counts successful parses only and resets on the same daily boundary as the web app.

03

Commands

One binary covers login, quota, parsing, downloading and the MCP server. Every command accepts --json.

fast-download auth loginSign in
fast-download quota --jsonCheck quota
fast-download parse "<share link>" --jsonParse a public link
fast-download download "<share link>" --output ./downloadsParse and save locally
fast-download setup agent --autoWrite agent config
fast-download mcp --stdioRun the MCP server
04

Parse example

One parse call returns the normalized shape below: platform, title, author, media URLs and the quota left. Media never passes through our servers.

Input
fast-download parse \
  "https://www.tiktok.com/@aespa_official/video/7614804615174917396" \
  --json
Result
Platformtiktok
Resultvideo + audio media URLs
Storageparse log only, no media transfer
Exitquota exceeded uses exit code 5
normalized response
{
  "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 tools

Three tools cover the whole surface. The agent picks one by intent and gets structured content back.

parse_video

Normalized media[] JSON. No bytes leave the upstream CDN, so it is cheap and fast.

url · media_type

download_video

Parses and saves the best playable file into ./downloads, then prints the path.

url · output · name

quota

Remaining, limit and reset time for today, so the agent can stop before it burns the day.

—

The installer registers these tools automatically. Without it, run fast-download setup agent --auto, or paste the stdio config from the integrations page.