> ## 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.
# Bienvenido a Olostep
> Olostep: Infraestructura para el segundo usuario de la Web. La mejor API de búsqueda, scraping y crawling para IA.
Olostep es infraestructura para el segundo usuario de la Web, proporcionando a los agentes de IA una forma de buscar en la web, extraer datos estructurados en tiempo real y construir agentes de investigación personalizados.
## Introducción
* La **API de Olostep** es la mejor API de **búsqueda web**, **scraping** y **crawling** para IA utilizada por algunas de las startups y scaleups líderes en el mundo.
* El **Agente de Olostep** permite automatizar **flujos de trabajo de investigación** de manera sin código con solo un prompt en lenguaje natural.
**Para agentes de IA:** descarga [docs.olostep.com/llms.txt](https://docs.olostep.com/llms.txt) para un índice completo de esta documentación antes de explorar más o [comienza aquí](https://www.olostep.com/agent-onboarding/SKILL.md).
## Usa Olostep desde tu terminal y agentes de IA
Más allá de la API, Olostep ofrece un CLI, un servidor MCP y habilidades integrables para que cualquier herramienta — Claude Code, Cursor, Windsurf, y más — pueda usar la web de manera nativa.
`npm i -g olostep-cli` — realiza scraping, mapeo, crawling, responde y procesa la web desde tu terminal. Salida en JSON para scripts, CI y agentes.
Proporciona a cualquier cliente MCP (Claude, Cursor, VS Code) herramientas web en vivo. Punto de acceso alojado — sin instalación.
Habilidades integrables que enseñan a los agentes de codificación de IA cómo y cuándo usar Olostep. Instala con `olostep add skills`.
## ¿Qué puede hacer Olostep?
Extrae cualquier URL como Markdown limpio, HTML, capturas de pantalla o JSON estructurado.
Reúne recursivamente cada página de un sitio, con filtros y búsqueda.
Obtén respuestas sintetizadas por IA de fuentes web en vivo, con citas.
### ¿Por qué Olostep?
* **Construido para IA**: Markdown limpio, JSON estructurado, citas — salida que tus agentes y aplicaciones consumen directamente.
* **Confiable a escala**: Tasa de éxito líder en la industria; maneja JavaScript, anti-bots y proxies en segundo plano.
* **Rápido**: Scraping único en menos de un segundo; hasta 10,000 URLs en un solo lote en 5–7 minutos.
* **Rentable**: Significativamente más barato que las alternativas a escala de producción.
* **CLI + MCP + Habilidades**: Usa Olostep desde tu terminal, scripts o cualquier agente compatible con MCP — habilidades de agente incluidas.
***
## Scraping
Extrae cualquier URL como Markdown limpio. Consulta la [documentación de características de Scraping](/features/scrapes) para ver todas las opciones.
```python Python theme={null}
from olostep import Olostep
client = Olostep(api_key="YOUR_REAL_KEY")
result = client.scrapes.create(
url_to_scrape="https://en.wikipedia.org/wiki/Alexander_the_Great",
formats=["markdown"],
)
print(result.markdown_content)
```
```js Node theme={null}
import Olostep from 'olostep'
const client = new Olostep({ apiKey: 'YOUR_REAL_KEY' })
const result = await client.scrapes.create({
url: 'https://en.wikipedia.org/wiki/Alexander_the_Great',
formats: ['markdown'],
})
console.log(result.markdown_content)
```
```bash cURL theme={null}
curl -s -X POST "https://api.olostep.com/v1/scrapes" \
-H "Authorization: Bearer $OLOSTEP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url_to_scrape": "https://en.wikipedia.org/wiki/Alexander_the_Great",
"formats": ["markdown"]
}'
```
```bash CLI theme={null}
olostep scrape "https://en.wikipedia.org/wiki/Alexander_the_Great"
```
```json theme={null}
{
"id": "scrape_6h89o8u1kt",
"object": "scrape",
"result": {
"markdown_content": "## Alexander the Great...",
"markdown_hosted_url": "https://olostep-storage.s3.us-east-1.amazonaws.com/markDown_6h89o8u1kt.txt",
"page_metadata": { "status_code": 200, "title": "Alexander the Great - Wikipedia" }
}
}
```
## Crawling
Reúne recursivamente cada página de un sitio, con filtros de inclusión/exclusión y una `search_query` opcional para enfocar el crawling. Consulta la [documentación de características de Crawling](/features/crawls).
```python Python theme={null}
from olostep import Olostep
client = Olostep(api_key="YOUR_REAL_KEY")
crawl = client.crawls.create(
start_url="https://docs.olostep.com",
max_pages=50,
)
for page in crawl.pages():
print(page.url)
```
```js Node theme={null}
import Olostep from 'olostep'
const client = new Olostep({ apiKey: 'YOUR_REAL_KEY' })
const crawl = await client.crawls.create({
url: 'https://docs.olostep.com',
maxPages: 50,
})
for await (const page of crawl.pages()) {
console.log(page.url)
}
```
```bash cURL theme={null}
curl -s -X POST "https://api.olostep.com/v1/crawls" \
-H "Authorization: Bearer $OLOSTEP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"start_url": "https://docs.olostep.com",
"max_pages": 50
}'
```
```bash CLI theme={null}
olostep crawl "https://docs.olostep.com" --max-pages 50
```
```json theme={null}
{
"id": "crawl_abc123",
"object": "crawl",
"status": "completed",
"pages_count": 47,
"pages": [
{ "url": "https://docs.olostep.com/get-started/welcome", "retrieve_id": "..." },
{ "url": "https://docs.olostep.com/features/scrapes", "retrieve_id": "..." }
]
}
```
## Responder
Haz una pregunta y obtén una respuesta sintetizada por IA de fuentes web en vivo, con citas. Pasa un esquema JSON para dar forma a la salida. Consulta la [documentación de Respuestas](/features/answers).
```python Python theme={null}
from olostep import Olostep
client = Olostep(api_key="YOUR_REAL_KEY")
answer = client.answers.create(task="What does Olostep do?")
print(answer.result)
print(answer.sources)
```
```js Node theme={null}
import Olostep from 'olostep'
const client = new Olostep({ apiKey: 'YOUR_REAL_KEY' })
const answer = await client.answers.create({ task: 'What does Olostep do?' })
console.log(answer.result)
console.log(answer.sources)
```
```bash cURL theme={null}
curl -s -X POST "https://api.olostep.com/v1/answers" \
-H "Authorization: Bearer $OLOSTEP_API_KEY" \
-H "Content-Type: application/json" \
-d '{"task": "What does Olostep do?"}'
```
```bash CLI theme={null}
olostep answer "What does Olostep do?"
```
```json theme={null}
{
"id": "answer_abc123",
"object": "answer",
"task": "What does Olostep do?",
"result": {
"json_content": "{\"result\":\"Olostep is an API that lets AI agents search, scrape, and structure web data.\"}",
"sources": [
"https://docs.olostep.com/get-started/welcome",
"https://www.olostep.com/"
]
}
}
```
***
## Más capacidades
Realiza scraping de hasta 10,000 URLs en paralelo; resultados en 5–7 minutos.
Descubre cada URL en un sitio con patrones de inclusión/exclusión.
Búsqueda web en vivo con enlaces estructurados y scraping opcional en línea.
Extractores auto-reparables que convierten páginas en JSON tipado a escala.
Ejecuta scrapes, crawls y respuestas en un horario recurrente.
Sube archivos para lotes o para conectar tu base de conocimiento.
***
## Recursos
Revisa todas las características compatibles para tus necesidades de scraping y búsqueda de IA.
Comienza a usar la API y prueba los diversos parámetros.
Usa Olostep en n8n, make, relay, zapier, etc.
Navega por ejemplos listos para usar y comienza rápidamente.