API, CLI y MCP

claude mcp add --transport http kliplot https://www.kliplot.com/api/mcp \
  --header "Authorization: Bearer dk_live_YOUR_KEY"

{
  "mcpServers": {
    "kliplot": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://www.kliplot.com/api/mcp",
        "--header", "Authorization:${KLIPLOT_AUTH}"
      ],
      "env": { "KLIPLOT_AUTH": "Bearer dk_live_YOUR_KEY" }
    }
  }
}

{
  "mcpServers": {
    "kliplot": {
      "url": "https://www.kliplot.com/api/mcp",
      "headers": { "Authorization": "Bearer dk_live_YOUR_KEY" }
    }
  }
}

{
  "servers": {
    "kliplot": {
      "type": "http",
      "url": "https://www.kliplot.com/api/mcp",
      "headers": { "Authorization": "Bearer ${input:kliplot-key}" }
    }
  },
  "inputs": [
    { "type": "promptString", "id": "kliplot-key", "description": "Kliplot API key", "password": true }
  ]
}

npx kliplot login dk_live_YOUR_KEY

# Extract + download into ./media
npx kliplot dl https://www.instagram.com/reel/XXXX/ https://x.com/user/status/123 -o ./media

# One link per line ("-" reads stdin)
npx kliplot dl -f links.txt

# Only print links as JSON (scripts, pipelines)
npx kliplot dl https://www.tiktok.com/@user/video/1 --no-download --json

npx kliplot status <batch-id>
npx kliplot batches
npx kliplot usage

curl -X POST https://www.kliplot.com/api/v1/batches \
  -H "Authorization: Bearer $KLIPLOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.instagram.com/reel/XXXX/","https://x.com/user/status/123"]}'

curl https://www.kliplot.com/api/v1/batches/<batch-id> \
  -H "Authorization: Bearer $KLIPLOT_API_KEY"

{
  "batch": {
    "id": "7717dd86-97c9-40bc-88a9-d37287d9e061",
    "status": "done",            // queued | running | done | partial | failed
    "total": 2, "done": 2, "failed": 0,
    "items": [
      {
        "url": "https://x.com/user/status/123",
        "status": "done",           // queued | processing | done | failed
        "error": null,
        "files": [
          {
            "type": "video",
            "filename": "123.mp4",
            "download_url": "https://www.kliplot.com/api/dl/…"   // valid 24 hours
          }
        ]
      }
    ]
  }
}

curl https://www.kliplot.com/api/v1/usage -H "Authorization: Bearer $KLIPLOT_API_KEY"

const res = await fetch("https://www.kliplot.com/api/v1/batches", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.KLIPLOT_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ urls: ["https://www.tiktok.com/@user/video/1"] }),
})
let { batch } = await res.json()

while (batch.status === "queued" || batch.status === "running") {
  await new Promise((r) => setTimeout(r, 1500))
  batch = (await (await fetch(`https://www.kliplot.com/api/v1/batches/${batch.id}`, {
    headers: { Authorization: `Bearer ${process.env.KLIPLOT_API_KEY}` },
  })).json()).batch
}

for (const item of batch.items) {
  for (const file of item.files) console.log(file.filename, file.download_url)
}

import os, time, requests

API = "https://www.kliplot.com/api/v1"
H = {"Authorization": f"Bearer {os.environ['KLIPLOT_API_KEY']}"}

batch = requests.post(f"{API}/batches", headers=H,
                      json={"urls": ["https://www.pinterest.com/pin/123/"]}).json()["batch"]

while batch["status"] in ("queued", "running"):
    time.sleep(1.5)
    batch = requests.get(f"{API}/batches/{batch['id']}", headers=H).json()["batch"]

for item in batch["items"]:
    for f in item["files"]:
        print(f["filename"], f["download_url"])