> 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-map.md).

# AI-Map

Aprende a mapear y explorar dominios de forma inteligente para encontrar URL relevantes.

## Descripción general

AI-Map te ayuda a descubrir páginas relevantes dentro de un sitio web. Usa IA para explorar dominios de forma sistemática según tus criterios específicos y devuelve una lista de URL que coinciden con tus criterios.

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

## Cómo usar

1. **Introduce una URL o dominio** que quieras mapear.
2. **Describe tus páginas objetivo** con una instrucción en lenguaje natural.
3. **Configura los parámetros de mapeo** como el límite de fuentes, la profundidad de mapeo y la geolocalización.
4. **Ejecuta la tarea de mapeo con IA** para recopilar las URL de tus páginas objetivo del dominio.

### Instalación

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

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

### Ejemplo de código (Python)

El siguiente ejemplo muestra cómo usar un agente de búsqueda de AI-Map para realizar una tarea simple de mapeo de un sitio web.

```python
from oxylabs_ai_studio.apps.ai_map import AiMap
import json

# Initialize authorization
ai_map = AiMap(api_key="<API_KEY>")

# Define the payload for request
payload = {
    "url": "https://career.oxylabs.io",
    "user_prompt": "job ad pages",
    "return_sources_limit": 10,
    "geo_location": None,
    "render_javascript": False,
}

# Start the mapping
result = ai_map.map(**payload)

# Output the results in JSON
print("URLs:")
print(json.dumps(result.data, indent=2))
```

Más información sobre AI-Crawler y el SDK de Python de Oxylabs AI Studio en nuestro [repositorio de PyPI](https://pypi.org/project/oxylabs-ai-studio/). También puedes consultar nuestra [SDK de JavaScript de AI Studio](broken://pages/da8da326cc080bd5d81380f5891c6f7f2a56e27e) guía para usuarios de JS.

### Parámetros de solicitud

| Parámetro                                                  | Descripción                                                             | Valor predeterminado |
| ---------------------------------------------------------- | ----------------------------------------------------------------------- | -------------------- |
| <mark style="background-color:green;">`URL`</mark>         | URL o dominio de inicio para el mapeo                                   | –                    |
| <mark style="background-color:green;">`user_prompt`</mark> | Instrucción en lenguaje natural para las páginas que se van a encontrar | –                    |
| `output_format`                                            | Número máximo de fuentes a devolver                                     | `25`                 |
| `render_javascript`                                        | Habilita el renderizado de JavaScript para contenido dinámico           | `False`              |
| `geo_location`                                             | Ubicación del proxy en formato ISO2                                     | –                    |

– parámetros obligatorios

### Ejemplo de salida

```json
URLs:
[
  "https://career.oxylabs.io/job/247ac098/head-of-marketing",
  "https://career.oxylabs.io/job/2d9ae321/product-owner",
  "https://career.oxylabs.io/job/496841ed/php-developer-golang",
  "https://career.oxylabs.io/job/736ef009/talent-sourcer",
  "https://career.oxylabs.io/job/7a4a4415/senior-python-engineer-webshare-product",
  "https://career.oxylabs.io/job/88f7340c/devops-squad-lead",
  "https://career.oxylabs.io/job/9946db47/junior-project-manager",
  "https://career.oxylabs.io/job/b2e1397e/account-executive-north-america",
  "https://career.oxylabs.io/job/d72db15b/senior-event-marketing-manager",
  "https://career.oxylabs.io/job/e1efecf0/seo-and-growth-marketing-lead"
]
```

## Casos de uso prácticos

* **Mapeo de categorías de productos** en sitios de comercio electrónico.
* **Listado de todas las entradas del blog** del dominio de una empresa.
* **Documentación de APIs** endpoints.
* **Descubrimiento de todas las páginas de documentación** o artículos de ayuda.
* **Búsqueda de ofertas de trabajo** en portales de empleo.
* **Y mucho más…**


---

# 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-map.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.