> ## 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.

# Olostep + ViaSocket

> Conecta Olostep a cualquier cliente de IA — Claude, Cursor, ChatGPT y más — usando ViaSocket Mushrooms como una puerta de enlace MCP.

[ViaSocket Mushrooms](https://mushrooms.viasocket.com/) es una puerta de enlace MCP que conecta aplicaciones como Olostep a cualquier cliente de IA a través de una única URL de punto final MCP. Una vez que conectas Olostep como un Mushroom, puedes instruir a Claude, Cursor, ChatGPT o cualquier otro cliente compatible para extraer información de sitios web, ejecutar trabajos por lotes, rastrear sitios y obtener respuestas fundamentadas en IA — todo en lenguaje sencillo, sin escribir una sola línea de código.

## Antes de comenzar

* **Una cuenta de Olostep con una clave API:** [obtén una gratis](https://olostep.com/dashboard), no se requiere tarjeta de crédito. Tus primeros 500 créditos están incluidos.
* **Una cuenta de ViaSocket:** crea una en [viasocket.com](https://viasocket.com/).
* **Un cliente de IA:** Claude, Cursor, ChatGPT, Windsurf, VS Code, o cualquier cliente compatible con MCP.

***

## Configuración

<Steps>
  <Step title="Crear un nuevo Cluster">
    Abre [ViaSocket Mushrooms](https://mushrooms.viasocket.com/) y haz clic en **+ New Cluster**. ViaSocket te pedirá que elijas el cliente de IA al que se conectará este Cluster — selecciona Claude, Cursor, ChatGPT, o el cliente que uses.

    <img src="https://mintcdn.com/olostep-58/KKS29GiipsPYkgqX/images/integrations/viasocket/step1.png?fit=max&auto=format&n=KKS29GiipsPYkgqX&q=85&s=bab417a61f54c37aaaf33904989bdfa0" alt="Diálogo de Nuevo Cluster en ViaSocket — Elige tu cliente de IA, mostrando Claude, ChatGPT, Cursor, Windsurf y más" width="1570" height="925" data-path="images/integrations/viasocket/step1.png" />
  </Step>

  <Step title="Explorar integraciones">
    Dentro de tu Cluster, haz clic en **+ BROWSE INTEGRATIONS** para abrir la biblioteca de Mushrooms — un catálogo de más de 2,500 aplicaciones a las que puedes dar acceso a tu IA.

    <img src="https://mintcdn.com/olostep-58/KKS29GiipsPYkgqX/images/integrations/viasocket/step2.png?fit=max&auto=format&n=KKS29GiipsPYkgqX&q=85&s=81ae5e623afbc448b5e3500abb80fc61" alt="Panel de control de ViaSocket Mushrooms mostrando el botón de Add New Mushroom y Browse Integrations" width="1570" height="925" data-path="images/integrations/viasocket/step2.png" />
  </Step>

  <Step title="Encontrar Olostep">
    Busca **olostep** en la barra de búsqueda. Selecciona **Olostep** de los resultados.

    <img src="https://mintcdn.com/olostep-58/KKS29GiipsPYkgqX/images/integrations/viasocket/step3.png?fit=max&auto=format&n=KKS29GiipsPYkgqX&q=85&s=9d2381ba7fcf0b86d5a677d69190d183" alt="Buscando olostep en ViaSocket Mushrooms — Olostep aparece en los resultados" width="1570" height="925" data-path="images/integrations/viasocket/step3.png" />
  </Step>

  <Step title="Conectar a Olostep">
    En la página de detalles de Olostep, haz clic en **CONNECT TO OLOSTEP** para autorizar tu cuenta y comenzar a agregar acciones de Olostep a tu Cluster.

    <img src="https://mintcdn.com/olostep-58/KKS29GiipsPYkgqX/images/integrations/viasocket/step4.png?fit=max&auto=format&n=KKS29GiipsPYkgqX&q=85&s=c44dbbf83081c6c718873f98f714f958" alt="Página de detalles de Olostep en ViaSocket mostrando Connect to get started y el botón CONNECT TO OLOSTEP" width="1570" height="925" data-path="images/integrations/viasocket/step4.png" />
  </Step>

  <Step title="Seleccionar acciones">
    Elige qué acciones de Olostep puede usar tu cliente de IA. Las siete están habilitadas por defecto — desactiva las que no necesites, luego haz clic en **NEXT**.

    <img src="https://mintcdn.com/olostep-58/KKS29GiipsPYkgqX/images/integrations/viasocket/step5.png?fit=max&auto=format&n=KKS29GiipsPYkgqX&q=85&s=e9dff05096c805ea38fe1e74635ddc3b" alt="Pantalla de Selección de Acciones de Olostep en ViaSocket mostrando 7 acciones disponibles con interruptores" width="1160" height="777" data-path="images/integrations/viasocket/step5.png" />
  </Step>

  <Step title="Introduce tu clave API de Olostep">
    Pega tu clave API de Olostep en el campo **API Key** y haz clic en **ADD CONNECTION**. ViaSocket verificará la clave y guardará la credencial.

    <img src="https://mintcdn.com/olostep-58/KKS29GiipsPYkgqX/images/integrations/viasocket/step6.png?fit=max&auto=format&n=KKS29GiipsPYkgqX&q=85&s=f89fc74bed9ec314240b79650c792e98" alt="Pantalla de Añadir Nueva Conexión para Olostep en ViaSocket con campo de entrada de clave API" width="931" height="606" data-path="images/integrations/viasocket/step6.png" />

    Obtén tu clave desde el [panel de Olostep →](https://olostep.com/dashboard)
  </Step>

  <Step title="Copia tu punto final MCP y conecta tu cliente de IA">
    Olostep ahora aparece como un Mushroom habilitado en tu Cluster. Copia la **MCP Endpoint URL** (o el bloque de configuración JSON completo) del panel de **Cursor Configuration** y pégalo en el archivo de configuración MCP de tu cliente de IA.

    <img src="https://mintcdn.com/olostep-58/KKS29GiipsPYkgqX/images/integrations/viasocket/step7.png?fit=max&auto=format&n=KKS29GiipsPYkgqX&q=85&s=953ec9de57db4c2e501f254148753466" alt="Cluster de ViaSocket mostrando Olostep habilitado y la URL del punto final MCP con configuración JSON lista para copiar" width="1570" height="925" data-path="images/integrations/viasocket/step7.png" />

    La configuración se ve así — pégala en la configuración de tu cliente de IA:

    ```json theme={null}
    {
      "mcpServers": {
        "viasocket": {
          "type": "http",
          "url": "https://mcp.viasocket.com/mcp/<YOUR-CLUSTER-ID>"
        }
      }
    }
    ```
  </Step>
</Steps>

***

## Acciones

<CardGroup cols={2}>
  <Card title="Extraer Sitio Web" icon="file-lines">
    Extrae contenido de cualquier URL como Markdown, HTML, JSON o texto plano. Maneja páginas renderizadas con JS con tiempos de espera opcionales y orientación por país.
  </Card>

  <Card title="Generar Respuesta de IA" icon="sparkles">
    Haz una pregunta en lenguaje natural y obtén una respuesta citada fundamentada en las páginas que proporciones o en una búsqueda web en vivo.
  </Card>

  <Card title="Extractor de URLs por Lote" icon="layer-group">
    Envía hasta 100,000 URLs en un solo trabajo, procesadas en paralelo. Devuelve un `batch_id` para recuperación asincrónica.
  </Card>

  <Card title="Obtener Elementos de Lote" icon="download">
    Recupera los resultados de un trabajo por lotes completado usando su `batch_id`.
  </Card>

  <Card title="Iniciar Rastreo" icon="spider-web">
    Comienza desde una URL semilla, sigue enlaces y extrae todas las subpáginas. Devuelve un `crawl_id`.
  </Card>

  <Card title="Obtener Información de Rastreo" icon="circle-info">
    Verifica el estado y recupera resultados de un rastreo en curso o completado por `crawl_id`.
  </Card>

  <Card title="Crear Mapa" icon="map">
    Obtén todas las URLs de un sitio sin extraer contenido. Útil para el descubrimiento antes de un trabajo por lotes.
  </Card>
</CardGroup>

***

## Ejemplo: Pedir a Claude que investigue un competidor

Una vez que tu punto final MCP está configurado en Claude, puedes emitir instrucciones en lenguaje sencillo como:

> *"Extrae la página de precios en acme.com/pricing y dame un resumen de sus planes y precios."*

Claude llamará a la acción **Extraer Sitio Web** de Olostep a través de ViaSocket, devolverá el contenido de la página y lo resumirá — sin constructor de flujos de trabajo, sin código.

Puedes encadenar acciones de la misma manera:

> *"Mapea todas las páginas en docs.example.com, luego extrae por lotes las primeras 50 y construye un resumen de base de conocimiento."*

***

## Solución de problemas

<AccordionGroup>
  <Accordion title="Clave API rechazada">
    Copia la clave directamente desde [olostep.com/dashboard](https://olostep.com/dashboard) sin espacios finales. Elimina y recrea la conexión de Olostep en ViaSocket si el error persiste.
  </Accordion>

  <Accordion title="El cliente de IA no puede ver las herramientas de Olostep">
    Asegúrate de haber pegado la URL del punto final MCP (o el bloque de configuración JSON) en el archivo de configuración correcto para tu cliente de IA. Para Claude Desktop, es `claude_desktop_config.json`. Para Cursor, es `.cursor/mcp.json` en tu proyecto o en la configuración global de Cursor. Reinicia el cliente después de guardar.
  </Accordion>

  <Accordion title="El contenido extraído está vacío">
    Aumenta el tiempo de espera al llamar a **Extraer Sitio Web** (prueba 2000–5000ms para páginas pesadas en JS). Confirma que la URL es accesible públicamente sin un inicio de sesión.
  </Accordion>

  <Accordion title="La URL del punto final MCP sigue cambiando">
    La URL del punto final está vinculada a tu Cluster. Si eliminas y recreas el Cluster, obtendrás una nueva URL y necesitarás actualizar la configuración de tu cliente de IA. Mantén la URL privada — autoriza todas las acciones en tus cuentas conectadas.
  </Accordion>
</AccordionGroup>

***

## Relacionado

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

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

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

  <Card title="API de Mapas" icon="map" href="/features/maps">
    Opciones de descubrimiento y filtrado de URLs
  </Card>

  <Card title="Servidor MCP" icon="server" href="/integrations/mcp-server">
    Usa directamente el servidor MCP nativo de Olostep
  </Card>

  <Card title="Sitio web de ViaSocket" icon="link" href="https://viasocket.com">
    Plataforma ViaSocket
  </Card>
</CardGroup>
