> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/products/es/ai-studio/ai-scraper.md).

# AI-Scraper

## Descripción general

[**AI-Scraper**](https://aistudio.oxylabs.io/apps/scrape) es una herramienta de scraping que extrae datos de una sola página web. Identifica y analiza la información relevante según una solicitud en lenguaje natural, y luego entrega los resultados en cualquiera de **JSON** (para automatización y APIs) o **Markdown** formato (mejor para salidas legibles y flujos de trabajo de IA).

Este AI-Scraper elimina la necesidad de selectores CSS/XPath o analizadores personalizados, por lo que se integra sin problemas con varios flujos de automatización. **Generación automática de esquemas** y formatos de salida flexibles ofrecen a los usuarios una forma sencilla de extraer datos limpios y estructurados sin necesidad de mantener lógica de análisis.

Puedes previsualizar la herramienta [**aquí**](https://aistudio.oxylabs.io/apps/scrape) e integrarla en tus flujos de trabajo mediante nuestros SDK de Python/JavaScript, el servidor MCP o una de nuestras integraciones de terceros.

## Características clave

* **Extracción basada en solicitudes en lenguaje natural** – Define tus necesidades en inglés sencillo, y el agente de scraping obtendrá la información relevante.
* **Múltiples formatos de salida** – Elige JSON para flujos de trabajo estructurados o Markdown para resultados legibles por humanos y flujos de trabajo de IA.
* **Generación automática de esquemas** – Genera un esquema automáticamente a partir de una solicitud o defínelo manualmente para un análisis JSON preciso.
* **Funciona en cualquier página web pública** – Extrae de comercio electrónico, noticias, blogs o cualquier otra fuente accesible.

## Cómo funciona

Para extraer una página web con AI-Scraper, sigue estos pasos:

1. **Proporciona la URL de la página web** que quieres extraer.
2. **Describe los datos a extraer** en lenguaje natural (p. ej., “Obtén todos los nombres y precios de los productos”).
3. **Selecciona el formato de salida** – JSON estructurado o Markdown.
4. **(Opcional) Define un esquema** – Deja que AI-Scraper genere uno automáticamente, o proporciona tu propio esquema OpenAPI para la estructura exacta que deseas.

### Instalación

Para empezar, asegúrate de tener acceso a una clave API de AI Studio (o [obtén una prueba gratuita](https://aistudio.oxylabs.io/register) con 1000 créditos) y `Python v3.10` o superior instalado. Puedes instalar el `oxylabs-ai-studio` paquete usando pip:

```sh
pip install oxylabs-ai-studio
```

### Ejemplos de código (Python)

Los siguientes ejemplos muestran cómo usar `AiScraper` para extraer datos de una página de ejemplo.

```python
from oxylabs_ai_studio.apps.ai_scraper import AiScraper
import json

# Initialize the AI Scraper with your API key
scraper = AiScraper(api_key="YOUR_API_KEY")

# Generate a schema automatically from natural language
schema = scraper.generate_schema(prompt="want to parse developer, platform, type, price game title, and genre (array)")
print(f"Generated schema: {schema}")

# Scrape a webpage and extract structured data
url = "https://sandbox.oxylabs.io/products/3"
result = scraper.scrape(
    url=url,
    output_format="json",
    schema=schema,
    render_javascript=False,
    geo_location="US",
)
# Print the scrape output as JSON
print("Results:")
print(json.dumps(result.data, indent=2))
```

Obtén más información sobre AI-Scraper y el SDK de Python de Oxylabs AI Studio en nuestra [repositorio de PyPI](https://pypi.org/project/oxylabs-ai-studio/). También puedes consultar nuestra [SDK de JavaScript de AI Studio](https://github.com/oxylabs/oxylabs-ai-studio-js) guía para usuarios de JS.

### Parámetros de solicitud

| Parámetro                                          | Descripción                                                          | Valor predeterminado |
| -------------------------------------------------- | -------------------------------------------------------------------- | -------------------- |
| <mark style="background-color:green;">`URL`</mark> | URL de destino para extraer                                          | –                    |
| `output_format`                                    | Formato de salida (`JSON`, `Markdown`)                               | `Markdown`           |
| `esquema`                                          | Esquema OpenAPI para extracción estructurada (obligatorio para JSON) | –                    |
| `render_javascript`                                | Habilitar renderizado de JavaScript                                  | `False`              |
| `geo_location`                                     | Ubicación del proxy en formato ISO2                                  | –                    |

– parámetros obligatorios

### Ejemplos de salida

AI-Scraper puede devolver una salida analizada y lista para usar que es fácil de integrar en tus aplicaciones.

Así es como se ve su salida JSON:

```json
{
  "games": [
    {
      "developer": "Nintendo EAD Tokyo",
      "platform": "wii",
      "type": "singleplayer",
      "price": 91.99,
      "title": "Super Mario Galaxy 2",
      "genre": [
        "Action",
        "Platformer"
      ]
    },
    {
      "developer": "Eidos Interactive",
      "platform": "wii",
      "type": null,
      "price": 80.99,
      "title": "Death Jr.: Root of Evil",
      "genre": [
        "Action",
        "Platformer",
        "3D"
      ]
    }
}
```

Alternativamente, puedes configurar `output_format` a `Markdown` para recibir resultados con formato Markdown en lugar de JSON.

## Casos de uso prácticos

AI-Scraper puede aplicarse a una amplia variedad de tareas de recopilación de datos:

1. **Extraer detalles de productos** – Recopila nombres, descripciones y precios de productos de sitios de comercio electrónico.
2. **Analizar artículos de noticias** – Obtén títulos de artículos, fechas, autores y texto del cuerpo.
3. **Extraer páginas de precios** – Recopila información estructurada de precios para investigación de la competencia o de mercado.
4. **Extraer ofertas de empleo** – Captura títulos de puestos, ubicaciones, salarios y fechas de publicación de portales de reclutamiento.

<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers.oxylabs.io/products/es/ai-studio/ai-scraper.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.