MCP Screenshot Website Fast

🚀 @just-every/mcp-screenshot-website-fast

A fast and efficient web page screenshot capture tool optimized for the Claude Vision API. It automatically divides full pages into 1072x1072 chunks for optimal AI processing.

🚀 Quick Start

This tool is specifically designed for AI vision workflows. It captures high - quality screenshots, automatically limits the resolution, and tiles the pages, making it ideal for processing by the Claude Vision API and other AI models. It ensures that screenshots are sized at 1072x1072 pixels (1.15 megapixels) for maximum compatibility.

Once installed in your IDE, you can use the screenshot_website_fast tool to capture high - quality screenshots of web pages.

✨ Features

• 📸 Fast screenshot capture: Utilizes the Puppeteer headless browser for quick captures.
• 🎯 Claude Vision optimized: Automatically limits the resolution to 1072x1072 pixels (1.15 megapixels).
• 🔲 Automatic tiling: Full pages are automatically split into 1072x1072 tiles.
• 🔄 Always fresh content: No caching guarantees up - to - date screenshots.
• 📱 Configurable viewports: Useful for responsive testing.
• ⏱️ Wait strategies: Supports dynamic content with options like networkidle and custom delays.
• 📄 Full page capture: By default, captures the entire page.
• 📦 Minimal dependencies: Enables fast npm installs.
• 🔌 MCP integration: Seamlessly integrates with AI workflows.

📦 Installation

Claude Code

claude mcp add screenshot-website-fast -s user -- npx -y @just-every/mcp-screenshot-website-fast

VS Code

code --add-mcp '{"name":"screenshot-website-fast","command":"npx","args":["-y","@just-every/mcp-screenshot-website-fast"]}'

Cursor

cursor://anysphere.cursor-deeplink/mcp/install?name=screenshot-website-fast&config=eyJzY3JlZW5zaG90LXdlYnNpdGUtZmFzdCI6eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBqdXN0LWV2ZXJ5L21jcC1zY3JlZW5zaG90LXdlYnNpdGUtZmFzdCJdfX0=

JetBrains IDEs

Settings → Tools → AI Assistant → Model Context Protocol (MCP) → Add Choose "As JSON" and paste:

{"command":"npx","args":["-y","@just-every/mcp-screenshot-website-fast"]}

Raw JSON (works in any MCP client)

{
  "mcpServers": {
    "screenshot-website-fast": {
      "command": "npx",
      "args": ["-y", "@just-every/mcp-screenshot-website-fast"]
    }
  }
}

Place this into your client's mcp.json (e.g.,.vscode/mcp.json, ~/.cursor/mcp.json, or.mcp.json for Claude).

Prerequisites

• Node.js 20.x or higher
• npm or npx
• Chrome/Chromium (automatically downloaded by Puppeteer)

💻 Usage Examples

Basic Usage

# Full page with automatic tiling (default)
npm run dev capture https://example.com -o screenshot.png

# Viewport-only screenshot  
npm run dev capture https://example.com --no-full-page -o screenshot.png

# Wait for specific conditions
npm run dev capture https://example.com --wait-until networkidle0 --wait-for 2000 -o screenshot.png

CLI Options

• -w, --width <pixels>: Viewport width (max 1072, default: 1072).
• -h, --height <pixels>: Viewport height (max 1072, default: 1072).
• --no-full-page: Disable full page capture and tiling.
• --wait-until <event>: Wait until event: load, domcontentloaded, networkidle0, networkidle2.
• --wait-for <ms>: Additional wait time in milliseconds.
• -o, --output <path>: Output file path (required for tiled output).

🔧 Technical Details

Architecture

mcp-screenshot-website-fast/
├── src/
│   ├── internal/       # Core screenshot capture logic
│   ├── utils/          # Logger and utilities
│   ├── index.ts        # CLI entry point
│   └── serve.ts        # MCP server entry point

Development

# Run in development mode
npm run dev capture https://example.com -o screenshot.png

# Build for production
npm run build

# Run tests
npm test

# Type checking
npm run typecheck

# Linting
npm run lint

Why This Tool?

• Optimized for Claude Vision API: Automatically limits the resolution to 1072x1072 pixels (1.15 megapixels).
• Automatic tiling: Splits full pages into perfect chunks for AI processing.
• Always fresh: No caching ensures the latest content.
• MCP native: Offers first - class integration with AI development tools.
• Simple API: Provides a clean and straightforward interface for capturing screenshots.

🤝 Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository.
2. Create a feature branch.
3. Add tests for new functionality.
4. Submit a pull request.

❓ Troubleshooting

Puppeteer Issues

• Ensure Chrome/Chromium can be downloaded.
• Check firewall settings.
• Try setting PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true and provide a custom executable.

Screenshot Quality

• Adjust viewport dimensions.
• Use appropriate wait strategies.
• Check if the site requires authentication.

Timeout Errors

• Increase wait time with the --wait-for flag.
• Use different --wait-until strategies.
• Check if the site is accessible.

📄 License

This project is licensed under the MIT License.