Zyte Screenshots

Zyte Screenshots Skill

Capture full-page screenshots of any public URL via the Zyte API using curl, save as a PNG file, and briefly describe the visual content.

Prerequisites

• curl installed (standard on macOS/Linux)
• jq installed
• base64 CLI available
• ZYTE_API_KEY set in the environment

Workflow

Step 1 — Validate inputs

1. Confirm the user has provided a valid URL (must start with http:// or https://).
2. Check for ZYTE_API_KEY in the environment:

   echo $ZYTE_API_KEY
   

   If empty or unset, stop and tell the user to export it before continuing:

   export ZYTE_API_KEY="your_api_key_here"
   

Step 2 — Derive the output filename

The filename must be the website name with https:// and .com removed. Strip exactly as follows:

• Remove https:// or http://
• Remove www. prefix if present
• Remove .com (and anything after it)
• Replace any remaining dots or slashes with underscores

Examples:

Step 3 — Run the curl command

Run this exact command, substituting $ZYTE_API_KEY, the target URL, and the derived filename:

curl -s https://api.zyte.com/v1/extract \
  -u "$ZYTE_API_KEY": \
  -H "Content-Type: application/json" \
  -d '{
    "url": "URL",
    "screenshot": true
  }' \
| jq -r '.screenshot' \
| base64 --decode > FILENAME.png

After running, verify the file was created and is non-empty:

[ -s "FILENAME.png" ] && echo "Success" || echo "Failed"

Common errors:

To debug, first print the raw API response:

curl -s https://api.zyte.com/v1/extract \
  -u "$ZYTE_API_KEY": \
  -H "Content-Type: application/json" \
  -d '{"url": "URL", "screenshot": true}'

Step 4 — View and describe the screenshot

After a successful download:

1. Use the view tool to open and inspect the PNG file.
2. Tell the user the exact file path so they can open it:

   📁 Screenshot saved to: /home/claude/FILENAME.png
   

3. Write a single sentence describing what is visible in the screenshot (e.g. layout, brand, main content area).

Response format

✅ Screenshot captured!

📁 Location: /path/to/FILENAME.png

🖼️  What's in it: [One-sentence visual description]