# AI-Map

## Resumen

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 URLs 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 SDKs 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 un prompt 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 URLs 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 una versión superior instalada. 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 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

# Inicializar autorización
ai_map = AiMap(api_key="<API_KEY>")

# Definir el payload de la solicitud
payload = {
    "url": "https://career.oxylabs.io",
    "user_prompt": "job ad pages",
    "return_sources_limit": 10,
    "geo_location": None,
    "render_javascript": False,
}

# Iniciar el mapeo
result = ai_map.map(**payload)

# Mostrar los resultados en JSON
print("URLs:")
print(json.dumps(result.data, indent=2))
```

Obtén 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 [guía del SDK de JavaScript de AI Studio](broken://pages/da8da326cc080bd5d81380f5891c6f7f2a56e27e) para usuarios de JS.

### Parámetros de la 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> | Prompt en lenguaje natural para las páginas que se desean 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                                 | –                    |

&#x20;    – 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 publicaciones del blog** del dominio de una empresa.
* **Documentación de endpoints de la API** endpoints.
* **Descubrir todas las páginas de documentación** o artículos de ayuda.
* **Encontrar ofertas de empleo** en portales de carreras.
* **Y muchos más…**


---

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