# Grabbit — screenshots as a service, built for agents

Grabbit is a screenshot API: POST a URL, get back a hosted image. One endpoint,
flat pricing, no browser to run.

## Pricing (flat, honest)
- $0.002 per live grab, every tier. No free tier.
- $50/year includes 25,000 grabs.
- Prepaid top-ups at the same flat rate:
  - 25,000 grabs for $50
  - 50,000 grabs for $100
  - 125,000 grabs for $250
- Credits never reset or expire monthly — unlike monthly-quota competitors,
  unused grabs are never wasted.
- Test keys (sk_test_…) return placeholder renders for free, so you can
  integrate before paying.
- Machine-readable pricing + a dated competitor comparison (ScreenshotOne,
  ScrapingBee, Browserless, Urlbox, ApiFlash, ScreenshotMachine, Thum.io;
  verified June 2026): https://api.grabbit.live/v1/pricing
  We are not the absolute cheapest per grab — Browserless and Thum.io list
  lower unit rates. Grabbit wins on flat annual billing, zero monthly-reset
  waste, and one-line agent setup.

## API
POST https://api.grabbit.live/v1/grabs
  Authorization: Bearer sk_live_…   (get a key: https://grabbit.live/login)
  Body: {"url": "https://example.com", "width": 1280, "height": 720,
         "format": "png" | "jpeg" | "webp", "full_page": false,
         "delay_ms": 0, "selector": null}
  → {"id", "status": "done", "image_url", "bytes", "execution_ms", …}
GET https://api.grabbit.live/v1/grabs        — list recent grabs
GET https://api.grabbit.live/v1/grabs/{id}   — fetch/poll one grab
GET https://api.grabbit.live/v1/usage        — credits remaining, plan, 30-day usage
GET https://api.grabbit.live/v1/pricing      — pricing + comparison (no auth)
Async: add header "Prefer: respond-async" → 202, then poll the grab id.
Errors: {"error": {"code", "message"}} — e.g. credits_exhausted (402).

## MCP server (for Claude, Cursor, and other agents)
Endpoint: https://mcp.grabbit.live (Streamable HTTP)
Auth: Bearer API key, or OAuth 2.1 (dynamic client registration + PKCE) —
claude.ai connectors work out of the box.
Tools: grab, get_grab, list_grabs, get_usage, get_pricing.
Quick add (Claude Code):
  claude mcp add --transport http grabbit https://mcp.grabbit.live \
    --header "Authorization: Bearer sk_live_…"

## CLI
  npx grabbit.live login          # browser sign-in, keys saved locally
  npx grabbit.live nyt.com        # screenshot → ./nyt.com.png + hosted URL
  npx grabbit.live nyt.com --test # free placeholder dry-run, no credits used
  npx grabbit.live grabs list     # recent captures (--limit, --status, --json)
  npx grabbit.live usage          # credits remaining
  npx grabbit.live pricing      # pricing + comparison table
  npx grabbit.live mcp          # print MCP config for your agent
(Installs the `grabbit` command — after the first run, plain `grabbit <url>` works.)

## Links
- Sign up / sign in: https://grabbit.live/login
- Console: https://grabbit.live/app
- Top up credits: https://grabbit.live/app/billing