> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olostep.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integración de Olostep + Raycast

> Añade scraping web, búsqueda, rastreo y respuestas de IA a Raycast AI con el servidor oficial Olostep MCP

Raycast es el lanzador de productividad utilizado por desarrolladores, operadores y usuarios avanzados de IA. Con el soporte nativo de Raycast para el Model Context Protocol (MCP), el **servidor oficial Olostep MCP** se conecta directamente a Raycast AI, proporcionando a tu lanzador herramientas de datos web en vivo que puedes llamar desde AI Chat, Quick AI y AI Commands con una simple mención `@olostep`.

Olostep es una [entrada oficial en el registro MCP de Raycast](https://www.raycast.com/), por lo que puedes añadirlo en un par de clics, sin necesidad de editar archivos de configuración.

## Características

El Servidor Olostep MCP da acceso a tu Raycast AI a las capacidades principales de datos web de Olostep:

<CardGroup cols={2}>
  <Card title="Extraer Sitio Web" icon="file-lines">
    Extrae contenido de cualquier URL individual como Markdown, HTML, JSON o texto, con renderizado de JavaScript y orientación por país.
  </Card>

  <Card title="Buscar en la Web" icon="magnifying-glass">
    Realiza una búsqueda en la web y obtén resultados estructurados basados en un analizador (títulos, URLs, fragmentos).
  </Card>

  <Card title="Respuestas (IA)" icon="sparkles">
    Haz una pregunta en lenguaje natural y obtén una respuesta basada en la web con fuentes citadas y salida estructurada opcional.
  </Card>

  <Card title="Extraer URLs en Lote" icon="layer-group">
    Procesa hasta 10,000 URLs en un solo trabajo paralelo, ideal para extracción a gran escala.
  </Card>

  <Card title="Rastrear Sitios Web" icon="spider-web">
    Comienza desde una URL, sigue enlaces y extrae sitios completos o secciones automáticamente.
  </Card>

  <Card title="Mapear URLs del Sitio" icon="map">
    Descubre cada URL en un sitio sin extraer, perfecto para planificar un rastreo o trabajo en lote.
  </Card>
</CardGroup>

## Antes de empezar

* **Una clave API de Olostep:** [obtén una gratis](https://olostep.com/dashboard/api-keys), no se requiere tarjeta de crédito. Tus primeros 500 créditos están incluidos.
* **Raycast instalado**, con [Raycast AI](https://manual.raycast.com/ai) disponible en tu plan. Las herramientas MCP se ejecutan a través de Raycast AI (AI Chat, Quick AI y AI Commands).

<Note>
  Olostep soporta dos modos de conexión. El **endpoint alojado** (`https://mcp.olostep.com/mcp`) utiliza un encabezado `Authorization: Bearer YOUR_API_KEY`. La opción **local stdio** (`npx -y olostep-mcp`) utiliza `OLOSTEP_API_KEY` como variable de entorno. Elige uno: mezclar los dos modos de autenticación es el error de configuración más común.
</Note>

## Instalación

<Steps>
  <Step title="Obtén tu clave API">
    Copia tu clave desde el [tablero de Olostep](https://olostep.com/dashboard/api-keys). La pegarás en Raycast en el siguiente paso.
  </Step>

  <Step title="Instala Olostep en Raycast (recomendado)">
    Dado que Olostep es una entrada oficial en el registro MCP de Raycast, el camino más rápido es de un clic:

    1. Instala la extensión **Model Context Protocol Registry** desde la Tienda Raycast (busca "MCP" o "Model Context Protocol").
    2. Ejecuta el comando **Search Servers**, busca **Olostep** y selecciónalo.
    3. Elige **Install**, luego ingresa tu clave API de Olostep cuando se te solicite.

    Raycast guarda la configuración, inicia la conexión y carga las herramientas automáticamente.
  </Step>

  <Step title="O añádelo manualmente">
    ¿Prefieres configurarlo tú mismo? Abre Raycast, ejecuta **Install MCP Server** (o **Manage MCP Servers → Install New Server**) y completa el formulario con estos valores:

    * **Name:** `olostep`
    * **Transport:** HTTP
    * **URL:** `https://mcp.olostep.com/mcp`
    * **HTTP Header:** `Authorization` → `Bearer YOUR_API_KEY`

    Presiona **Install MCP Server** (`⌘` / `Ctrl` + `↵`).

    <Accordion title="¿Prefieres una instalación local? (stdio)">
      Elige **Standard Input/Output** como el transporte en su lugar, y usa:

      * **Command:** `npx`
      * **Arguments:** `-y olostep-mcp`
      * **Environment:** `OLOSTEP_API_KEY` → `YOUR_API_KEY`

      Requiere Node.js 18+ en tu máquina. Si el comando depende de algo en tu `PATH`, reinicia Raycast después de actualizar tus variables de entorno para que se tomen los nuevos valores.
    </Accordion>
  </Step>

  <Step title="Verifica y comienza a usarlo">
    Abre el comando **Manage MCP Servers** — `olostep` debería aparecer como **Running** con sus **10 herramientas**. Luego, en AI Chat o Quick AI, escribe `@olostep` para delimitar una solicitud a él:

    ```txt theme={null}
    @olostep encuentra los precios más recientes en estas tres páginas de competidores y resúmelo
    ```
  </Step>
</Steps>

## Herramientas disponibles

En Raycast invocas herramientas en lenguaje natural: menciona `@olostep`, describe lo que quieres, y Raycast AI elige la herramienta correcta. Los ejemplos a continuación muestran indicaciones típicas.

### scrape\_website

Extrae contenido de una sola URL en Markdown, HTML, JSON o texto. Maneja páginas renderizadas con JavaScript y soporta orientación por país y analizadores especializados.

```txt theme={null}
@olostep scrape https://example.com/pricing y dame el markdown limpio
```

### search\_web

Realiza una búsqueda en la web y devuelve resultados estructurados para una consulta.

```txt theme={null}
@olostep busca las últimas noticias sobre la regulación de IA en la UE
```

### answers

Obtén una respuesta generada por IA a una pregunta, basada en datos web reales y devuelta con fuentes citadas. Pide una forma específica para obtener una salida estructurada.

```txt theme={null}
@olostep ¿cuáles son los 5 principales competidores de Notion para documentación técnica? Devuelve nombre, página de inicio y una descripción de una línea, con fuentes.
```

### batch\_scrape\_urls

Extrae una lista conocida de URLs en un solo trabajo paralelo (hasta 10,000). Se ejecuta de forma asíncrona y devuelve un trabajo que recuperas una vez que se completa.

```txt theme={null}
@olostep extrae estas 200 URLs de productos y devuelve el título y el precio de cada uno como JSON
```

### create\_crawl

Comienza desde una URL, sigue sus enlaces y extrae páginas coincidentes a través de un sitio completo o sección. Se ejecuta de forma asíncrona.

```txt theme={null}
@olostep rastrea https://docs.stripe.com bajo /docs y resume cada sección como markdown
```

### create\_map

Lista cada URL en un sitio sin extraer contenido, útil para el descubrimiento antes de un rastreo o trabajo en lote.

```txt theme={null}
@olostep mapea todas las URLs bajo https://example.com/blog
```

<Note>
  **Batch y crawl se ejecutan de forma asíncrona.** Cada uno inicia un trabajo y devuelve un ID, que Raycast recupera con su herramienta complementaria (`get_batch_results`, `get_crawl_results`). Junto con `get_webpage_content` y `get_website_urls`, el servidor expone **10 herramientas** en total. Consulta la [referencia del Servidor Olostep MCP](/integrations/mcp-server) para la lista completa y parámetros.
</Note>

## Ejemplos de flujos de trabajo

### Investigación rápida de competidores

Desde AI Chat, recopila y sintetiza datos web en una sola indicación:

```txt theme={null}
@olostep busca las principales herramientas de gestión de proyectos en 2026, luego usa respuestas
para resumir las 3 más mencionadas con sus precios y una fuente para cada una.
```

### Convierte una página en notas limpias

```txt theme={null}
@olostep extrae https://example.com/blog/post y dame un resumen de 5 puntos
más las citas clave.
```

### Guárdalo como un Comando de IA reutilizable

Una vez que Olostep está conectado, puedes integrar una indicación en un [Comando de IA](https://manual.raycast.com/ai) de un solo toque. Por ejemplo, crea un comando llamado **"Resumir URL"** con la instrucción:

```txt theme={null}
Usando @olostep, extrae {argument} como markdown y devuelve un resumen de 3 párrafos
cubriendo de qué trata la página, los detalles clave y cualquier precio.
```

Ahora puedes ejecutarlo desde cualquier lugar en Raycast con una URL y obtener un resumen instantáneo.

## Solución de problemas

<AccordionGroup>
  <Accordion title="El servidor aparece como Running pero lista 0 herramientas">
    Tu clave API es inválida o está limitada por tasa. Verifícala en el [tablero de Olostep](https://olostep.com/dashboard/api-keys). Para el endpoint alojado, el encabezado debe ser exactamente `Authorization: Bearer YOUR_API_KEY` — sin comillas alrededor del valor y sin espacios adicionales.
  </Accordion>

  <Accordion title="Olostep no aparece después de instalar">
    Abre **Manage MCP Servers** y verifica el estado del servidor. Si está en estado **Error**, el panel de detalles muestra la salida completa del servidor o transporte. Revisa la URL/encabezado (HTTP) o comando/entorno (stdio), luego usa la acción **Restart**.
  </Accordion>

  <Accordion title="La instalación local (stdio) no se inicia">
    Asegúrate de que Node.js 18+ esté instalado y en tu `PATH`. Después de instalar o cambiar variables de entorno, reinicia completamente Raycast para que se tomen los nuevos valores. En Windows, asegúrate de que `npx` se resuelva en el shell que Raycast lanza.
  </Accordion>

  <Accordion title="El endpoint alojado no se conecta">
    Confirma que `https://mcp.olostep.com/mcp` sea accesible desde tu red (los proxies corporativos y firewalls pueden bloquearlo). Si está bloqueado, cambia a la instalación local stdio, que se conecta a `api.olostep.com` en su lugar.
  </Accordion>

  <Accordion title="La herramienta no se está usando en una respuesta">
    Asegúrate de mencionar `@olostep` en el mensaje (en AI Chat o Quick AI), y que la solicitud claramente requiera datos web. Puedes delimitar una pregunta al servidor escribiendo `@` y seleccionándolo.
  </Accordion>
</AccordionGroup>

## Aprende más

<CardGroup cols={2}>
  <Card title="Raycast" icon="link" href="https://www.raycast.com">
    El lanzador Raycast
  </Card>

  <Card title="Manual de Raycast MCP" icon="book" href="https://manual.raycast.com/ai/model-context-protocol">
    Cómo Raycast conecta y gestiona servidores MCP
  </Card>

  <Card title="Servidor Olostep MCP" icon="server" href="/integrations/mcp-server">
    Configuración completa de MCP, referencia de herramientas y parámetros
  </Card>

  <Card title="Repositorio del Servidor MCP" icon="github" href="https://github.com/olostep/olostep-mcp-server">
    Fuente, problemas y notas de lanzamiento
  </Card>
</CardGroup>

## Relacionados

<CardGroup cols={2}>
  <Card title="API de Scrapes" icon="file-lines" href="/features/scrapes">
    Referencia completa para el endpoint de extracción
  </Card>

  <Card title="API de Batches" icon="layer-group" href="/features/batches">
    Cómo funcionan los trabajos en lote y cómo recuperar resultados
  </Card>

  <Card title="API de Crawls" icon="spider-web" href="/features/crawls">
    Configuración de rastreo y recuperación de resultados
  </Card>

  <Card title="API de Maps" icon="map" href="/features/maps">
    Descubrimiento de URLs y opciones de filtrado
  </Card>
</CardGroup>

## Comienza

¿Listo para llevar datos web en vivo a Raycast?

<CardGroup cols={2}>
  <Card title="Obtén una clave API gratuita" icon="key" href="https://olostep.com/dashboard/api-keys">
    Regístrate y obtén tu clave API de Olostep — 500 créditos incluidos
  </Card>

  <Card title="Explora servidores MCP de Raycast" icon="store" href="https://www.raycast.com">
    Encuentra Olostep y otros servidores en el registro MCP de Raycast
  </Card>
</CardGroup>

Conecta Olostep con Raycast y pon el scraping web, la búsqueda y el rastreo a un `@olostep` de distancia.