Para assistentes e scripts

Chame o GrabGrab de um assistente

A mesma API atende o site, a extensão do Chrome, scripts e ferramentas de IA. X e Twitter vêm primeiro. Vídeos públicos do TikTok, Vimeo e Facebook usam o mesmo pedido. O YouTube é recusado antes de qualquer download.

curl

Envie uma URL pública com POST. videoQuality pode ser max, 2160, 1440, 1080, 720, 480 ou 360. O segundo trecho salva a URL do arquivo que veio no JSON. Um script não deve enviar um token do Turnstile.

curl -s -X POST "https://www.grabgrab.fun/api/download" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://x.com/X/status/1697304622749086011","videoQuality":"1080"}'

curl -L -o video.mp4 "PASTE_THE_URL_FROM_THE_JSON"

MCP

Claude Desktop, Cursor e outros clientes MCP podem usar o endpoint sem estado https://www.grabgrab.fun/api/mcp. A ferramenta é download_video, com url e quality opcional. Ela usa a mesma lista e o mesmo limite da API HTTP. Cole esta configuração e reinicie o cliente.

{
  "mcpServers": {
    "grabgrab": {
      "url": "https://www.grabgrab.fun/api/mcp"
    }
  }
}

CLI

Um cliente Node pequeno está em packages/cli no repositório e ainda não foi publicado no npm. Ele imprime o JSON e não adiciona uma chave. Em uma cópia do repo, rode o comando abaixo.

node packages/cli/bin/grabgrab.mjs "https://x.com/X/status/1697304622749086011" 1080

Skill do ClawHub

Os arquivos do skill ficam em skills/grabgrab e descrevem o mesmo fluxo, com X em primeiro lugar, MCP e curl. A página pública do ClawHub muda só quando o dono publica a versão 1.2.0. O assistente não deve inventar uma chave.

Limites

O navegador em grabgrab.fun completa a verificação humana quando o Turnstile está ativo. Scripts, clientes MCP e a extensão não enviam esse token, então usam o limite menor da API, cerca de 6 pedidos a cada 10 minutos por IP em cada instância. Posts privados ou apagados falham. O YouTube devolve youtube_not_supported.