AlterLab

Extrae cualquier sitio, extrae datos estructurados y captura capturas de pantalla, con renderizado de JavaScript, rotación de proxies residenciales y reintentos automáticos.

GitHub

Documentación

Servidor MCP de AlterLab

Dale a Claude, Cursor y Windsurf la capacidad de extraer cualquier sitio web, obtener datos estructurados y tomar capturas de pantalla — con evasión automática de anti-bots.

Empieza gratis → $1 de saldo gratis al registrarte — hasta 5,000 extracciones.

Instalación en una Línea

Claude Code

claude mcp add alterlab -- npx -y alterlab-mcp-server@latest

Luego configura tu clave API: export ALTERLAB_API_KEY=sk_live_... o agrégala a .claude.json (consulta la configuración completa más abajo).

Cursor

# Add to .cursor/mcp.json — see full config below

Smithery

npx -y @smithery/cli install alterlab-mcp-server --client claude

¿Por qué AlterLab en lugar de WebFetch o Browser MCP?

La herramienta WebFetch integrada de Claude y los servidores MCP de navegador de código abierto fallan en la mayoría de los sitios web reales. No pueden evadir Cloudflare, renderizar SPAs de JavaScript ni extraer datos estructurados.

AlterLab reemplaza las herramientas de fetch rotas con un solo servidor MCP que realmente funciona:

Capacidad	WebFetch / fetch()	Browser MCP	AlterLab MCP
Evasión de anti-bots (Cloudflare, DataDome, Akamai)	No	Parcial	Sí — automática
Renderizado de JavaScript (SPAs de React, Angular, Vue)	No	Sí (lento)	Sí — Chromium sin interfaz
Extracción de datos estructurados (JSON, Schema.org)	No	No	Sí — perfiles integrados
Escalado inteligente de niveles (método más barato primero)	N/D	N/D	Sí — ahorra 60-80 %
Rotación de proxy residencial (195+ países)	No	No	Sí
Captura de pantallas y PDF	No	Solo pantallas	Sí — ambos
Extracción de texto OCR desde imágenes	No	No	Sí
Costo por solicitud	Gratis (pero falla)	Gratis (pero lento)	Desde $0.0002

¿Cómo Funciona la Extracción Web de AlterLab?

AlterLab usa una arquitectura de extracción de múltiples niveles. Selecciona automáticamente el método más barato capaz de obtener cada URL:

Curl ($0.0002/req) — HTTP directo para páginas estáticas, fuentes RSS, APIs públicas
HTTP ($0.0003/req) — Rotación de huella TLS para sitios con protección moderada
Stealth ($0.0005/req) — Suplantación de navegador para sitios protegidos por Cloudflare/DataDome
Light JS ($0.0007/req) — Extracción ligera de JS desde HTML renderizado en el servidor
Browser ($0.001/req) — Chromium completo sin interfaz para SPAs con mucho JavaScript

El modo automático comienza en el Nivel 1 y solo escala cuando se bloquea. La mayoría de los sitios web se resuelven en los Niveles 1-2, así que $1 te da entre 1,000 y 5,000 extracciones según los sitios a los que apuntes.

Instalación

Instalar en Claude Desktop / Claude Code

Agrega a tu archivo de configuración de Claude (~/.claude.json para Claude Code, o Configuración para Claude Desktop):

{
  "mcpServers": {
    "alterlab": {
      "command": "npx",
      "args": ["-y", "alterlab-mcp-server@latest"],
      "env": {
        "ALTERLAB_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Instalar en Cursor

Agrega a .cursor/mcp.json en la raíz de tu proyecto:

{
  "mcpServers": {
    "alterlab": {
      "command": "npx",
      "args": ["-y", "alterlab-mcp-server@latest"],
      "env": {
        "ALTERLAB_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Instalar en Windsurf

Agrega a la configuración de MCP de Windsurf (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "alterlab": {
      "command": "npx",
      "args": ["-y", "alterlab-mcp-server@latest"],
      "env": {
        "ALTERLAB_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Instalar vía Smithery

npx -y @smithery/cli install alterlab-mcp-server --client claude

Obtén Tu Clave API

Regístrate gratis — $1 de saldo gratis al registrarte
Ve a Panel → Claves API y copia tu clave
Pégala en el campo ALTERLAB_API_KEY en tu configuración de MCP

Herramientas

`alterlab_scrape` — Extrae Cualquier Página Web

Extrae una URL y devuelve su contenido como markdown, texto, HTML o JSON. Maneja automáticamente la protección anti-bots con escalado de niveles. Devuelve markdown por defecto — optimizado para ventanas de contexto de LLM.

"Scrape https://www.amazon.com/dp/B0BSHF7WHW and summarize the product"

Parámetro	Tipo	Predeterminado	Descripción
`url`	string	requerido	URL a extraer
`mode`	`auto` \| `html` \| `js` \| `pdf` \| `ocr`	`auto`	Modo de extracción
`formats`	`(text\|json\|html\|markdown)[]`	`["markdown"]`	Formatos de salida
`render_js`	boolean	`false`	Usar navegador sin interfaz (+3 créditos)
`use_proxy`	boolean	`false`	Proxy premium (+1 crédito)
`proxy_country`	string	—	Código de país ISO para segmentación geográfica (p. ej., `US`, `DE`)
`wait_for`	string	—	Selector CSS para esperar antes de la extracción
`timeout`	number	`90`	Tiempo de espera en segundos (1-300)
`include_raw_html`	boolean	`false`	Incluir HTML crudo junto con el contenido formateado
`session_id`	string (UUID)	—	ID de sesión almacenada para extracción autenticada
`cookies`	`Record<string, string>`	—	Cookies en línea para solicitudes autenticadas puntuales

`alterlab_extract` — Extrae Datos Estructurados

Extrae campos estructurados de cualquier página web usando perfiles preconstruidos o un JSON Schema personalizado. Devuelve JSON limpio — listo para bases de datos, hojas de cálculo o procesamiento posterior.

"Extract the product name, price, and rating from this Amazon page"

Parámetro	Tipo	Predeterminado	Descripción
`url`	string	requerido	URL desde la que extraer
`extraction_profile`	enum	`auto`	Perfil: `product`, `article`, `job_posting`, `faq`, `recipe`, `event`
`extraction_schema`	object	—	JSON Schema personalizado para salida estructurada
`extraction_prompt`	string	—	Instrucciones de extracción en lenguaje natural
`render_js`	boolean	`false`	Usar navegador sin interfaz
`use_proxy`	boolean	`false`	Proxy premium

Perfiles de extracción:

Producto — nombre, precio, moneda, calificación, reseñas, disponibilidad, imágenes, descripción
Artículo — título, autor, fecha de publicación, cuerpo del texto, imagen destacada
Oferta de empleo — título, empresa, ubicación, salario, descripción, requisitos
FAQ — pares de pregunta y respuesta
Receta — ingredientes, instrucciones, tiempo de preparación, porciones
Evento — nombre, fecha, ubicación, descripción, organizador

`alterlab_screenshot` — Captura Cualquier Página

Toma una captura de pantalla de página completa de cualquier URL. Devuelve una imagen PNG directamente en la conversación — sin URLs para copiar, sin archivos para descargar.

"Take a screenshot of our landing page at https://alterlab.io"

Parámetro	Tipo	Predeterminado	Descripción
`url`	string	requerido	URL para capturar
`wait_for`	string	—	Selector CSS para esperar antes de la captura
`wait_until`	enum	`networkidle`	`networkidle`, `domcontentloaded` o `load`

`alterlab_estimate_cost` — Estima Antes de Extraer

Verifica cuánto costará una extracción antes de ejecutarla. Devuelve el nivel previsto, el costo por solicitud y el nivel de confianza.

"How much would it cost to scrape linkedin.com?"

Parámetro	Tipo	Predeterminado	Descripción
`url`	string	requerido	URL a estimar
`mode`	enum	`auto`	Modo de extracción
`render_js`	boolean	`false`	Incluir costo de renderizado de JS
`use_proxy`	boolean	`false`	Incluir costo de proxy

`alterlab_check_balance` — Consulta Tus Créditos

Consulta el saldo de tu cuenta, el total depositado y el total gastado. No se necesitan parámetros.

"Check my AlterLab balance"

`alterlab_list_sessions` — Lista Sesiones Almacenadas

Lista todas las sesiones almacenadas para extracción autenticada. Las sesiones contienen cookies para dominios específicos, lo que te permite extraer contenido detrás de muros de inicio de sesión.

"List my stored sessions"

`alterlab_create_session` — Crea una Sesión

Crea una nueva sesión almacenada con cookies de un navegador con sesión iniciada. La sesión se almacena de forma segura y se puede reutilizar en múltiples solicitudes de extracción.

"Create an Amazon session with these cookies: session-id=abc123, session-token=xyz789"

Parámetro	Tipo	Predeterminado	Descripción
`name`	string	requerido	Nombre legible (p. ej., "Mi cuenta de Amazon")
`domain`	string	requerido	Dominio (p. ej., "amazon.com")
`cookies`	`Record<string, string>`	requerido	Pares clave-valor de cookies
`user_agent`	string	—	User-Agent del navegador para usar con esta sesión

`alterlab_validate_session` — Valida una Sesión

Verifica si una sesión almacenada sigue activa y si sus cookies son válidas.

"Is my Amazon session still valid?"

Parámetro	Tipo	Predeterminado	Descripción
`session_id`	string (UUID)	requerido	ID de sesión a validar

`alterlab_delete_session` — Elimina una Sesión

Elimina permanentemente una sesión almacenada y sus cookies.

"Delete session abc-123-def"

Parámetro	Tipo	Predeterminado	Descripción
`session_id`	string (UUID)	requerido	ID de sesión a eliminar

Extracción Autenticada

El MCP de AlterLab admite la extracción de páginas que requieren autenticación. Esto permite que los agentes de IA accedan a contenido específico del usuario, como historiales de pedidos, paneles de cuenta y precios solo para miembros.

Cómo Funciona

Crea una sesión con cookies de un navegador con sesión iniciada usando alterlab_create_session
Extrae páginas autenticadas pasando el session_id a alterlab_scrape
Administra sesiones con las herramientas de listar, validar y eliminar

Ejemplo: Consulta los Precios de Amazon Prime

User: "What's my Prime member price for this product?"

Claude: [calls alterlab_list_sessions → finds Amazon session]
Claude: [calls alterlab_scrape with session_id for authenticated pricing]
Claude: "The Prime member price is $24.99 (public price: $34.99)"

Cookies en Línea vs Sesiones Almacenadas

Sesiones almacenadas (session_id): Ideales para acceso repetido al mismo dominio. Crea una vez, reutiliza en múltiples solicitudes.
Cookies en línea (cookies): Ideales para solicitudes autenticadas puntuales cuando no necesitas guardar la sesión.

¿Qué Puedes Hacer con el MCP de AlterLab?

Investigación y Análisis

Pídele a Claude que extraiga y analice sitios web en tiempo real:

"Extrae los 5 mejores resultados de esta búsqueda de Google y resúmelos"
"Extrae todos los precios de productos de esta página de categoría de Amazon"
"Compara las páginas de precios de estos 3 competidores"

Generación de Código con Datos Reales

Deja que Cursor o Windsurf obtengan datos en vivo mientras construyes:

"Extrae esta página de documentación de API y genera tipos de TypeScript a partir de ella"
"Extrae la paleta de colores de este sitio web y crea una configuración de Tailwind"
"Captura este diseño y recréalo en React"

Contenido y SEO

Usa Claude para analizar contenido a escala:

"Extrae esta publicación de blog y sugiere mejoras para SEO"
"Extrae todas las entradas de FAQ de este centro de ayuda y crea un conjunto de datos estructurado"
"Compara nuestra página de inicio con la del competidor e identifica brechas"

Monitoreo y Alertas

Construye flujos de trabajo agénticos que vigilen la web:

"Verifica si este producto está de vuelta en stock"
"Extrae esta página diariamente y avísame cuando el precio baje de $50"
"Monitorea esta bolsa de trabajo para nuevas posiciones de ingeniería senior"

Precios — Extracción Web de Pago por Uso

Sin suscripciones. Sin mínimos mensuales. Agrega saldo y úsalo cuando lo necesites.

Costos Base de Extracción

Nivel	Método	Costo por Solicitud	Caso de Uso
Curl	HTTP directo	$0.0002	Páginas estáticas, fuentes RSS, APIs públicas
HTTP	Huella TLS	$0.0003	Sitios con detección básica de bots
Stealth	Suplantación de navegador	$0.0005	Sitios protegidos por Cloudflare, DataDome, PerimeterX
Light JS	Extracción JSON	$0.0007	Páginas renderizadas en el servidor que necesitan datos estructurados
Browser	Chromium sin interfaz	$0.001	SPAs completas de JavaScript (React, Angular, Vue)

Complementos Opcionales

Complemento	Costo Adicional	Descripción
Renderizado de JavaScript	+$0.0006	Chromium sin interfaz para contenido dinámico
Captura de pantalla	+$0.0002	PNG de página completa
Proxy premium	+$0.0002	Proxy residencial con segmentación geográfica (195+ países)
Extracción de texto OCR	+$0.001	Extrae texto de imágenes en la página

$1 = 5,000 extracciones ligeras. Las cuentas nuevas reciben $1 de saldo gratis al registrarse.

Variables de Entorno

Variable	Obligatorio	Por defecto	Descripción
`ALTERLAB_API_KEY`	Sí	—	Tu clave de API (obtén una gratis)
`ALTERLAB_API_URL`	No	`https://api.alterlab.io`	URL base de la API (para autoalojamiento o desarrollo)

Preguntas frecuentes

¿Cómo agrego scraping web a Claude, Cursor o Windsurf?

Instala el servidor MCP de AlterLab. Para Claude Code, ejecuta claude mcp add alterlab -- npx -y alterlab-mcp-server@latest y configura tu ALTERLAB_API_KEY. Para Claude Desktop, Cursor o Windsurf, añade el bloque de configuración JSON a tu archivo de ajustes de MCP. Una vez configurado, tu asistente de IA puede extraer cualquier URL, obtener datos estructurados y tomar capturas de pantalla directamente en la conversación.

¿Puede Claude extraer sitios web que están detrás de Cloudflare o protección anti-bot?

Sí. AlterLab maneja automáticamente Cloudflare, DataDome, PerimeterX, Akamai y otros sistemas anti-bot. Utiliza un enfoque de múltiples niveles que comienza con el método más económico y solo escala cuando se bloquea. No necesitas configurar nada — la evasión anti-bot es totalmente automática.

¿Qué es un servidor MCP y cómo funciona con Claude?

MCP (Model Context Protocol) es el estándar abierto de Anthropic para conectar asistentes de IA a herramientas y fuentes de datos externas. Un servidor MCP es un pequeño programa que expone herramientas — como el scraping web — que Claude, Cursor o Windsurf pueden llamar durante una conversación. El servidor MCP de AlterLab le da a tu asistente de IA 23 herramientas: extraer, obtener datos estructurados, capturas de pantalla, rastreo, búsqueda, mapas, scraping por lotes, gestión de sesiones, funciones beta y más.

¿En qué se diferencia AlterLab de Firecrawl, ScrapingBee o los servidores MCP de Apify?

AlterLab comienza en $0.0002 por solicitud — 5-20 veces más barato que la mayoría de las APIs de scraping — porque solo utiliza renderizado de navegador costoso cuando un sitio realmente lo requiere. La escalada inteligente de niveles significa que pagas por lo que cada sitio necesita, no por el máximo. AlterLab también incluye extracción de datos estructurados integrada con perfiles predefinidos (producto, artículo, oferta de empleo, etc.) sin costo adicional.

¿Puedo extraer Amazon, Walmart y otros sitios de comercio electrónico desde Claude?

Sí. AlterLab maneja toda la protección anti-bot de los principales sitios de comercio electrónico. Usa la herramienta alterlab_extract con extraction_profile: "product" para obtener JSON estructurado: nombre del producto, precio, moneda, calificación, número de reseñas, disponibilidad e imágenes — listo para análisis, comparación o pipelines de datos.

¿Puede Cursor extraer documentación y generar código a partir de ella?

Sí. Con AlterLab MCP instalado en Cursor, puedes pedirle que extraiga documentación de API, documentación de bibliotecas o cualquier página de referencia y genere tipos de TypeScript, clientes de API o código de componentes a partir del contenido en vivo. Esto es más confiable que depender de los datos de entrenamiento del LLM, que pueden estar desactualizados.

¿Funciona AlterLab MCP con sitios con mucho JavaScript (React, Angular, Vue)?

Sí. Usa render_js: true o configura mode: "js" para habilitar el renderizado completo de Chromium sin interfaz gráfica. AlterLab renderiza la página completa incluyendo todo el JavaScript, espera a que el contenido dinámico se cargue y luego extrae el contenido del DOM completamente renderizado. Esto funciona para React, Angular, Vue, Next.js y cualquier otro framework de JavaScript.

¿Qué formato de salida es mejor para los contextos de IA y LLM?

Usa markdown (el predeterminado). Preserva la estructura del documento — encabezados, tablas, listas, enlaces — mientras es 60-80% más pequeño que el HTML crudo. Claude, GPT-4 y otros LLM procesan markdown significativamente mejor que HTML. La salida en markdown de AlterLab está específicamente optimizada para los contextos de LLM.

¿Hay límites de velocidad?

Las cuentas de nivel gratuito tienen límites de velocidad. Agregar cualquier saldo elimina los límites de velocidad. El servidor MCP incluye reintentos automáticos con retroceso exponencial para errores transitorios de límite de velocidad (429).

¿Puedo usar este servidor MCP para scraping a gran escala?

Sí. Para scraping en paralelo, usa alterlab_batch para extraer hasta 100 URLs en una sola solicitud — mucho más rápido que llamadas secuenciales. Para rastrear dominios completos, usa alterlab_crawl. También puedes construir flujos de trabajo agénticos que extraigan muchas URLs secuencialmente, o usar la integración con n8n para automatización de flujos de trabajo.

Manejo de errores

El servidor MCP devuelve mensajes de error útiles con acciones sugeridas:

Error	Qué sucede	Acción sugerida
401 No autorizado	Clave de API inválida	Verifica que `ALTERLAB_API_KEY` esté configurado correctamente
402 Créditos insuficientes	Saldo demasiado bajo	Ejecuta `alterlab_check_balance`, agrega fondos
403 Prohibido	El sitio bloqueó la solicitud	Prueba con `render_js: true` + `use_proxy: true`
429 Límite de velocidad	Demasiadas solicitudes	Reintento automático con retroceso
504 Tiempo de espera agotado	El scraping tardó demasiado	Aumenta `timeout`, simplifica la solicitud

Flujos de trabajo agénticos — Agentes de IA que extraen la web

AlterLab MCP convierte a cualquier agente de IA en un agente con capacidad web. En lugar de depender de datos de entrenamiento obsoletos, tu agente puede obtener información en vivo de cualquier sitio web durante la ejecución.

Casos de uso para agentes de IA

Agentes de investigación — extraen múltiples fuentes, cruzan hechos, generan informes con citas
Agentes de pipelines de datos — extraen datos estructurados de productos/precios/empleos de forma programada
Inteligencia competitiva — monitorean páginas de competidores, rastrean cambios de precios, detectan nuevas funciones
Generación de contenido — extraen datos reales para fundamentar la salida del LLM en hechos, no en alucinaciones
Enriquecimiento de leads — extraen sitios web de empresas para enriquecer registros de CRM con datos en vivo
Monitoreo de cumplimiento — verifican páginas regulatorias, términos de servicio y actualizaciones de políticas

Frameworks y clientes de IA compatibles

Funciona con cualquier herramienta que soporte MCP (Model Context Protocol):

Claude Desktop / Claude Code — el asistente de IA de Anthropic
Cursor — editor de código impulsado por IA
Windsurf — el IDE de IA de Codeium
Cline — asistente de IA para VS Code
GitHub Copilot — mediante configuración de MCP
Agentes personalizados — cualquier framework que use el SDK de MCP (Python, TypeScript, Go)
n8n — automatización de flujos de trabajo mediante n8n-nodes-alterlab

Contribuciones

git clone https://github.com/RapierCraft/alterlab-mcp-server.git
cd alterlab-mcp-server
npm install
npm run build

Soporte

Licencia

MIT