# AI-Search

## Resumen

El [**AI-Search**](https://aistudio.oxylabs.io/apps/search) aplicación de [**Oxylabs AI Studio**](https://aistudio.oxylabs.io/) es una herramienta de búsqueda web que permite a los desarrolladores recuperar resultados de búsqueda, opcionalmente extraerlos y manejar con facilidad contenido renderizado con JavaScript. Está diseñada para actuar como un agente de búsqueda inteligente que simplifica el proceso de extraer información relevante directamente en tus aplicaciones Python.

Tanto si necesitas una simple lista de URLs como una extracción profunda de contenido, AI Search elimina la complejidad de construir desde cero scrapers de búsqueda personalizados.

## Características principales

* **Consulta la web usando inglés sencillo:** Solo proporciona tu consulta de búsqueda en lenguaje natural y deja que el agente haga el trabajo pesado.
* **Controla el número de resultados de búsqueda:** Define fácilmente exactamente cuántos resultados quieres recuperar.
* **Extracción de contenido opcional para páginas de resultados:** Extrae y obtiene automáticamente fragmentos de contenido directamente de los resultados de búsqueda devueltos.
* **Renderizado en Python para contenido dinámico:** Activa el renderizado para manejar y extraer sin problemas datos de sitios web con mucho JavaScript.

## Cómo funciona

Para usar el agente de búsqueda, sigue estos sencillos pasos:

1. **Introduce la consulta de búsqueda** que deseas buscar.
2. **Configura el número deseado de resultados** para limitar o ampliar el alcance de tu búsqueda.
3. **Activa o desactiva la extracción de contenido y el renderizado de JS** según si necesitas una extracción profunda de contenido o solo URLs y títulos.

### Instalación

Para comenzar, asegúrate de tener acceso a una clave de API (o [obtén una prueba gratuita](https://aistudio.oxylabs.io/register) con **1,000 credits**) y `Python 3.10+` instalado. Puedes instalar el `oxylabs-ai-studio` paquete usando pip:

```bash
pip install oxylabs-ai-studio
```

### Ejemplo de código (Python)

El siguiente ejemplo muestra cómo usar el `AI-Seaerch` agente para escenarios de recuperación de datos.

```python
from oxylabs_ai_studio.apps.ai_search import AiSearch

search = AiSearch(api_key="<API_KEY>")

query = "lasagna recipes"
result = search.search(
    query=query,
    limit=5,
    render_javascript=False,
    return_content=True,
)
print(result.data)

# O para una búsqueda rápida
result = search.instant_search(
    query=query,
    limit=10,
)
print(result.data)
```

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

### Parámetros de solicitud

| Parámetro                                            | Descripción                                                   | Valor predeterminado |
| ---------------------------------------------------- | ------------------------------------------------------------- | -------------------- |
| <mark style="background-color:green;">`query`</mark> | Qué buscar                                                    | –                    |
| `limit`                                              | Número máximo de resultados a devolver (Máximo: 50)           | 10                   |
| `render_javascript`                                  | Habilitar renderizado de JavaScript                           | `False`              |
| `return_content`                                     | Si se deben devolver contenidos en Markdown en los resultados | `True`               |
| `geo_location`                                       | Ubicación del proxy en formato ISO2                           | –                    |

&#x20;    – parámetros obligatorios

**Nota:** Cuando `limit <= 10` y `return_content=False`, la búsqueda usa automáticamente el endpoint instantáneo (`/search/instant`) que devuelve resultados al instante sin sondeo, proporcionando tiempos de respuesta más rápidos.

{% hint style="info" %}
**Nota:** Cuando `limit <= 10` y `return_content=False`, la búsqueda usa automáticamente el endpoint instantáneo (`/search/instant`) que devuelve resultados al instante sin sondeo, proporcionando tiempos de respuesta más rápidos.
{% endhint %}

Parámetros compatibles con la búsqueda instantánea:

| Parámetro                                            | Descripción                                                                                                              | Valor predeterminado |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | -------------------- |
| <mark style="background-color:green;">`query`</mark> | Qué buscar                                                                                                               | –                    |
| `limit`                                              | El número máximo de resultados de búsqueda a devolver (Máx: `10`)                                                        | `10`                 |
| `geo_location`                                       | Nombre canónico de Google de la ubicación. Ver más [aquí](https://developers.google.com/google-ads/api/data/geotargets). | –                    |

&#x20;    – parámetros obligatorios

### Muestra de salida

```python
[
  {
    "url": "https://www.spendwithpennies.com/easy-homemade-lasagna/",
    "title": "Receta fácil de lasaña casera - Spend With Pennies",
    "description": "Valoración 5.0 (3,349) · 1 h 45 min ¡Esta es la mejor RECETA DE LASAÑA! La pasta, una salsa de carne fácil y queso ricotta se colocan en capas y luego se cubren con más queso antes de hornear.",
    "content": null
  },
  {
    "url": "https://www.simplyrecipes.com/recipes/lasagna/",
    "title": "La mejor lasaña casera - Simply Recipes",
    "description": "Valoración 4.9 (115) · 1 h 45 min Esta receta clásica de lasaña se hace con una salsa de carne fácil como base. Coloca la salsa en capas con fideos y queso, luego hornea hasta que burbujee!",
    "content": null
  },
  {
    "url": "https://www.seriouseats.com/12-lasagna-recipes-11808722",
    "title": "12 recetas de lasaña que debes probar con bordes crujientes y centro cremoso ...",
    "description": "Tanto si te gustan los clásicos carnosos como una lasaña alla Bolognese o una indulgente lasaña vegetariana cremosa con espinacas, hemos reunido nuestras favoritas ...",
    "content": null
  },
  {
    "url": "https://bakerbynature.com/the-best-homemade-lasagna-recipe/",
    "title": "La mejor receta fácil de lasaña casera - Baker by Nature",
    "description": "Valoración 5.0 (71) · 2 h 45 min 12 dic 2025 · Esta es la ÚNICA receta de lasaña que jamás necesitarás... desde fideos perfectamente cocidos hasta una rica salsa de tomate y capas de queso.",
    "content": null
  },
  {
    "url": "https://www.allrecipes.com/recipe/23600/worlds-best-lasagna/",
    "title": "Receta de la mejor lasaña del mundo (con video) - Allrecipes",
    "description": "Valoración 4.8 (20,950) · 3 h 15 min 5 feb 2026 · ¡Esta receta de lasaña de John Chandler es nuestra receta más popular! Con salchicha, carne molida, albahaca y 3 tipos de queso, está a la altura de...",
    "content": null
  }
]
```

## Casos de uso prácticos

AI-Search se puede aplicar a una amplia variedad de tareas de descubrimiento y recopilación de datos:

1. **Buscar las noticias o artículos más recientes sobre un tema –** Reúne rápidamente información actualizada, titulares y resúmenes.
2. **Descubrir libros, películas o productos –** Recupera listas de elementos que cumplan criterios específicos o reseñas.
3. **Investigar ofertas de la competencia –** Encuentra y analiza precios, funciones y posicionamiento en el mercado de la competencia.
4. **Agrupar actualizaciones del sector de varios sitios –** Compila cambios y tendencias relevantes del sector en un único feed estructurado.


---

# Agent Instructions: 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:

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

The question should be specific, self-contained, and written in natural language.
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.