olostep-mcp

by olostep
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides structured data from Google search results through the google_search tool, including organic search results, knowledge graph data, and related questions

  • Supports waiting for JavaScript-heavy websites to render before scraping content, with configurable wait times

  • Retrieves webpage content in clean markdown format for easier consumption and formatting

Servidor MCP de Olostep

Una implementación de servidor de Protocolo de Contexto de Modelo (MCP) que se integra con Olostep para el web scraping, la extracción de contenido y las funciones de búsqueda. Para configurar el Servidor MCP de Olostep, necesita una clave API. Puede obtenerla registrándose en el sitio web de Olostep .

Características

  • Extracción de contenido de páginas web con formato Markdown limpio
  • Resultados de búsqueda de Google con extracción de datos estructurados
  • Descubrimiento y mapeo de URL de sitios web
  • Enrutamiento de solicitudes específicas de cada país para contenido geolocalizado
  • Tiempos de espera configurables para sitios web con mucho JavaScript
  • Gestión y generación de informes de errores integrales
  • Configuración sencilla de clave API

Instalación

Ejecutando con npx

env OLOSTEP_API_KEY=your-api-key npx -y olostep-mcp

Instalación manual

npm install -g olostep-mcp

Ejecutándose en Claude Desktop

Agregue esto a su claude_desktop_config.json :

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

O para una forma más sencilla, puede instalarlo a través de la CLI de Smithery ejecutando el siguiente código en la terminal de su dispositivo.

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

Corriendo en Windsurf

Agregue esto a su ./codeium/windsurf/model_config.json :

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

Ejecutando en el cursor

Para configurar Olostep MCP en Cursor:

  1. Abrir configuración del cursor
  2. Vaya a Características > Servidores MCP
  3. Haga clic en "+ Agregar nuevo servidor MCP"
  4. Introduzca lo siguiente:
    • Nombre: "olostep-mcp" (o el nombre que prefiera)
    • Tipo: "comando"
    • Comando: env OLOSTEP_API_KEY=your-api-key npx -y olostep-mcp

Reemplace your-api-key con su clave API de Olostep.

Configuración

Variables de entorno

  • OLOSTEP_API_KEY : Su clave API de Olostep (obligatoria)

Herramientas disponibles

1. Obtener el contenido de la página web ( get_webpage_content )

Recupera el contenido de la página web en formato Markdown limpio con soporte para renderizado de JavaScript.

{ "name": "get_webpage_content", "arguments": { "url_to_scrape": "https://example.com", "wait_before_scraping": 1000, "country": "US" } }

Parámetros:

  • url_to_scrape : La URL de la página web a raspar (obligatorio)
  • wait_before_scraping : Tiempo de espera en milisegundos antes de iniciar el raspado (predeterminado: 0)
  • country : País de residencia desde el cual cargar la solicitud (por ejemplo, EE. UU., CA, GB) (opcional)

Respuesta:

{ "content": [ { "type": "text", "text": "# Example Website\n\nThis is the markdown content of the webpage..." } ] }

2. Obtener las URL del sitio web ( get_website_urls )

Busque y recupere URL relevantes de un sitio web, ordenadas por relevancia para su consulta.

{ "name": "get_website_urls", "arguments": { "url": "https://example.com", "search_query": "your search term" } }

Parámetros:

  • url : La URL del sitio web a mapear (obligatorio)
  • search_query : La consulta de búsqueda para ordenar las URL (obligatorio)

Respuesta:

{ "content": [ { "type": "text", "text": "Found 42 URLs matching your query:\n\nhttps://example.com/page1\nhttps://example.com/page2\n..." } ] }

Recupere datos estructurados de los resultados de búsqueda de Google.

{ "name": "google_search", "arguments": { "query": "your search query", "country": "US" } }

Parámetros:

  • query : La consulta de búsqueda a realizar (obligatorio)
  • country : código de país para resultados localizados (p. ej., EE. UU., GB) (predeterminado: "EE. UU.")

La respuesta incluye:

  • Resultados de búsqueda orgánicos con títulos, enlaces y fragmentos
  • Datos del gráfico de conocimiento cuando estén disponibles
  • Preguntas relacionadas (La gente también pregunta)
  • Búsquedas relacionadas
  • Fragmentos enriquecidos y otros datos estructurados

Manejo de errores

El servidor proporciona un manejo robusto de errores:

  • Mensajes de error detallados para problemas de API
  • Informe de errores de red
  • Manejo de fallos de autenticación
  • Información sobre el límite de velocidad

Ejemplo de respuesta de error:

{ "isError": true, "content": [ { "type": "text", "text": "Olostep API Error: 401 Unauthorized. Details: {\"error\":\"Invalid API key\"}" } ] }

Licencia

Licencia ISC

ID: ur5ulf3b8e