Site-Shot MCP server

Da a Claude, Cursor y otros agentes de IA la capacidad de ver cualquier página web — toma capturas de pantalla de sitios web con Site-Shot mediante el Model Context Protocol.

Renderizado real de Chromium · captura de página completa · proxies por país · eliminación automática de anuncios y banners de cookies (imágenes más limpias, menos tokens de visión).

Inicio rápido (Claude Desktop)

1. Obtén una clave de API de Site-Shot en https://www.site-shot.com/start/.

2. Añade esto a tu configuración de Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "site-shot": {
      "command": "npx",
      "args": ["-y", "site-shot-mcp"],
      "env": { "SITESHOT_API_KEY": "YOUR_API_KEY" }
    }
  }
}

3. Reinicia Claude Desktop. Pídele "haz una captura de pantalla de página completa de https://news.ycombinator.com" y llamará al servidor y te mostrará la imagen.

Funciona igual en cualquier cliente MCP (Cursor, Cline, VS Code, LangChain, CrewAI) — apunta el cliente a npx -y site-shot-mcp con SITESHOT_API_KEY en el entorno.

Related MCP server: ScreenshotOne MCP Server

Tools

capture_screenshot

Captura una página web (viewport por defecto).

Devuelve la captura de pantalla como una imagen MCP.

«Por defecto de la API» no es un número que este paquete pueda indicar. width, height y wait_ms solo se reenvían cuando los pasas, así que lo que se aplique cuando no los pasas lo decide la API de Site-Shot y puede cambiar sin necesidad de publicar una versión de este paquete. Las versiones hasta la 1.1.0 imprimían tamaños de píxel para width / height que la API no usa: un agente que los omitía para tomar "el valor por defecto" obtenía un viewport distinto, y la imagen devuelta no revela esa nada. Pasa valores explícitos siempre que el tamaño sea importante.

Los códigos de país son códigos ISO, nunca nombres. Pasa "DE", no "Germany". La API hace coincidir los códigos exactamente; de lo contrario usaría un proxy de EE. UU. sin avisarte, por lo que el servidor rechaza los nombres completos antes de gastar una renderización. strict_country (por defecto, activado) convierte un país no disponible en un error en lugar de una captura silenciosa desde EE.UU — pasa false para volver a la alternativa. Países compatibles →

capture_full_page

Igual que capture_screenshot con la captura de página completa habilitada.

¿Por qué llamar a este servidor en lugar del navegador del propio agente?

Si tu agente controla un navegador, puede capturar las páginas por sí mismo — y para páginas que requieren iniciar sesión o seguir un flujo paso a paso, esa es la herramienta adecuada. Para URLs públicas, delegar la captura en este servidor suele ser una mejor ingeniería: cada captura recorre la misma canal (sin replanificar entre pasos), se puede tomar desde un país concreto con la configuración regional y la zona horaria correspondientes (country + strict_country), la evalúa un clasificador de imágenes que reintenta de forma progresiva antes de devolverla, y cuesta menos de un céntimo en lugar de una sesión de navegador más tokens de visión por cada vistazo. La comparación completa, argumentada con honestidad en ambas direcciones: Agente de IA vs. API de capturas — quién debe capturar la página.

Configuración

El servidor es una envoltura fina sobre la API HTTP existente de Site-Shot (https://api.site-shot.com/) — no hay ningún backend por separado.

Desarrollo local

npm install
npm run check   # syntax check
npm run smoke   # offline tests (stubbed fetch, no API key needed)
SITESHOT_API_KEY=yourkey npm start   # run the server on stdio

Requisitos

Node.js ≥ 18 (usa el fetch incorporado).

Licencia

MIT