Decodo

oficial

Acceso 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

Install MCP Server

Decodo: one-click web access for your AI agents

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

  1. Crea una cuenta gratuita en dashboard.decodo.com – hasta 10K solicitudes gratuitas, sin necesidad de tarjeta de crédito.
  2. 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).
  3. Descarga Node.js 18+ desde https://nodejs.org.
  4. Obtén un cliente MCP, como Claude Desktop, Cursor, Windsurf u otras herramientas compatibles con MCP.
  5. 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

CredencialDónde obtenerlaEncabezado del servidor alojadoEntorno del servidor local
Clave de API (recomendada)Suscripción a Web Data API en el panelAuthorization: Bearer <api_key>SCRAPER_API_TOKEN=<api_key>
Token de autenticación básica (planes antiguos)Página de Web Scraping API en el panelAuthorization: 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

  1. Abre Claude Desktop → Settings → Developer → Edit Config.
  2. 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"
      }
    }
  }
}
  1. Guarda los cambios y reinicia Claude Desktop.

Cursor

  1. Abre Settings → MCP.
  2. Haz clic en Add a new global MCP server (se abrirá mcp.json).
  3. Añade la misma configuración que arriba.
  4. Guarda los cambios y comprueba que aparezca un indicador de estado verde junto a Decodo.

Windsurf

  1. Abre Settings → Windsurf Settings.
  2. Desplázate hasta Cascade → Add custom server + (se abrirá mcp_config.json).
  3. Añade la misma configuración que arriba.
  4. 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

Guía paso a paso

  1. Clona este repositorio:
git clone https://github.com/Decodo/mcp-server
  1. Ejecuta los siguientes comandos en la terminal:
cd mcp-server
npm install
npm run build
  1. 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
  1. 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 herramientasHerramientas
webscrape_as_markdown, screenshot, map, crawl_start, crawl_status, crawl_results, crawl_cancel
searchsearch

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 herramientasHerramientas
webscrape_as_markdown, screenshot, map, crawl_start, crawl_status, crawl_results, crawl_cancel
searchsearch, google_search, google_ads, google_lens, google_travel_hotels, bing_search
ecommerceamazon_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_mediatiktok_post, youtube_metadata, youtube_channel, youtube_subtitles, youtube_search
aichatgpt, perplexity, google_ai_mode

Herramientas

El servidor ofrece las siguientes herramientas:

HerramientaDescripciónEjemplo de prompt
scrape_as_markdownExtrae 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.
screenshotCaptura 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.
mapEnumera 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_startInicia 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_statusInforma del progreso de un rastreo: páginas descubiertas, completadas y fallidas. Solo con clave de API.¿Ya terminó mi rastreo?
crawl_resultsDevuelve 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_cancelDetiene un rastreo en curso; las páginas rastreadas hasta ese momento siguen siendo legibles. Solo con clave de API.Cancela mi rastreo.
searchBusca 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_searchExtrae 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_adsExtrae 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_lensExtrae 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_modeExtrae 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_hotelsExtrae datos de los resultados de búsqueda de hoteles de Google Travel Hotels.Busca hoteles en París en Google Travel Hotels.
amazon_searchExtrae datos de Amazon Search para una consulta determinada y devuelve resultados analizados.Extrae datos de Amazon Search sobre teclados inalámbricos.
amazon_productExtrae datos de una página de producto de Amazon.Extrae datos del producto de Amazon B09H74FXNW y muéstrame los detalles.
amazon_pricingExtrae información sobre los precios de productos de Amazon.Obtén los precios del producto de Amazon B09H74FXNW.
amazon_sellersExtrae información de vendedores de Amazon.Obtén información sobre el vendedor de Amazon A1R0Z7FJGTKESH.
amazon_bestsellersExtrae datos de la lista de productos más vendidos de Amazon.Muéstrame los productos electrónicos más vendidos en Amazon.
walmart_searchExtrae datos de Walmart Search para una consulta determinada y devuelve resultados analizados.Extrae datos de Walmart Search sobre tiendas de campaña.
walmart_productExtrae datos de una página de producto de Walmart.Extrae datos del producto de Walmart 15296401808.
target_searchExtrae datos de Target Search para una consulta determinada y devuelve resultados analizados.Extrae datos de Target Search sobre electrodomésticos de cocina.
target_productExtrae datos de una página de producto de Target.Extrae datos del producto de Target 92186007.
tiktok_postExtrae 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_searchExtrae 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_productExtrae datos de una página de producto de TikTok Shop.Extrae datos del producto de TikTok Shop 1731541214379741272.
tiktok_shop_urlExtrae 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_metadataExtrae metadatos de vídeos de YouTube.Obtén los metadatos del vídeo de YouTube dFu9aKJoqGg.
youtube_channelExtrae datos de los vídeos de un canal de YouTube.Extrae datos del canal de YouTube @decodo_official.
youtube_subtitlesExtrae los subtítulos de vídeos de YouTube.Obtén los subtítulos del vídeo de YouTube L8zSWbQN-v8.
youtube_searchBusca vídeos en YouTube.Busca en YouTube «Cómo cuidar chinchillas».
bing_searchExtrae datos de los resultados de búsqueda de Bing.Busca reseñas de portátiles en Bing.
chatgptEnví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.
perplexityEnví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ámetroDescripción
jsRenderRenderiza la URL de destino en un navegador sin interfaz gráfica.
geoEstablece el país desde el que se originará la solicitud.
localeEstablece la configuración regional de la solicitud.
tokenLimitNúmero máximo de caracteres que se devolverán (valor predeterminado: 45000). Útil si la ventana de contexto es pequeña.
promptPrompt que se enviará a las herramientas de IA (chatgpt, perplexity).
searchActiva la función de búsqueda web de ChatGPT (solo chatgpt).
xhrSi es true, incluye las respuestas XHR o fetch en el resultado de extracción cuando sea compatible (p. ej., tiktok_post).
deviceTypeTipo 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.
domainDominio que se usará para la solicitud (p. ej., amazon.com, amazon.co.uk, bing.com).
pageFromNúmero de página inicial para la paginación.
deliveryZipCódigo postal del lugar de entrega (Target, Walmart).
storeIdID de tienda para el inventario local (Walmart).
countryPaís para las solicitudes de TikTok Shop.
limitNúmero máximo de resultados que se devolverán (p. ej., vídeos de un canal de YouTube).
language_codeCó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.