# Instrucciones para el agente: Anansi: extrae páginas web con recuperación de selectores

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/mdowis/anansi (licencia Apache-2.0)
- Guía completa: https://lab.wisd.ai/hub/anansi-scraper

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

Comprueba que el entorno elegido usa Python ≥3.11 y dispone de pip y Git para instalar desde la URL del repositorio. Verifica que puedes abrir Claude Code y que la terminal que lo lanza encuentra `anansi-mcp` tras instalar.

### Paso 1: instala el núcleo

```bash
pip install "git+https://github.com/mdowis/anansi"
```

Si tu tarea necesita renderizado:

```bash
playwright install chromium
```

### Paso 2: registra MCP en Claude Code

```bash
claude mcp add anansi -- anansi-mcp
```

Abre Claude Code, comprueba la conexión en `/mcp` y pide usar `fetch_url` con `url="https://example.com"` y `format="text"`. Debe devolver el título «Example Domain». Para comprobar extracción de campos, pide después `fetch_and_extract` con esa URL y `selectors={"titulo": "h1"}`. El [contrato oficial de herramientas](https://github.com/mdowis/anansi/blob/main/docs/mcp.md) documenta ambas llamadas. Compara `titulo` con el encabezado de la página antes de probar sitios complejos.

## Comprobación

Verifica varios campos contra la página original. Si cambia un selector, revisa la reparación y no aceptes solo que la ejecución terminó sin errores.

## Si algo falla

Si falta contenido, comprueba si necesita JavaScript y si está instalado Chromium. Para problemas de conexión MCP usa `docs/mcp.md` del repositorio.