SkillHub

snap

v1.0.2

Give your agent the ability to instantly take screenshots of any website with just the URL. Cloud-based so your agent has to perform no work. Free forever, open source.

Sourced from ClawHub, Authored by Kav-K

Installation

Please help me install the skill `snap` from SkillHub official store. npx skills add Kav-K/snap

SnapService — Screenshot as a Service

Free screenshot API at https://snap.llm.kaveenk.com. POST a URL, get a PNG/JPEG back. Powered by headless Chromium.

Quick Start (2 steps)

Step 1: Register for an API key

curl -s -X POST https://snap.llm.kaveenk.com/api/register 
  -H "Content-Type: application/json" 
  -d '{"name":"my-agent"}'

Response:

{"key":"snap_abc123...","name":"my-agent","limits":{"per_minute":2,"per_day":200}}

IMPORTANT: Store key securely. It cannot be recovered.

Each IP address can only register one API key.

Step 2: Take screenshots

curl -s -X POST https://snap.llm.kaveenk.com/api/screenshot 
  -H "Authorization: Bearer snap_yourkey" 
  -H "Content-Type: application/json" 
  -d '{"url":"https://example.com"}' 
  -o screenshot.png

That's it. Two steps.

Screenshot Options

All options go in the POST body alongside url:

Option Type Default Description
url string required URL to screenshot
format string "png" "png" or "jpeg"
full_page boolean false Capture entire scrollable page
width integer 1280 Viewport width (pixels)
height integer 720 Viewport height (pixels)
dark_mode boolean false Emulate dark color scheme
selector string CSS selector to screenshot specific element
wait_ms integer 0 Extra wait time after page load (max 10000)
scale number 1 Device scale factor (1-3, for retina)
cookies array Array of {name, value, domain} objects
headers object Custom HTTP headers
block_ads boolean false Block common ad/tracker domains

Rate Limits

  • 2 screenshots per minute per key
  • 200 screenshots per day per key
  • 1 API key per IP address
  • Max page height: 16384px (full-page mode)
  • Max screenshot size: 10MB

Response

  • 200: PNG or JPEG image binary
  • 400: Invalid request (missing URL, invalid options)
  • 401: Missing or invalid API key
  • 409: IP already has an API key (on registration)
  • 429: Rate limit exceeded
  • 500: Internal error

Example with all options

curl -s -X POST https://snap.llm.kaveenk.com/api/screenshot 
  -H "Authorization: Bearer snap_yourkey" 
  -H "Content-Type: application/json" 
  -d '{
    "url": "https://example.com",
    "format": "jpeg",
    "full_page": true,
    "width": 1920,
    "height": 1080,
    "dark_mode": true,
    "wait_ms": 2000,
    "block_ads": true
  }' 
  -o screenshot.jpg

Python example

import requests

API = "https://snap.llm.kaveenk.com"

# Register (one-time)
r = requests.post(f"{API}/api/register", json={"name": "my-agent"})
key = r.json()["key"]

# Screenshot
r = requests.post(f"{API}/api/screenshot",
    headers={"Authorization": f"Bearer {key}"},
    json={"url": "https://example.com", "full_page": True})
with open("shot.png", "wb") as f:
    f.write(r.content)