Olostep MCP Server

El servidor MCP de Olostep proporciona a cualquier cliente AI compatible con MCP (Claude, Cursor, Windsurf, VS Code, Claude Code, etc.) 10 herramientas listas para usar en la web en vivo: scraping, búsqueda, respuestas AI con citas, trabajos por lotes, rastreo de sitios y descubrimiento de URLs.

Extraer y raspar

Extrae markdown, HTML, JSON o texto de cualquier URL con renderizado JS opcional

Respuestas AI

Respuestas basadas en la web con fuentes y salida estructurada

Lote y rastreo

Hasta 100k URLs en paralelo, o descubre un sitio completo de manera autónoma

Mapa y búsqueda

Encuentra cada URL en un sitio, o realiza una búsqueda web basada en un analizador

Antes de comenzar

Necesitas una clave API de Olostep. Obtén una desde el panel de control de Olostep — el nivel gratuito cubre el uso personal.

Elige una ruta de configuración

La ruta más rápida para cada cliente es el endpoint alojado en https://mcp.olostep.com/mcp. Sin instalaciones, sin Node, sin Docker — solo pega una URL y tu clave API. Si necesitas que funcione completamente local (uso sin conexión, proxy corporativo, aislado), cada cliente también admite una instalación local stdio a través de npx. Cada sección a continuación muestra ambos.

Endpoint alojado usa Authorization: Bearer YOUR_API_KEY. Local stdio usa OLOSTEP_API_KEY como una variable de entorno. No los mezcles — el modo de autenticación incorrecto es el error de incorporación #1.

Configuración del cliente

Instalación con un clic (recomendada):

Reemplaza YOUR_API_KEY en la configuración resultante con tu clave real.Configuración manual:Crea o edita .cursor/mcp.json en la raíz de tu proyecto (o ~/.cursor/mcp.json para global):

{
  "mcpServers": {
    "olostep": {
      "url": "https://mcp.olostep.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Instalación local stdio (opcional)

{
  "mcpServers": {
    "olostep": {
      "command": "npx",
      "args": ["-y", "olostep-mcp"],
      "env": {
        "OLOSTEP_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Requiere Node.js 18+ en tu máquina.

Verificar: Abre Cursor → Configuración → MCP. Deberías ver olostep listado con 10 herramientas incluyendo scrape_website. Si ves “Conectado, 0 herramientas”, tu clave API es incorrecta.

Instalación CLI (recomendada):

claude mcp add --transport http olostep https://mcp.olostep.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Configuración manual:Agrega a tu configuración MCP de Claude Code (.mcp.json en la raíz del proyecto, o ~/.claude.json globalmente):

{
  "mcpServers": {
    "olostep": {
      "url": "https://mcp.olostep.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Instalación local stdio (opcional)

claude mcp add --transport stdio --env OLOSTEP_API_KEY=YOUR_API_KEY olostep \
  -- npx -y olostep-mcp

O como JSON:

{
  "mcpServers": {
    "olostep": {
      "command": "npx",
      "args": ["-y", "olostep-mcp"],
      "env": {
        "OLOSTEP_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Verificar: Ejecuta /mcp en Claude Code. Deberías ver olostep conectado con 10 herramientas.

Ubicación del archivo de configuración:

SO	Ruta
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

Alojado (recomendado):

{
  "mcpServers": {
    "olostep": {
      "url": "https://mcp.olostep.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Instalación local stdio (opcional)

{
  "mcpServers": {
    "olostep": {
      "command": "npx",
      "args": ["-y", "olostep-mcp"],
      "env": {
        "OLOSTEP_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

O instala a través de Smithery:

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

Claude Desktop debe ser completamente cerrado y relanzado para que los cambios en la configuración tengan efecto — cerrar la ventana no es suficiente (sigue ejecutándose en la barra de menú / bandeja del sistema).

Verificar: Abre Claude Desktop → busca el icono 🔨 (martillo) en el campo de entrada de chat. Haz clic en él — deberías ver 10 herramientas de Olostep listadas.

El soporte MCP de VS Code está integrado en GitHub Copilot (modo Agente). Agrega esto a .vscode/mcp.json en tu proyecto, o a tu settings.json de usuario:

{
  "servers": {
    "olostep": {
      "type": "http",
      "url": "https://mcp.olostep.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Instalación local stdio (opcional)

{
  "servers": {
    "olostep": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "olostep-mcp"],
      "env": {
        "OLOSTEP_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Verificar: Abre el panel de chat de Copilot → cambia al modo Agente → el menú emergente de herramientas debería listar las herramientas de Olostep.

Agrega a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "olostep": {
      "serverUrl": "https://mcp.olostep.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Instalación local stdio (opcional)

{
  "mcpServers": {
    "olostep": {
      "command": "npx",
      "args": ["-y", "olostep-mcp"],
      "env": {
        "OLOSTEP_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Verificar: Cascade → Configuración → MCP. olostep debería aparecer con 10 herramientas.

Si prefieres ejecutar el servidor en un contenedor (CI, entorno aislado, sin Node en el host):

docker pull olostep/mcp-server

docker run -i --rm \
  -e OLOSTEP_API_KEY="YOUR_API_KEY" \
  olostep/mcp-server

En una configuración de cliente MCP (stdio):

{
  "mcpServers": {
    "olostep": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "OLOSTEP_API_KEY=YOUR_API_KEY",
        "olostep/mcp-server"
      ]
    }
  }
}

Soporta linux/amd64 y linux/arm64. Fuente en GitHub.

Abre el panel de Metorial
Navega a Servidores MCP
Busca Olostep
Haz clic en Instalar y pega tu clave API

Para configuración manual:

{
  "olostep": {
    "command": "npx",
    "args": ["-y", "olostep-mcp"],
    "env": {
      "OLOSTEP_API_KEY": "YOUR_API_KEY"
    }
  }
}

Elegir la herramienta adecuada

El servidor MCP expone 10 herramientas. Usa este árbol de decisiones para elegir la correcta — el agente utiliza el mismo razonamiento:

Quieres…	Usa	Notas
El contenido de una página específica	`scrape_website` o `get_webpage_content`	Configura `wait_before_scraping=2000–5000` para SPAs
Una respuesta web en lenguaje natural con fuentes	`answers`	Devuelve síntesis AI + citas
Resultados de búsqueda para una consulta	`search_web`	Basado en analizador, no AI, estructurado
Una lista de URLs en un sitio	`create_map`	Solo descubrimiento de URLs — NO raspa
URLs filtradas por consulta	`get_website_urls`	Clasificadas por relevancia a tu `search_query`
Muchas URLs conocidas a la vez	`batch_scrape_urls` + `get_batch_results`	Asíncrono — inicia, luego consulta
Un sitio completo o sección	`create_crawl` + `get_crawl_results`	Asíncrono — sigue enlaces desde una URL de inicio

¿Raspar un sitio completo? Usa create_crawl, no batch_scrape_urls. Crawl descubre Y raspa. Batch es para una lista conocida de URLs que ya tienes.

Detalles de las herramientas

scrape_website

Extrae contenido de una sola URL. Soporta markdown, html, json, text. Opcional country para solicitudes geo-dirigidas, wait_before_scraping (0–10000 ms) para sitios con mucho JS, y parser (por ejemplo, @olostep/amazon-product) para extracción estructurada.

get_webpage_content

Versión ligera solo markdown de scrape_website. Úsalo cuando solo quieras markdown limpio y no necesites opciones de formato.

search_web

Resultados de búsqueda web estructurados (basados en analizador) para una consulta. Opcional country para resultados localizados. Devuelve JSON, no prosa AI.

answers

Respuesta impulsada por AI a una task con fuentes y citas. Pasa un argumento json para obtener la respuesta en una forma específica — ya sea un esquema JSON o una breve descripción en lenguaje natural.

batch_scrape_urls

Raspado asíncrono de 2–100k URLs que ya tienes. Devuelve un batch_id — luego llama a get_batch_results para obtener el contenido. Configura wait_for_completion_seconds (hasta 900) si quieres una sola llamada bloqueante en lugar de consultar. Recomendado: 60 para lotes de menos de 50 URLs, 300–600 para 50–1k, 0 (consultar por separado) para lotes más grandes.

get_batch_results

Obtiene el estado y el contenido raspado para un batch_id. Devuelve processing hasta que esté completo, luego completed con el array de elementos.

create_crawl

Rastreo asíncrono que sigue enlaces desde un start_url. Usa include_url_patterns / exclude_url_patterns (sintaxis glob como /blog/**) para delimitar. Devuelve un crawl_id — luego llama a get_crawl_results.

get_crawl_results

Obtiene el estado y las páginas para un crawl_id. Soporta paginación a través de cursor y items_limit (máximo 100 por llamada). Devuelve in_progress hasta que esté completo.

create_map

Obtén una lista de URLs en un sitio. Solo descubrimiento de URLs — no raspa. Úsalo cuando quieras mostrar URLs candidatas (por ejemplo, dejar que el usuario elija un subconjunto). Soporta include_url_patterns / exclude_url_patterns y search_query.

get_website_urls

Como create_map, pero las URLs están clasificadas por relevancia a una search_query requerida. Úsalo cuando quieras los N enlaces más relevantes en un sitio.

Solución de problemas

El servidor aparece pero muestra 0 herramientas

Tu clave API es inválida o está limitada por la tasa. Abre el panel de claves API y verifica la clave. Si usas el endpoint alojado, el encabezado debe ser exactamente Authorization: Bearer sk_... — sin comillas alrededor del valor, sin espacios adicionales.

npx: command not found o command not found: olostep-mcp

Node.js no está instalado (o no está en tu PATH). Instala Node 18+ desde nodejs.org, luego reinicia tu terminal y tu cliente MCP. En Windows, cambia a un CMD/PowerShell que tenga Node en el PATH.

Conexión rechazada o errores DNS en mcp.olostep.com

Probablemente estás detrás de un proxy corporativo o firewall que bloquea el host. Cambia a la instalación local stdio (npx -y olostep-mcp) — hace solicitudes salientes a api.olostep.com en su lugar, lo cual generalmente está permitido.

Configuración editada pero la lista de herramientas está obsoleta

El cliente almacenó en caché la configuración antigua. Cierra completamente y relanza — no solo cierres la ventana. Claude Desktop en particular sigue ejecutándose en la barra de menú / bandeja del sistema.

Fallos específicos de Windows con npx

Si npx falla al lanzar el servidor en Windows, usa la forma envuelta en CMD:

{
  "command": "cmd",
  "args": ["/c", "npx", "-y", "olostep-mcp"],
  "env": { "OLOSTEP_API_KEY": "YOUR_API_KEY" }
}

401 Missing Authorization: Bearer <OLOSTEP_API_KEY>

Accediste al endpoint alojado sin un encabezado de autenticación (o con el formato incorrecto). Agrega el encabezado a la configuración de tu cliente exactamente como se muestra en la pestaña de configuración.

Recetas

Copiar y pegar indicaciones que funcionan bien con las herramientas:

Raspar una lista de URLs de productos: “Tengo un CSV de 200 URLs de productos de Amazon. Ráspalos por lotes con parser=@olostep/amazon-product y devuelve como JSON.”
Rastrear un sitio de documentación: “Rastrea https://stripe.com/docs con max_pages=50 y include_url_patterns=['/docs/**']. Resume cada sección como markdown.”
Encontrar competidores: “Usa answers para encontrar los 5 principales competidores de Notion para sitios de documentación técnica. Devuelve nombre, página de inicio y posicionamiento en una línea.”
Mapear y luego raspar: “Ejecuta create_map en https://example.com filtrado a /blog/**, luego batch_scrape_urls en los 20 mejores resultados.”

Integraciones

Extraer y raspar

Respuestas AI

Lote y rastreo

Mapa y búsqueda

Antes de comenzar

Elige una ruta de configuración

Configuración del cliente

Elegir la herramienta adecuada

Detalles de las herramientas

Solución de problemas

Recetas

Fuente y versiones

Extraer y raspar

Respuestas AI

Lote y rastreo

Mapa y búsqueda

​Antes de comenzar

​Elige una ruta de configuración

​Configuración del cliente

​Elegir la herramienta adecuada

​Detalles de las herramientas

​Solución de problemas

​Recetas

​Fuente y versiones

Antes de comenzar

Elige una ruta de configuración

Configuración del cliente

Elegir la herramienta adecuada

Detalles de las herramientas

Solución de problemas

Recetas

Fuente y versiones