> ## 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 + n8n

> Añade scraping web, búsqueda, trabajos por lotes, rastreos y mapas de sitio a cualquier flujo de trabajo de n8n, sin necesidad de código.

El nodo verificado [Olostep Web Scraper](https://n8n.io/integrations/olostep-web-scraper/) te ofrece seis operaciones dentro del constructor visual de n8n: extraer datos de una URL, buscar en la web, obtener respuestas de IA, extraer en lotes miles de URLs, rastrear un sitio o mapear todos sus enlaces.

[Ver en n8n →](https://n8n.io/integrations/olostep-web-scraper/)

## 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.
* **n8n en funcionamiento:** ya sea [n8n Cloud](https://n8n.io/cloud/) o una instancia autoalojada. Los nodos de la comunidad deben estar habilitados (lo están por defecto en la mayoría de las configuraciones).
* **No se requiere codificación:** todo en esta guía se realiza a través del editor visual de n8n.

***

## Configuración

<Steps>
  <Step title="Busca el nodo de Olostep">
    Abre cualquier flujo de trabajo, haz clic en **+** y busca **Olostep**. Selecciona **Olostep Web Scraper** de los resultados.

    <img src="https://mintcdn.com/olostep-58/dxAYTC_H6gJN108B/images/integrations/n8n/step-1.png?fit=max&auto=format&n=dxAYTC_H6gJN108B&q=85&s=dee8769fcd2a85836d8fb16c12f577ba" alt="Buscar Olostep en el selector de nodos de n8n" width="1602" height="1114" data-path="images/integrations/n8n/step-1.png" />
  </Step>

  <Step title="Instala el nodo">
    Haz clic en el resultado para abrir el panel de detalles del nodo, luego haz clic en **Instalar nodo**. n8n instalará `n8n-nodes-olostep` y te pedirá reiniciar. Hazlo antes de continuar.

    <img src="https://mintcdn.com/olostep-58/dxAYTC_H6gJN108B/images/integrations/n8n/step-2.png?fit=max&auto=format&n=dxAYTC_H6gJN108B&q=85&s=2721be5e49905b7428c6a082ed73dd18" alt="Detalles del nodo Olostep Web Scraper con el botón Instalar nodo" width="1602" height="1114" data-path="images/integrations/n8n/step-2.png" />

    <Note>
      Si **Nodos de la Comunidad** está deshabilitado para tu espacio de trabajo, un administrador necesita habilitarlo primero. Consulta la [guía de nodos de la comunidad de n8n](https://docs.n8n.io/integrations/community-nodes/installation/).
    </Note>
  </Step>

  <Step title="Agrega tu clave API">
    Abre el nodo de Olostep en tu flujo de trabajo, haz clic en **Configurar Credencial** (en la pestaña de Parámetros), agrega tu clave API y haz clic en **Guardar**.

    <img src="https://mintcdn.com/olostep-58/dxAYTC_H6gJN108B/images/integrations/n8n/step-3.png?fit=max&auto=format&n=dxAYTC_H6gJN108B&q=85&s=ce6d9f0d70ee4f4a8f167bf1909b7c8d" alt="Formulario de credenciales de Olostep en n8n con campo de Clave API" width="1742" height="1114" data-path="images/integrations/n8n/step-3.png" />

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

  <Step title="Conéctalo y ejecuta">
    Conecta el nodo de Olostep a un disparador y a cualquier paso posterior, luego ejecuta tu flujo de trabajo.

    <img src="https://mintcdn.com/olostep-58/dxAYTC_H6gJN108B/images/integrations/n8n/step-4.png?fit=max&auto=format&n=dxAYTC_H6gJN108B&q=85&s=bf0a711ca890d85ed1b8915c50035697" alt="Lienzo de flujo de trabajo de n8n con Disparador de Programación conectado al nodo de Olostep" width="1742" height="1114" data-path="images/integrations/n8n/step-4.png" />
  </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="Buscar" icon="magnifying-glass">
    Realiza una búsqueda en la web y obtén resultados estructurados (títulos, URLs y fragmentos) como JSON.
  </Card>

  <Card title="Respuestas (IA)" icon="sparkles">
    Haz una pregunta en lenguaje natural y obtén una respuesta con fuentes citadas. Útil antes de nodos LLM cuando necesitas respuestas fundamentadas.
  </Card>

  <Card title="Extraer URLs en Lote" icon="layer-group">
    Envía hasta 10,000 URLs en un solo trabajo, procesadas en paralelo. Devuelve un `batch_id`; recupera los resultados de forma asíncrona.
  </Card>

  <Card title="Crear Rastreo" icon="spider-web">
    Comienza desde una URL, sigue enlaces y extrae todas las subpáginas. Bueno para sitios de documentación, blogs o ingestión de sitios completos. Devuelve un `crawl_id`.
  </Card>

  <Card title="Crear Mapa" icon="map">
    Obtén cada URL en un sitio sin extraer contenido. Úsalo para descubrimiento antes de un trabajo por lotes. Devuelve un `map_id`.
  </Card>
</CardGroup>

<Note>
  **Lote, Rastreo y Mapa son asíncronos.** Almacena el ID devuelto y usa un nodo de Espera o un segundo flujo de trabajo para recuperar los resultados una vez que el procesamiento se complete.
</Note>

***

## Ejemplo de flujo de trabajo: Enriquecimiento de leads desde Google Sheets

**Qué hace:** Cuando pegas una URL de empresa en una hoja de Google, este flujo de trabajo automáticamente extrae el sitio web de la empresa, extrae información clave con un nodo de IA y escribe los resultados de nuevo en la misma fila, convirtiendo una hoja de cálculo en blanco en una base de datos de leads completa.

**Nodos usados:** Disparador de Google Sheets → Olostep Extraer Sitio Web → OpenAI → Código → Actualización de Google Sheets

<img src="https://mintcdn.com/olostep-58/dxAYTC_H6gJN108B/images/integrations/n8n/workflow-example.png?fit=max&auto=format&n=dxAYTC_H6gJN108B&q=85&s=60e725c70903c2b3cf6918f2ca486e70" alt="Flujo de trabajo de enriquecimiento de leads en n8n: Disparador de Google Sheets conectado a nodos de Olostep, OpenAI, Código y actualización de Google Sheets" width="868" height="558" data-path="images/integrations/n8n/workflow-example.png" />

***

### Paso 1: Configura tu Hoja de Google

Crea una hoja con estas columnas: `URL de la Empresa`, `Industria`, `Descripción`, `Tamaño de la Empresa`, `Enriquecido`. El flujo de trabajo lee desde `URL de la Empresa` y llena el resto.

### Paso 2: Agrega un disparador de Google Sheets

En n8n, agrega un nodo de disparador **Google Sheets**. Configura el evento a **Fila Añadida**, apúntalo a tu hoja y configúralo para observar la columna `URL de la Empresa`. Ahora, cada vez que pegues una nueva URL en la hoja, este flujo de trabajo se activará.

### Paso 3: Agrega Olostep Extraer Sitio Web

Conecta un nodo **Olostep Web Scraper** después del disparador. Configura:

* **Acción:** Extraer Sitio Web
* **URL:** `{{ $json["Company URL"] }}` (extrae la URL de la nueva fila)
* **Formato de Salida:** Markdown

Markdown funciona mejor aquí porque elimina navegación, anuncios y contenido repetitivo. El nodo de IA en el siguiente paso obtiene prosa limpia sobre la empresa en lugar de ruido HTML bruto.

### Paso 4: Agrega un nodo de OpenAI

Conecta un nodo **OpenAI**. Configura el modelo a `gpt-4o-mini` (rápido y económico para tareas de extracción) y usa este prompt:

```
Eres un investigador de ventas. Basado en el contenido del sitio web de la empresa a continuación, extrae:
1. Industria (una frase, por ejemplo, "B2B SaaS", "E-commerce", "Salud")
2. Descripción de la empresa en una oración (máximo 20 palabras)
3. Tamaño estimado de la empresa (Startup / SMB / Mid-market / Enterprise)

Devuelve solo un objeto JSON con claves: industry, description, company_size.

Contenido del sitio web:
{{ $json.markdownContent }}
```

El campo `markdownContent` es lo que Olostep devuelve de la extracción, como texto plano limpio.

### Paso 5: Analiza la respuesta de IA y escribe de nuevo

Agrega un nodo **Código** para analizar el JSON de OpenAI:

```js theme={null}
const parsed = JSON.parse($input.first().json.message.content);
return [{ json: parsed }];
```

Luego conecta un nodo **Google Sheets** configurado para **Actualizar Fila**. Mapea las columnas:

* `Industria` → `{{ $json.industry }}`
* `Descripción` → `{{ $json.description }}`
* `Tamaño de la Empresa` → `{{ $json.company_size }}`
* `Enriquecido` → `Sí`

### Lo que obtienes

Pega una URL como `https://notion.so` en tu hoja, y en \~10 segundos la fila se completa:

| URL de la Empresa                      | Industria             | Descripción                                                            | Tamaño de la Empresa | Enriquecido |
| -------------------------------------- | --------------------- | ---------------------------------------------------------------------- | -------------------- | ----------- |
| [https://notion.so](https://notion.so) | SaaS de Productividad | Espacio de trabajo todo en uno para notas, documentos y bases de datos | Mid-market           | Sí          |

Desde aquí puedes extender este flujo de trabajo: agrega una notificación de Slack cuando el enriquecimiento se complete, filtra por industria antes de escribir de nuevo, o reemplaza Google Sheets con HubSpot para actualizar contactos directamente.

***

## Plantillas

Flujos de trabajo de n8n listos para importar construidos con Olostep:

<CardGroup cols={2}>
  <Card title="Rastrear docs → base de conocimiento de IA" icon="book" href="https://www.n8n.io/workflows/13436-crawl-documentation-sites-and-build-an-ai-knowledge-base-with-olostep/">
    Rastrear sitios de documentación con Olostep y estructurar la salida en una base de conocimiento lista para IA.
  </Card>

  <Card title="Leads de Google Maps → enriquecimiento de tomadores de decisiones" icon="map-location-dot" href="https://n8n.io/workflows/11086-scrape-business-leads-from-google-maps-and-extract-decision-maker-info-with-olostep/">
    Extrae leads de negocios de Google Maps y enriquécelos con detalles de tomadores de decisiones.
  </Card>

  <Card title="Minar quejas de usuarios → informe de insights" icon="chart-line" href="https://www.n8n.io/workflows/13435-mine-user-complaints-and-generate-insight-reports-with-olostep-gemini-and-google-docs/">
    Analiza quejas con Olostep + Gemini y genera informes de insights estructurados en Google Docs.
  </Card>

  <Card title="Extracción de productos de Amazon → Google Sheets" icon="table" href="https://n8n.io/workflows/11158-extract-amazon-product-data-to-sheets-with-olostep-api/">
    Extrae URLs y metadatos de productos de Amazon con Olostep, luego sincroniza los resultados con Sheets.
  </Card>
</CardGroup>

[Explora todos los flujos de trabajo de Olostep en n8n.io →](https://n8n.io/workflows/?q=olostep)

***

## Parsers

Agrega un ID de parser al campo **Parser** en cualquier acción de Scrape o Batch para obtener datos estructurados en lugar de contenido bruto:

| Parser                       | Extrae                                                     |
| ---------------------------- | ---------------------------------------------------------- |
| `@olostep/amazon-product`    | Título, precio, calificación, reseñas, imágenes, variantes |
| `@olostep/google-search`     | Títulos de resultados, URLs, fragmentos                    |
| `@olostep/google-maps`       | Nombre del negocio, dirección, calificación, reseñas       |
| `@olostep/extract-emails`    | Direcciones de correo electrónico de cualquier página      |
| `@olostep/extract-socials`   | Enlaces de perfiles sociales (X, GitHub, LinkedIn, etc.)   |
| `@olostep/extract-calendars` | Enlaces de Google Calendar e ICS                           |

Consulta la lista completa en la [tienda de parsers de Olostep →](https://www.olostep.com/store)

***

## 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 credencial en n8n si el error persiste.
  </Accordion>

  <Accordion title="Contenido extraído está vacío">
    Aumenta **Esperar Antes de Extraer** (prueba 2000–5000ms para páginas pesadas en JS). Confirma que la URL es accesible públicamente sin un inicio de sesión. Si un dominio específico falla constantemente, contacta a [info@olostep.com](mailto:info@olostep.com).
  </Accordion>

  <Accordion title="Error de formato de URL en Lote">
    El campo **URLs para Extraer** espera un array JSON:

    ```json theme={null}
    [
      { "url": "https://example.com/page-1", "custom_id": "p1" },
      { "url": "https://example.com/page-2", "custom_id": "p2" }
    ]
    ```

    Usa un nodo de Código aguas arriba para construir este array a partir de tus datos si es necesario.
  </Accordion>

  <Accordion title="Límite de tasa alcanzado">
    Agrega un nodo de **Espera** entre los pasos de extracción, o cambia a **Extraer URLs en Lote** en lugar de hacer extracciones individuales en bucle. Verifica el uso actual en el [tablero](https://olostep.com/dashboard).
  </Accordion>

  <Accordion title="Nodos de la Comunidad no visibles en Configuración">
    En n8n Cloud, los nodos de la comunidad deben ser habilitados por un propietario del espacio de trabajo. En autoalojado, asegúrate de que `N8N_COMMUNITY_PACKAGES_ENABLED=true` esté configurado en tu entorno. Consulta la [guía de instalación de n8n](https://docs.n8n.io/integrations/community-nodes/installation/).
  </Accordion>
</AccordionGroup>

***

## Relacionado

<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 por lotes 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 automatizar tus flujos de trabajo de búsqueda web, extracción y rastreo?

<CardGroup cols={2}>
  <Card title="Sitio web de n8n" icon="link" href="https://n8n.io">
    Plataforma n8n
  </Card>

  <Card title="Instala el Nodo" icon="workflow" href="https://www.npmjs.com/package/n8n-nodes-olostep">
    Instala n8n-nodes-olostep y comienza a construir flujos de trabajo automatizados
  </Card>
</CardGroup>

¡Conecta Olostep con n8n y automatiza hoy mismo la extracción de datos web!
