# Instrucciones para el agente: Firecrawl Alexandria: busca y consulta proveedores de datos con tu agente

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/firecrawl/firecrawl-mcp-server (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/firecrawl-alexandria-data-providers

---

## 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: conecta el MCP autenticado

Sigue la sección Installation del [README oficial](https://github.com/firecrawl/firecrawl-mcp-server/blob/e21d7a2839f02acbedb7e84f5385280d84e15830/README.md). Si tu cliente admite la conexión interactiva por OAuth, configura esta URL como endpoint MCP:

```text
https://mcp.firecrawl.dev/v2/mcp-oauth
```

Completa el flujo de conexión del cliente con una cuenta que tenga acceso a Alexandria. La URL es un endpoint MCP, no una página para abrir como documentación. Si ya existe una entrada de Firecrawl, reutilízala.

Para conexiones con clave, el mismo README documenta https://mcp.firecrawl.dev/v2/mcp y una cabecera Authorization de tipo Bearer configurada en el almacén de secretos del cliente. No pongas la clave en la URL ni en el chat. La conexión sin clave no basta para Alexandria.

### Paso 2: descubre una capacidad

En el cliente conectado, llama a firecrawl_find_tools sin argumentos para ver categorías. Puedes buscar semánticamente con firecrawl_search y sources alexandria. Son llamadas MCP, no comandos del shell.

El README incluye este ejemplo completo de contrato para un proveedor:

```json
{
  "name": "firecrawl_find_tools",
  "arguments": {
    "providers": ["particle"],
    "capabilities": ["podcasts/episodes/search"],
    "expand": ["options", "response", "examples"],
    "limit": 2
  }
}
```

Para tu caso, usa el proveedor y la capacidad descubiertos. Consulta el coste con includeCosts según el contrato de la herramienta. Lee las entradas requeridas, restricciones y campos de respuesta antes de ejecutar.

### Paso 3: recupera datos

El ejemplo oficial de ejecución es:

```json
{
  "name": "firecrawl_scrape",
  "arguments": {
    "alexandria": [
      {
        "provider": "fred",
        "capability": "series/observations",
        "options": { "series_id": "CPIAUCSL" }
      }
    ]
  }
}
```

Antes de usarlo, descubre y revisa el contrato vigente de FRED. Ejecútalo solo cuando hayas comprobado acceso, coste y condiciones. El ejemplo de Particle muestra cómo inspeccionar un contrato; no describe las opciones de FRED.

## Comprobación

Revisa cada elemento de data.alexandria, su proveedor y sus datos o error, además de data.creditsCost. Contrasta periodo, unidades y procedencia de la serie antes de citar sus valores. Conserva el requestId devuelto para diagnosticar una ejecución incierta.

## Si algo falla

Si faltan las herramientas, comprueba autenticación y acceso de la cuenta a Alexandria. Un error de un proveedor puede venir dentro de una respuesta global correcta. Si aparece THIRD_PARTY_DATA_TERMS_REQUIRED, muestra las condiciones y dirige al administrador al panel indicado por requiresAction; MCP no las acepta por él. Tras su confirmación, el README indica reintentar el mismo contenido con el mismo requestId.