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

> Busca, extrae, mapea y rastrea la web en vivo desde Snowflake SQL, y guarda páginas como tablas con la aplicación nativa de Olostep.

La [aplicación nativa de Olostep en el Snowflake Marketplace](https://app.snowflake.com/marketplace/listing/GZT8Z4URI87/olostep-olostep-web-search-scraping-and-crawling) lleva datos web en vivo a Snowflake. [Olostep](https://www.olostep.com) es infraestructura de datos web para agentes de IA y flujos de trabajo de IA empresarial. Sus APIs proporcionan búsqueda web en vivo, extracción y rastreo para extraer, limpiar y estructurar datos de la web.

Llama a Olostep desde SQL para buscar en la web, extraer páginas en markdown limpio, mapear y rastrear sitios web, y obtener respuestas con fuentes. Las extracciones y rastreos por lotes se guardan como tablas en tu cuenta, para que puedas unir datos web con tus propios datos, cargarlos en Cortex Search o usarlos en Cortex Agents.

[Ver en el Snowflake Marketplace →](https://app.snowflake.com/marketplace/listing/GZT8Z4URI87/olostep-olostep-web-search-scraping-and-crawling)

## Antes de comenzar

* **Una cuenta de Olostep con una clave API:** [obtén una gratis](https://www.olostep.com/dashboard), no se requiere tarjeta de crédito. Tus primeros 500 créditos están incluidos.
* **Una cuenta de Snowflake con acceso externo:** la aplicación llama a la API de Olostep a través de una integración de acceso externo, que las cuentas de prueba no soportan.
* **Un rol que pueda aprobar conexiones de aplicaciones:** aprobar la conexión a `api.olostep.com` requiere el privilegio `MANAGE APPLICATION SPECIFICATIONS`, que tienen `ACCOUNTADMIN` y `SECURITYADMIN`.

## Configuración

**1. Obtén la aplicación**

Abre la [lista](https://app.snowflake.com/marketplace/listing/GZT8Z4URI87/olostep-olostep-web-search-scraping-and-crawling) y haz clic en **Obtener**. Los ejemplos en esta página asumen que la instalas como `olostep`.

**2. Aprueba la conexión a la API de Olostep**

La aplicación crea su propia integración de acceso externo para `api.olostep.com`, y no puede llamar a la API hasta que la apruebes. En Snowsight, ve a **Catálogo** > **Aplicaciones** y selecciona la aplicación. Selecciona el icono de **Configuraciones**, luego abre la pestaña de **Configuraciones**. Bajo **Conexiones externas**, expande **Detalles** junto a **Integraciones de acceso externo** y aprueba el endpoint `api.olostep.com`.

**3. Agrega tu clave API**

En la misma pestaña de **Configuraciones**, bajo **Credenciales**, agrega un secreto `GENERIC_STRING` que contenga tu clave API desde el [dashboard de Olostep](https://www.olostep.com/dashboard/api-keys) a **Clave API de Olostep**.

> [accordion] ¿Prefieres SQL? Realiza los pasos 2 y 3 en una hoja de trabajo
>
> ```sql theme={null}
> -- Aprueba la conexión, usando el número de secuencia que SHOW SPECIFICATIONS devuelve
> SHOW SPECIFICATIONS IN APPLICATION olostep;
> ALTER APPLICATION olostep APPROVE SPECIFICATION olostep_api_access SEQUENCE_NUMBER = 1;
>
> -- Almacena tu clave en un secreto y entrégasela a la aplicación
> CREATE DATABASE IF NOT EXISTS olostep_config;
>
> CREATE OR REPLACE SECRET olostep_config.public.olostep_api_key
>   TYPE = GENERIC_STRING
>   SECRET_STRING = '<YOUR_OLOSTEP_API_KEY>';
>
> CALL olostep.core.register_reference('OLOSTEP_API_KEY', 'ADD',
>   SYSTEM$REFERENCE('SECRET', 'olostep_config.public.olostep_api_key', 'PERSISTENT', 'READ'));
> ```

## Procedimientos

| Procedimiento | Qué hace |
| - | - |
| `core.scrape(url)` | Extrae una página y devuelve markdown limpio (incluye renderizado de JavaScript) |
| `core.search(query, max_results)` | Busca en la web en vivo y devuelve títulos, URLs y descripciones |
| `core.answer(task)` | Responde una pregunta de la web en vivo, con URLs de fuente |
| `core.map(url, top_n)` | Lista las URLs en un sitio web |
| `core.batch_scrape(urls, table_name)` | Extrae una lista de URLs en un solo lote y guarda las páginas en una tabla |
| `core.crawl(url, table_name, max_pages)` | Rastrea un sitio web y guarda las páginas en una tabla |
| `core.save_results(id, table_name)` | Guarda las páginas de un lote o rastreo que aún estaba en ejecución cuando se devolvió la llamada |

Cada procedimiento devuelve un `VARIANT`. En caso de fallo, devuelve un objeto con `status` establecido en `error`. Los límites de velocidad, errores del servidor y tiempos de espera se reintentan automáticamente.

## Uso

```sql theme={null}
-- Extrae una página en markdown
CALL olostep.core.scrape('https://docs.olostep.com');

-- Busca en la web
CALL olostep.core.search('últimos marcos de agentes de IA', 5);

-- Responde una pregunta con fuentes
CALL olostep.core.answer('¿Cuál es la última versión estable de Next.js?');

-- Lista las URLs en un sitio web
CALL olostep.core.map('https://docs.olostep.com', 50);
```

## Guarda páginas como tablas

`batch_scrape` y `crawl` guardan una fila por página en `olostep.results.<table_name>`, con las columnas `URL`, `MARKDOWN`, `ERROR` y `RETRIEVED_AT`. Usar un nombre de tabla existente reemplaza esa tabla.

```sql theme={null}
-- Extrae cada URL en una de tus tablas
CALL olostep.core.batch_scrape(
  (SELECT ARRAY_AGG(website) FROM my_db.crm.accounts),
  'account_pages');

-- Rastrea un sitio web (hasta 25 páginas)
CALL olostep.core.crawl('https://docs.olostep.com', 'olostep_docs', 25);

-- Consulta los resultados, o cópialos en tu propia base de datos
SELECT url, markdown FROM olostep.results.account_pages;
CREATE TABLE my_db.crm.account_pages AS SELECT * FROM olostep.results.account_pages;
```

Los lotes y rastreos generalmente terminan en unos minutos. Si uno aún está en ejecución después de 20 minutos, el procedimiento devuelve su `id` con `status` establecido en `in_progress`. Guarda sus páginas más tarde con:

```sql theme={null}
CALL olostep.core.save_results('<id>', 'account_pages');
```

Las tablas en `results` se eliminan si desinstalas la aplicación, así que copia cualquier cosa que quieras conservar en tu propia base de datos.

## Solución de problemas

* **"No se pudo alcanzar api.olostep.com":** la conexión aún no está aprobada. Apruébala como en el paso 2.
* **"Función definida por el usuario desconocida INTERNAL.OLOSTEP\_REQUEST":** la clave API aún no está agregada. Agrégala como en el paso 3.
* **HTTP 401 en el error:** el secreto no contiene una clave API de Olostep válida. Revísala en el [dashboard de Olostep](https://www.olostep.com/dashboard/api-keys).

## Recursos

* [Olostep en el Snowflake Marketplace](https://app.snowflake.com/marketplace/listing/GZT8Z4URI87/olostep-olostep-web-search-scraping-and-crawling)
* [Repositorio de GitHub](https://github.com/olostep-api/olostep-snowflake)
* [Documentación de Snowflake Native Apps](https://docs.snowflake.com/en/developer-guide/native-apps/native-apps-about)
* [Sitio web de Olostep](https://www.olostep.com)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.