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

# Uso de Web Unlocker con agentes de IA

> Cómo usar Gologin Web Unlocker como herramienta de scraping para agentes de IA y pipelines de LLM

Gologin Web Unlocker es una API de scraping que devuelve el HTML completamente renderizado de cualquier URL. Para los agentes de IA, esto significa acceso web fiable sin necesidad de orquestar un navegador: una sola llamada HTTP por página.

> [!TIP]
>
> **¿No quieres escribir código?** Usa la [Web Access CLI](https://gologin.com/docs/es/cli-tools/web-access.md) o el [Scraping Skill](https://gologin.com/docs/es/api-reference/ai-integrations/ai-skills.md) para darle a tu agente capacidades de scraping desde el primer momento.

***

## Pasar el contenido de una página a un LLM

Haz scraping de una página y pasa el HTML a un modelo para extraer datos, resumir o analizar, sin necesidad de lógica de parseo.

### Python + Claude

```python theme={null}
import requests
import anthropic

html = requests.get(
    "https://parsing.webunlocker.gologin.com/v1/scrape",
    params={"url": "https://news.ycombinator.com"},
    headers={"apikey": "YOUR_API_KEY"}
).text

client = anthropic.Anthropic()
message = client.messages.create(
    model="claude-sonnet-4-5-20250514",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": f"Extract the top 5 story titles and URLs from this HTML:\n\n{html[:8000]}"
        }
    ]
)

print(message.content[0].text)
```

### JavaScript + Claude

```javascript theme={null}
import Anthropic from "@anthropic-ai/sdk";

const html = await fetch(
  "https://parsing.webunlocker.gologin.com/v1/scrape?url=" +
    encodeURIComponent("https://news.ycombinator.com"),
  { headers: { apikey: "YOUR_API_KEY" } }
).then((r) => r.text());

const client = new Anthropic();
const message = await client.messages.create({
  model: "claude-sonnet-4-5-20250514",
  max_tokens: 1024,
  messages: [
    {
      role: "user",
      content: `Extract the top 5 story titles and URLs from this HTML:\n\n${html.slice(0, 8000)}`,
    },
  ],
});

console.log(message.content[0].text);
```

***

## Dar a tu agente una herramienta de scraping

Define una herramienta `scrape` respaldada por Web Unlocker. El agente decide cuándo obtener una página y qué URL scrapear.

```python theme={null}
import requests
import anthropic

def scrape(url: str) -> str:
    """Fetch a URL and return its rendered HTML."""
    return requests.get(
        "https://parsing.webunlocker.gologin.com/v1/scrape",
        params={"url": url},
        headers={"apikey": "YOUR_API_KEY"}
    ).text

tools = [
    {
        "name": "scrape",
        "description": "Fetch the rendered HTML of any URL, including JavaScript-heavy and protected sites.",
        "input_schema": {
            "type": "object",
            "properties": {
                "url": {"type": "string", "description": "The URL to scrape"}
            },
            "required": ["url"]
        }
    }
]

client = anthropic.Anthropic()
messages = [
    {"role": "user", "content": "What is the current price of the iPhone 16 Pro on apple.com?"}
]

while True:
    response = client.messages.create(
        model="claude-sonnet-4-5-20250514",
        max_tokens=1024,
        tools=tools,
        messages=messages
    )

    if response.stop_reason == "end_turn":
        print(response.content[0].text)
        break

    tool_results = []
    for block in response.content:
        if block.type == "tool_use" and block.name == "scrape":
            html = scrape(block.input["url"])
            tool_results.append({
                "type": "tool_result",
                "tool_use_id": block.id,
                "content": html[:10000]
            })

    messages.append({"role": "assistant", "content": response.content})
    messages.append({"role": "user", "content": tool_results})
```

El agente decide cuándo hacer scraping y qué URL obtener. Web Unlocker se encarga de la obtención de los datos: renderizado de JavaScript, elusión de sistemas antibot, rotación de proxies y resolución de CAPTCHA.

***

## Usar el SDK de Web Unlocker

Para agentes en TypeScript/Node.js, el SDK `gologin-webunlocker` ofrece métodos tipados:

```ts theme={null}
import { WebUnlocker } from "gologin-webunlocker";

const client = new WebUnlocker({
  apiKey: process.env.GOLOGIN_WEBUNLOCKER_API_KEY!
});

// get structured metadata instead of raw HTML
const { data } = await client.scrapeJSON("https://example.com");
console.log(data.title, data.description, data.headings);

// get clean text for LLM context
const { text } = await client.scrapeText("https://example.com");

// batch scrape with concurrency control
const results = await client.batchScrape(
  ["https://example.com/1", "https://example.com/2", "https://example.com/3"],
  { concurrency: 3 }
);
```

Consulta la [referencia del SDK de Web Unlocker](https://gologin.com/docs/es/scraping-api-sdk-and-cli.md) para ver todos los métodos.

***

## Usar la CLI

Para agentes que ejecutan comandos de shell (como Claude Code), la CLI es el camino más sencillo:

```bash theme={null}
# plain text — good for LLM context
gologin-web-access scrape-text https://example.com

# structured JSON — title, description, headings, links
gologin-web-access scrape-json https://example.com

# batch scrape — many pages at once
gologin-web-access batch-scrape url1 url2 url3 --format text --summary

# search the web
gologin-web-access search "best antidetect browser 2026" --limit 10

# extract structured data with a schema
gologin-web-access extract https://example.com --schema ./schema.json
```

Consulta la [referencia de Web Access CLI](https://gologin.com/docs/es/cli-tools/web-access.md) para ver todos los comandos.

***

## Patrones comunes para agentes

| Patrón | Cómo |
| - | - |
| Agente de investigación | El agente llama a la herramienta `scrape` → lee las páginas → sintetiza los hallazgos |
| Monitoreo de precios | `batch-scrape` de páginas de producto de forma programada → comparar con la ejecución anterior |
| Inteligencia competitiva | `crawl` de sitios de la competencia → pasar al LLM para su análisis |
| Enriquecimiento de leads | `scrape-json` de páginas de empresas → extraer datos estructurados |
| Agregación de contenido | `search` + `scrape-text` → crear feeds curados |

***

## Relacionado

* [Qué es Web Unlocker](https://gologin.com/docs/es/what-is-web-unlocker.md) — descripción general del producto y precios
* [SDK de Web Unlocker](https://gologin.com/docs/es/scraping-api-sdk-and-cli.md) — referencia del SDK de TypeScript
* [Web Access CLI](https://gologin.com/docs/es/cli-tools/web-access.md) — CLI unificada
* [AI Skills](https://gologin.com/docs/es/api-reference/ai-integrations/ai-skills.md) — skills listos para usar con Claude Code


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