# Instrucciones para el agente: Ahrefs MCP: consulta datos SEO desde tu asistente

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
- Guía completa: https://lab.wisd.ai/hub/ahrefs-mcp

---

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

### Paso 1: elige un cliente admitido

Comprueba que tienes un plan Lite o superior y unidades disponibles. Estos pasos usan Claude Code: verifica que puedes abrirlo y sigue su [guía oficial](https://docs.ahrefs.com/en/mcp/docs/claude-code).

### Paso 2: conecta Ahrefs

Añade el servidor por HTTP desde la terminal:

```bash
claude mcp add ahrefs https://api.ahrefs.com/mcp/mcp -t http
```

Abre Claude Code y ejecuta `/mcp`; selecciona Ahrefs, inicia sesión, elige el espacio de trabajo y autoriza el acceso. Comprueba la conexión en tu cuenta.

### Paso 3: acota la consulta

Pide un informe pequeño de un dominio, con mercado y periodo explícitos. Usa el cliente admitido, no un script contra la dirección del servidor MCP.

## Comprobación

Compara el resultado con el informe equivalente del panel y consulta las unidades consumidas. Confirma que filtros y alcance de la petición coinciden.

## Si algo falla

Si se alcanza un límite, revisa filas por petición y unidades del plan. Si tu entorno es un script o un puente independiente, cambia a la API pública siguiendo la indicación del proveedor.

[Fuente del procedimiento](https://docs.ahrefs.com/en/mcp/docs/introduction).