Decodo
oficialAcceso sencillo a datos web. Recuperación simplificada de información de sitios web y fuentes en línea.
¿Qué puedes hacer con Decodo MCP?
- Extraer páginas como Markdown — Pide a tu asistente que extraiga cualquier URL, incluidas páginas con mucho JavaScript, y devuelva Markdown listo para LLM.
- Capturar capturas de pantalla — Solicita una captura de pantalla PNG de cualquier página web, opcionalmente desde una IP de un país específico.
- Rastrear sitios — Inicia un rastreo, consulta su progreso, recupera las páginas rastreadas de unas pocas en unas pocas o cancélalo.
- Motores de búsqueda — Realiza búsquedas web, en Google, Bing, Google Ads, Google Lens o Google Travel Hotels y obtén resultados analizados.
- Datos de comercio electrónico — Obtén datos de productos, precios, vendedores y superventas de Amazon, Walmart, Target y TikTok Shop.
- Respuestas de redes sociales e IA — Recopila publicaciones de TikTok y metadatos, subtítulos, canales o resultados de búsqueda de YouTube, o consulta ChatGPT y Perplexity.
Documentación
Servidor MCP de Decodo
Conecta LLM y agentes de IA a datos web en tiempo real mediante MCP (Model Context Protocol). El servidor MCP de Decodo te permite extraer datos de sitios web, motores de búsqueda, plataformas de comercio electrónico y redes sociales directamente desde herramientas de IA como Claude, Cursor y Windsurf, sin necesidad de crear una infraestructura de extracción desde cero.
- Resultados estructurados en JSON, Markdown y capturas de pantalla
- Renderizado de JavaScript en el servidor y gestión de sistemas antibots
- Más de 125 millones de IP en más de 195 ubicaciones
¿Qué es el servidor MCP de Decodo?
El servidor MCP de Decodo es una capa de extracción de datos web para agentes de IA. Conecta clientes compatibles con MCP a la API de extracción de datos web de Decodo y permite:
- Extracción de datos web para LLM
- Recuperación de datos en tiempo real para RAG
- Navegación e investigación con agentes de IA
- Extracción de datos estructurados de sitios web dinámicos
En lugar de mantener proxies, analizadores y lógica de reintentos, dispones de un único punto de integración para acceder de forma fiable a datos web.
¿Por qué usar MCP para extraer datos web?
Model Context Protocol (MCP) es el estándar emergente para conectar agentes de IA con herramientas y fuentes de datos externas. Con MCP:
- Los agentes pueden invocar herramientas dinámicamente
- Las integraciones se mantienen estandarizadas
- Los flujos de trabajo se escalan en distintos entornos
El servidor MCP de Decodo proporciona a tus agentes acceso web fiable y listo para producción mediante este estándar.
Funciones principales
Extracción de datos web para agentes de IA, sin necesidad de infraestructura. Extrae datos de cualquier sitio web, incluidas páginas con mucho JavaScript, sin gestionar la rotación de proxies, la resolución de CAPTCHA ni los sistemas antibots.
Resultados estructurados para flujos de trabajo con LLM. Markdown (listo para LLM), JSON (para canalizaciones estructuradas) y capturas de pantalla (para contexto visual), diseñados para canalizaciones RAG, agentes de investigación de IA y flujos de automatización.
Compatibilidad integrada con destinos populares. Herramientas listas para Google y Bing (SERP), Amazon, Walmart y Target (comercio electrónico), TikTok y YouTube (redes sociales), y ChatGPT y Perplexity (búsqueda con IA).
Infraestructura global de proxies. Más de 115 millones de IP residenciales, más de 195 ubicaciones geográficas y una tasa de éxito del 99,99 %, incluso en los destinos con mayor protección.
Conjuntos de herramientas MCP modulares. Activa solo lo que necesitas: web, search, ecommerce, social_media,
ai para seleccionar herramientas con mayor claridad y mejorar el rendimiento de los agentes.
Resultados rápidos. Desde la clave de API hasta la primera extracción en minutos, sin gastos de configuración.
Casos de uso
Usa el servidor MCP de Decodo cuando necesites extraer datos web para agentes de IA, extraer datos estructurados a escala, acceder de forma fiable a sitios web dinámicos, obtener datos en tiempo real para RAG o disponer de una alternativa a crear una infraestructura de extracción desde cero. Algunos casos habituales:
- Extracción de datos web con IA – permite que los LLM recopilen datos recientes en lugar de depender de datos de entrenamiento estáticos.
- RAG con datos en tiempo real – incorpora resultados de búsqueda en tiempo real de Google, Bing y buscadores con IA a las canalizaciones de recuperación.
- Inteligencia de comercio electrónico – supervisa precios de productos, anuncios y vendedores en distintos mercados sin que te bloqueen.
- Recopilación de datos de redes sociales – recopila publicaciones, canales y datos de interacción de TikTok y YouTube.
- Agregación de viajes y precios – crea herramientas que recopilen precios y disponibilidad en tiempo real de distintos sitios web.
Inicio rápido
- Crea una cuenta gratuita en dashboard.decodo.com – hasta 10K solicitudes gratuitas, sin necesidad de tarjeta de crédito.
- Obtén tu clave de API. Copia la clave de API de Web Data API de tu suscripción a Web Data API en el panel. Los planes antiguos tienen un token de autenticación básica, que también funciona (consulta Autenticación).
- Descarga Node.js 18+ desde https://nodejs.org.
- Obtén un cliente MCP, como Claude Desktop, Cursor, Windsurf u otras herramientas compatibles con MCP.
- Configura el servidor MCP en tu cliente de IA (consulta los ejemplos de configuración a continuación).
Conexión al servidor MCP de Decodo
Abre tu cliente MCP preferido y añade la siguiente configuración (consulta los ejemplos para Claude Code, Cursor y Windsurf a continuación):
{
"mcpServers": {
"Decodo": {
"url": "https://mcp.decodo.com/mcp",
"headers": {
"Authorization": "Bearer <api_key>"
}
}
}
}
Autenticación
| Credencial | Dónde obtenerla | Encabezado del servidor alojado | Entorno del servidor local |
|---|---|---|---|
| Clave de API (recomendada) | Suscripción a Web Data API en el panel | Authorization: Bearer <api_key> | SCRAPER_API_TOKEN=<api_key> |
| Token de autenticación básica (planes antiguos) | Página de Web Scraping API en el panel | Authorization: Basic <basic_auth_token> | SCRAPER_API_TOKEN=<basic_auth_token> |
El servidor local lee cualquiera de las dos credenciales desde SCRAPER_API_TOKEN y determina cuál se ha proporcionado.
Claude Desktop
- Abre Claude Desktop → Settings → Developer → Edit Config.
- Añade lo siguiente a claude_desktop_config.json:
{
"mcpServers": {
"Decodo": {
"command": "npx",
"args": ["-y", "@decodo/mcp-server"],
"env": {
"SCRAPER_API_TOKEN": "<api_key>",
"TOOLSETS": "web,ai"
}
}
}
}
- Guarda los cambios y reinicia Claude Desktop.
Cursor
- Abre Settings → MCP.
- Haz clic en Add a new global MCP server (se abrirá mcp.json).
- Añade la misma configuración que arriba.
- Guarda los cambios y comprueba que aparezca un indicador de estado verde junto a Decodo.
Windsurf
- Abre Settings → Windsurf Settings.
- Desplázate hasta Cascade → Add custom server + (se abrirá mcp_config.json).
- Añade la misma configuración que arriba.
- Guarda los cambios y reinicia Windsurf.
Prueba la configuración
Una vez conectado, prueba esta instrucción en tu cliente:
▎ "Extrae los títulos de los 5 artículos principales de Hacker News"
Deberías recibir una lista estructurada en unos segundos. Si aparece un error de autenticación, comprueba de nuevo tu clave de API en el panel.
Desarrollo local
Solo es necesario si quieres modificar el código del servidor.
Compila y ejecuta el servidor desde este repositorio
Requisitos previos
- Node.js 18.0+
- Un cliente MCP: algunas opciones populares son Claude Desktop y Cursor
Guía paso a paso
- Clona este repositorio:
git clone https://github.com/Decodo/mcp-server
- Ejecuta los siguientes comandos en la terminal:
cd mcp-server
npm install
npm run build
- Anota la ubicación de la compilación:
cd build/
pwd
Al añadir index.js al final de este directorio, la ubicación del archivo compilado debería ser similar a
esta:
/Users/your.user/projects/mcp-server/build/index.js
- Actualiza la información del servidor en tu cliente MCP:
{
"mcpServers": {
"decodo-mcp": {
"command": "node",
"args": ["/Users/your.user/projects/mcp-server/build/index.js"],
"env": {
"SCRAPER_API_TOKEN": "<api_key>"
}
}
}
}
Conjuntos de herramientas
Las herramientas están organizadas en conjuntos. Los que obtengas dependerán de cómo te conectes.
Claude (conector oficial)
El conector de Decodo en el directorio de conectores de Claude solo incluye las herramientas de Web Data API:
| Conjunto de herramientas | Herramientas |
|---|---|
web | scrape_as_markdown, screenshot, map, crawl_start, crawl_status, crawl_results, crawl_cancel |
search | search |
Cualquier cliente MCP
Puedes activar conjuntos de herramientas específicos de forma selectiva pasando una lista separada por comas mediante el parámetro de consulta toolsets:
"Decodo MCP Server": {
"url": "https://mcp.decodo.com/mcp?toolsets=web,ai",
"headers": {
"Authorization": "Bearer <api_key>"
}
}
Si no se especifica ningún conjunto de herramientas, se registran todas las herramientas.
| Conjunto de herramientas | Herramientas |
|---|---|
web | scrape_as_markdown, screenshot, map, crawl_start, crawl_status, crawl_results, crawl_cancel |
search | search, google_search, google_ads, google_lens, google_travel_hotels, bing_search |
ecommerce | amazon_search, amazon_product, amazon_pricing, amazon_sellers, amazon_bestsellers, walmart_search, walmart_product, target_search, target_product, tiktok_shop_search, tiktok_shop_product, tiktok_shop_url |
social_media | tiktok_post, youtube_metadata, youtube_channel, youtube_subtitles, youtube_search |
ai | chatgpt, perplexity, google_ai_mode |
Herramientas
El servidor ofrece las siguientes herramientas:
| Herramienta | Descripción | Ejemplo de prompt |
|---|---|---|
scrape_as_markdown | Extrae datos de cualquier URL de destino; espera que se proporcione una URL mediante el prompt. Devuelve los resultados en Markdown. | Extrae datos de peacock.com desde una dirección IP de EE. UU. y dime los precios. |
screenshot | Captura una captura de pantalla de cualquier página web y la devuelve como imagen PNG. | Haz una captura de pantalla de github.com desde una dirección IP de EE. UU. |
map | Enumera las URL de un sitio web sin obtener su contenido. Solo con clave de API. | Mapea docs.decodo.com y enumera las páginas de /scraping-api. |
crawl_start | Inicia el rastreo de un sitio web y devuelve el ID del rastreo sin esperar. Solo con clave de API. | Rastrea las primeras 10 páginas de decodo.com/blog. |
crawl_status | Informa del progreso de un rastreo: páginas descubiertas, completadas y fallidas. Solo con clave de API. | ¿Ya terminó mi rastreo? |
crawl_results | Devuelve las páginas rastreadas en Markdown, unas pocas cada vez y con un cursor. Solo con clave de API. | Muéstrame las páginas que encontró mi rastreo. |
crawl_cancel | Detiene un rastreo en curso; las páginas rastreadas hasta ese momento siguen siendo legibles. Solo con clave de API. | Cancela mi rastreo. |
search | Busca en la web y devuelve resultados ordenados por relevancia. Solo con clave de API. | Busca en la web opciones de alojamiento para servidores MCP. |
google_search | Extrae datos de Google Search para una consulta determinada y devuelve resultados analizados. | Extrae datos de Google Search sobre zapatos y dime cuál es el resultado en primera posición. |
google_ads | Extrae datos de los resultados de búsqueda de Google Ads. | Extrae datos de Google Ads sobre portátiles y muéstrame los anuncios principales. |
google_lens | Extrae datos de los resultados de búsqueda de imágenes de Google Lens. | Busca esta imagen en Google Lens: https://example.com/image.jpg |
google_ai_mode | Extrae datos de los resultados de Google AI Mode (búsqueda con IA). | Pregunta a Google AI Mode: ¿Cuáles son las tres razas de perros más populares? |
google_travel_hotels | Extrae datos de los resultados de búsqueda de hoteles de Google Travel Hotels. | Busca hoteles en París en Google Travel Hotels. |
amazon_search | Extrae datos de Amazon Search para una consulta determinada y devuelve resultados analizados. | Extrae datos de Amazon Search sobre teclados inalámbricos. |
amazon_product | Extrae datos de una página de producto de Amazon. | Extrae datos del producto de Amazon B09H74FXNW y muéstrame los detalles. |
amazon_pricing | Extrae información sobre los precios de productos de Amazon. | Obtén los precios del producto de Amazon B09H74FXNW. |
amazon_sellers | Extrae información de vendedores de Amazon. | Obtén información sobre el vendedor de Amazon A1R0Z7FJGTKESH. |
amazon_bestsellers | Extrae datos de la lista de productos más vendidos de Amazon. | Muéstrame los productos electrónicos más vendidos en Amazon. |
walmart_search | Extrae datos de Walmart Search para una consulta determinada y devuelve resultados analizados. | Extrae datos de Walmart Search sobre tiendas de campaña. |
walmart_product | Extrae datos de una página de producto de Walmart. | Extrae datos del producto de Walmart 15296401808. |
target_search | Extrae datos de Target Search para una consulta determinada y devuelve resultados analizados. | Extrae datos de Target Search sobre electrodomésticos de cocina. |
target_product | Extrae datos de una página de producto de Target. | Extrae datos del producto de Target 92186007. |
tiktok_post | Extrae datos estructurados de una URL de publicación de TikTok (p. ej., interacción, descripción, hashtags). | Extrae datos de esta publicación de TikTok: https://www.tiktok.com/@nba/video/7393013274725403950 |
tiktok_shop_search | Extrae datos de TikTok Shop Search para una consulta determinada y devuelve resultados analizados. | Extrae datos de TikTok Shop Search sobre fundas para teléfonos. |
tiktok_shop_product | Extrae datos de una página de producto de TikTok Shop. | Extrae datos del producto de TikTok Shop 1731541214379741272. |
tiktok_shop_url | Extrae datos de una página de TikTok Shop mediante su URL. | Extrae datos de esta URL de TikTok Shop: https://www.tiktok.com/shop/s?q=HEADPHONES |
youtube_metadata | Extrae metadatos de vídeos de YouTube. | Obtén los metadatos del vídeo de YouTube dFu9aKJoqGg. |
youtube_channel | Extrae datos de los vídeos de un canal de YouTube. | Extrae datos del canal de YouTube @decodo_official. |
youtube_subtitles | Extrae los subtítulos de vídeos de YouTube. | Obtén los subtítulos del vídeo de YouTube L8zSWbQN-v8. |
youtube_search | Busca vídeos en YouTube. | Busca en YouTube «Cómo cuidar chinchillas». |
bing_search | Extrae datos de los resultados de búsqueda de Bing. | Busca reseñas de portátiles en Bing. |
chatgpt | Envía un único prompt a ChatGPT y devuelve su respuesta (sin historial de conversación). | Pide a ChatGPT que explique la computación cuántica en términos sencillos. |
perplexity | Envía un único prompt a Perplexity y devuelve su respuesta (sin historial de conversación). | Pregunta a Perplexity cuáles son las últimas tendencias en desarrollo web. |
Parámetros
Los siguientes parámetros se infieren de los prompts del usuario:
| Parámetro | Descripción |
|---|---|
jsRender | Renderiza la URL de destino en un navegador sin interfaz gráfica. |
geo | Establece el país desde el que se originará la solicitud. |
locale | Establece la configuración regional de la solicitud. |
tokenLimit | Número máximo de caracteres que se devolverán (valor predeterminado: 45000). Útil si la ventana de contexto es pequeña. |
prompt | Prompt que se enviará a las herramientas de IA (chatgpt, perplexity). |
search | Activa la función de búsqueda web de ChatGPT (solo chatgpt). |
xhr | Si es true, incluye las respuestas XHR o fetch en el resultado de extracción cuando sea compatible (p. ej., tiktok_post). |
deviceType | Tipo de dispositivo que se emulará (desktop, mobile, tablet). Los destinos analizados tienen restricciones más estrictas: las herramientas de Amazon solo funcionan en escritorio, por lo que omiten este parámetro, y bing_search/google_ai_mode solo aceptan desktop y mobile. |
domain | Dominio que se usará para la solicitud (p. ej., amazon.com, amazon.co.uk, bing.com). |
pageFrom | Número de página inicial para la paginación. |
deliveryZip | Código postal del lugar de entrega (Target, Walmart). |
storeId | ID de tienda para el inventario local (Walmart). |
country | País para las solicitudes de TikTok Shop. |
limit | Número máximo de resultados que se devolverán (p. ej., vídeos de un canal de YouTube). |
language_code | Código de idioma de los subtítulos (p. ej., en, es). |
Ejemplos
Extraer contenido con restricciones geográficas
Consulta a tu agente de IA con el siguiente prompt:
Scrape peacock.com from a German IP address and tell me the pricing.
Este prompt indicará que peacock.com tiene restricciones geográficas. Para eludirlas:
Scrape peacock.com from a US IP address and tell me the pricing.
Limitar el número de tokens de respuesta
Si tu agente tiene una ventana de contexto pequeña, el contenido devuelto por la extracción se truncará automáticamente para evitar que se supere el límite de contexto. Puedes aumentar el número de tokens devueltos en tu prompt:
Scrape hacker news, return 50k tokens.
Si tu agente tiene una ventana de contexto amplia, dile que devuelva full content:
Scrape hacker news, return full content.
Usar con las habilidades de agente de Decodo
Este servidor proporciona a tu agente las herramientas de scraping.
Decodo/agent-skills le enseña cuándo recurrir a ellas,
qué interfaz usar y cómo invocarlas, para que el agente elija por sí mismo la herramienta y
los parámetros adecuados en lugar de adivinarlos.
Las habilidades funcionan con la CLI de decodo, este servidor MCP alojado y la API HTTP sin procesar, y recurren
automáticamente al servidor MCP cuando no hay un shell disponible. Al combinar ambos, tu agente obtiene
tanto la capa de ejecución (este servidor) como la capa de decisión (las habilidades) en una sola configuración.
Inicio rápido (Claude Code):
/plugin marketplace add Decodo/agent-skills
/plugin install decodo@decodo-skills
Consulta el README de agent-skills para ver las instrucciones de instalación manual y otros agentes (Cursor, Codex, Gemini CLI, Windsurf).
Repositorios relacionados
Web Scraping API, Habilidades de agente de Decodo, Habilidad de Decodo para OpenClaw
Pruébalo
Integra Decodo MCP Server en tu flujo de trabajo de IA con solo unos clics y proporciona a tus agentes de IA datos en tiempo real de cualquier sitio web.
Empieza gratis | Documentación | Discord
Licencia
Todo el código se publica bajo la Licencia MIT.
