Twitter/X Screenshot for AI Agents

---
name: twittershots
description: |
  Generate high-quality screenshots of Twitter/X posts using the TwitterShots API.
  Use when the user wants to: capture a tweet as an image, screenshot a tweet,
  generate tweet image, convert tweet to PNG/SVG/HTML, create tweet screenshot
  for social media (Instagram, TikTok), or mentions "TwitterShots", "tweet screenshot",
  "capture tweet", "tweet image". Triggers on tweet URLs (twitter.com/*/status/* or x.com/*/status/*)
  or tweet IDs. Default to format=png and theme=light without asking follow-up questions;
  if the user explicitly provides format and/or theme, use the user-provided values.
homepage: https://github.com/twittershots/skills
source: https://github.com/twittershots/skills
credentials:
  - name: TWITTERSHOTS_API_KEY
    description: API key from https://twittershots.com/settings/keys
    required: true
dependencies:
  python:
    - requests
---

# TwitterShots Skill

Generate high-quality screenshots of Twitter/X posts via REST API.

## Prerequisites

- API key from [TwitterShots Account Settings](https://twittershots.com/settings/keys)
- Store the key securely (environment variable `TWITTERSHOTS_API_KEY` recommended)

## Extract Tweet ID

Parse tweet ID from various URL formats:

```
https://twitter.com/username/status/1617979122625712128
https://x.com/username/status/1617979122625712128
https://twitter.com/username/status/1617979122625712128?s=20
```

Extract pattern: `/status/(\d+)` → Tweet ID is the numeric part af

# ... (truncated, click "Expand" to see full file)

#!/usr/bin/env python3
"""
TwitterShots API - Tweet Screenshot Generator

Generate high-quality screenshots of Twitter/X posts.

Usage:
    python screenshot_tweet.py <tweet_id_or_url> [options]

Environment:
    TWITTERSHOTS_API_KEY: Your API key (required)

Examples:
    python screenshot_tweet.py 1617979122625712128
    python screenshot_tweet.py https://twitter.com/user/status/1617979122625712128
    python screenshot_tweet.py 1617979122625712128 --format png --theme dark
    python screenshot_tweet.py 1617979122625712128 --aspect-ratio 4:5 --output tweet.png
"""

import argparse
import os
import re
import sys
from urllib.parse import urlencode

try:
    import requests
except ImportError:
    print("Error: requests library required. Install with: pip install requests")
    sys.exit(1)


API_BASE = "https://api.twittershots.com/api/v1/screenshot"


def extract_tweet_id(input_str: str) -> str:
    """Extract tweet ID from URL or return as-is if already numeric."""
    if input_str.isdigit():
        return input_str

    match = re.search(r'/status/(d+)', input_str)
    if match:
        return match.group(1)

    raise ValueError(f"Could not extract tweet ID from: {input_str}")


def screenshot_tweet(
    tweet_id: str,
    api_key: str,
    format: str = "png",
    theme: str = "light",
    aspect_ratio: str = "auto",
    return_type: str = "buffer",
    show_stats: bool = True,
    show_views: bool = True,
    show_timestamp: bool = True,
    show_media: bool = True,
  

# ... (truncated, click "Expand" to see full file)