Cómo conectar FXMacroData al asistente de IA OpenClaw banner image

Implementation

How-To Guides

Cómo conectar FXMacroData al asistente de IA OpenClaw

Dé a su agente de IA OpenClaw acceso en vivo a anuncios macro, calendarios de lanzamiento, informes COT y datos de divisas en 18 monedas a través de MCP o REST API y automatice las sesiones informativas previas desde cualquier aplicación de chat.

Disponible también en English

Imagínese preguntando a su asistente de IA desde WhatsApp, Telegram o Discord "¿Qué hizo el RBA con las tasas este mes?" y obteniendo una respuesta instantánea y precisa directamente de las publicaciones oficiales del banco central.

Lo que construirás

  • Un asistente de IA con conciencia macro que responde preguntas como "¿Cuál es la última impresión del IPC del EUR?" o "¿Cuándo es la próxima decisión de la Fed?" desde su aplicación de chat preferida
  • Acceso a herramientas MCP de tipo 8+ que cubre anuncios, calendarios de lanzamiento, informes de COT, materias primas, divisas y sesiones de mercado no se requiere una cacerola HTTP
  • Informes automatizados durante la semana que escanear indicadores clave antes de que el Londres o Nueva York abrir y empujar un resumen a su canal

Los requisitos previos

  • Una carrera . ¿ Qué pasa ? instancia (aplicación de escritorio, Docker o CLI cualquier versión con soporte MCP)
  • ¿ Qué ? La clave de la API de FXMacroData para datos no en USD inscribirse en El objetivo de la Comisión es: (Los datos en dólares son gratuitos, no se necesita una clave)
  • Acceso a la red desde su host OpenClaw a fxmacrodata.com
¿Por qué es importante?

¿Por qué los datos macro dentro de su agente IA importa

La mayoría de los operadores de divisas comprueban las macros de la misma manera todos los días: abrir un calendario, buscar impresiones, hacer referencia cruzada con un gráfico. Ese flujo de trabajo es repetitivo, propenso a errores y disperso en múltiples pestañas. Un agente de IA con acceso directo a los datos de macros estructurados colapsa todo eso en una sola interfaz de conversación.

Con FXMacroData conectado, su agente OpenClaw puede responder preguntas ricas en contexto "¿Ha estado la inflación australiana en tendencia al alza o a la baja este año?", "¿Cuál es el diferencial de tasas entre la Fed y el BCE?", "Muéstrame el posicionamiento de COT para futuros de EUR" y devuelva respuestas basadas en datos oficiales, no en titulares de noticias rastrillados.


El método de medición de la presión de los gases de escape es el siguiente:

Ruta A Conexión a través de MCP Recomendado

Protocolo de contexto modelo (MCP) es la forma más rápida de dar a OpenClaw acceso tipo a FXMacroData. Un bloque de configuración y estás listo sin habilidad JSON, sin boilerplate de punto final, sin definiciones manuales de esquema. OpenCrow descubre automáticamente cada herramienta que el servidor expone y las pone a disposición como herramientas de agentes nativas.

Paso 1: Configuración de MCP

Paso 1 Añadir el servidor MCP a su configuración de OpenClaw

Abre el archivo de configuración de OpenClaw (~/.openclaw/openclaw.json o la interfaz de usuario de configuración) y añadir el servidor FXMacroData MCP. Hay dos opciones dependiendo de si desea el servidora alojada o el paquete local de Python:

Opción A: punto final MCP alojado (el más simple cero instalación)

{
  "mcpServers": {
    "fxmacrodata": {
      "url": "https://fxmacrodata.com/mcp"
    }
  }
}

Esto se conecta directamente al servidor MCP de producción FXMacroData a través de Streamable HTTP. Los datos de USD funcionan inmediatamente sin clave API. Para monedas que no sean USD, adjunta tu clave API a la URL:

{
  "mcpServers": {
    "fxmacrodata": {
      "url": "https://fxmacrodata.com/mcp?api_key=YOUR_API_KEY"
    }
  }
}

Opción B: servidor local de MCP a través de uvx

{
  "mcpServers": {
    "fxmacrodata": {
      "command": "uvx",
      "args": ["mcp-server-fxmacrodata"],
      "env": {
        "FXMACRODATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Esto inicia un proceso de servidor local de MCP desde el El servidor de mcp-fxmacrodata Paquete PyPI que utiliza el transporte stdio. Utilice esto para los clientes MCP que no admiten conexiones HTTP remotas (Claude Desktop, Cursor, Windsurf, etc.).

Consejo de seguridad: No pegue su clave de API directamente en un archivo de configuración que se comprometa con el control de versiones. Use el almacén de credenciales de OpenClaw o una referencia de variable de entorno en su lugar: openclaw credentials set FXMACRODATA_API_KEY "YOUR_API_KEY"
Paso 2: Herramientas disponibles

Paso 2 Explorar las herramientas disponibles

Una vez conectado, OpenClaw registra automáticamente todas las herramientas que el servidor MCP expone.

Herramienta Qué hace Ejemplo de pregunta
Indicador_cuestión Obtener series de anuncios históricos para cualquier moneda + indicador "¿Cuál es la última tasa de política de AUD?"
El número de datos Enumerar todos los indicadores y monedas disponibles "¿Qué indicadores hay disponibles para NZD?"
Calendario de lanzamiento Próximas macros con fechas y valores esperados "¿Qué datos macro se publican esta semana?"
cambio de divisas Las tasas de par de divisas al contado "¿A qué precio se cotiza el EUR/USD?"
el número de datos En el caso de las operaciones de negociación de valores, las entidades de crédito deberán tener en cuenta las siguientes características: "Muéstrame el último informe de COT para JPY".
productos básicos Precios de las materias primas (oro, plata, platino) "¿Cuál es el precio actual del oro?"
Sesiones de mercado Estado actual de la sesión de divisas (Sydney, Tokio, Londres, Nueva York) "¿Qué sesiones de FX están abiertas ahora mismo?"
Indicador_visual_artefacto Generar un gráfico interactivo para una serie de indicadores "Grafo de la inflación en dólares en los últimos 2 años".

Su agente decide qué herramienta llamar desde el lenguaje natural. Nunca necesita memorizar nombres de herramientas o parámetros sólo hacer preguntas.

Paso 3: Pruébalo .

Paso 3 Prueba de la conexión

Abra cualquier canal de chat de OpenClaw (Discord, Telegram, WhatsApp o la interfaz web) y haga una pregunta.

What is the current AUD policy rate?

Bajo el capó, OpenClaw emite una llamada de la herramienta MCP:

{
  "tool": "indicator_query",
  "arguments": {
    "currency": "aud",
    "indicator": "policy_rate"
  }
}

El servidor devuelve la serie completa de anuncios y su agente resume el último valor, fecha de anuncio y dirección de cambio en lenguaje sencillo.

Show me the latest EUR CPI reading.
What macro releases are scheduled this week for USD?
What is the COT positioning for GBP futures?
Which FX sessions are open right now?
What is the current gold price?

Cada uno de estos mapas a una herramienta MCP diferente, y OpenClaw los enruta automáticamente. Inflación en dólares¿ Qué ? Tasa de política del AUD¿ Qué ? PIB en euros, y docenas más bajo el Hub de documentos de la API- ¿ Qué ?


El objetivo de la evaluación es el de determinar si el sistema de control de la capacidad de los usuarios es adecuado para el desarrollo de la tecnología de la información.

Camino B Conectar a través de la habilidad REST API El número de personas

Si su compilación de OpenClaw no admite MCP, o si prefiere un control explícito sobre exactamente qué rutas HTTP puede llamar el agente, puede conectar FXMacroData como una habilidad HTTP personalizada.

Paso 1 Guardar su clave API

openclaw credentials set FXMACRODATA_API_KEY "YOUR_API_KEY"

Paso 2 Verificar la respuesta de la API

El anuncio de producción del punto final vive en /api/v1/announcements/{currency}/{indicator}Pruébalo con una rápida curl¿ Qué ?

curl "https://fxmacrodata.com/api/v1/announcements/usd/inflation"

Obtendrá un objeto JSON con metadatos y un data - ¿ Qué es eso ?

{
  "currency": "USD",
  "indicator": "inflation",
  "has_official_forecast": false,
  "start_date": "2025-01-31",
  "end_date": "2026-03-27",
  "data": [
    {
      "date": "2026-03-12",
      "val": 2.83,
      "announcement_datetime": 1770989400
    }
  ]
}

La entrada más reciente en data Los puntos finales de USD son accesibles sin una clave, lo que los hace convenientes para las pruebas iniciales.

Paso 3 Crear la definición de la habilidad

Guarde esto como ~/.openclaw/skills/fxmacrodata.jsonEl ... {{FXMACRODATA_API_KEY}} El marcador de posición se resuelve en tiempo de ejecución a partir de las credenciales que guardó arriba.

{
  "skill_id": "fxmacrodata",
  "name": "FXMacroData",
  "description": "Fetch macroeconomic announcement series from FXMacroData and summarize the latest released value for an indicator and currency.",
  "base_url": "https://fxmacrodata.com/api/v1",
  "auth": {
    "type": "query_param",
    "param": "api_key",
    "credential": "FXMACRODATA_API_KEY"
  },
  "endpoints": [
    {
      "id": "fetch_announcements",
      "method": "GET",
      "path": "/announcements/{currency}/{indicator}",
      "description": "Return the historical announcement series for one currency and indicator.",
      "parameters": {
        "currency": {
          "type": "string",
          "description": "ISO currency code — e.g. aud, eur, gbp, usd, nzd, cad, chf, jpy, hkd, sgd, nok, sek, dkk, pln, brl, cny, krw, mxn",
          "required": true
        },
        "indicator": {
          "type": "string",
          "description": "Indicator slug — e.g. policy_rate, inflation, gdp, unemployment, non_farm_payrolls, retail_sales, trade_balance",
          "required": true
        }
      }
    }
  ]
}

Recargar habilidades después de guardar:

openclaw skills reload

Paso 4 Pruébalo

Haga una pregunta en lenguaje natural en cualquier canal de chat conectado:

What is the latest AUD policy rate?

OpenClaw lo asigna a la fetch_announcements punto final con currency=aud ¿ Qué ? indicator=policy_rate, llamadas el punto final de la tasa de política de AUD, y devuelve un resumen en inglés sencillo.


El Consejo Europeo ha aprobado una propuesta de directiva sobre la protección de los consumidores.

MCP vs REST API habilidad ¿Cuál debería usar?

MCP (recomendado)

  • Un bloque de configuración, cero boilerplate
  • Acceso a 9 herramientas (anuncios, calendario, COT, materias primas, divisas, sesiones, gráficos)
  • Herramientas y esquemas de detección automática
  • Credenciales a través de entornos

Habilidad de API REST

  • Funciona con todas las versiones de OpenClaw
  • Control de las rutas a las que el agente llama
  • Formato de habilidad JSON familiar
  • Usted define exactamente qué puntos finales están expuestos

Ambos enfoques utilizan la misma API de producción de FXMacroData subyacente en fxmacrodata.com. MCP añade una abstracción de herramienta escrita en la parte superior.


¿Qué es lo que se está haciendo?

Escenarios del mundo real

Una vez que la conexión está activa, aquí están los tipos de flujos de trabajo que se vuelven naturales:

Escaneo de macro antes de la sesión

Antes de la apertura de Londres, pídale a su agente que escanee las huellas de la noche:

Summarize any macro releases from the last 24 hours for USD, EUR, GBP, and JPY. Flag anything that moved more than expected.

Su agente llama . indicator_query para cada indicador clave de cada moneda y compara los últimos val con previous para sacar sorpresas a la superficie.

Monitoreo del diferencial de tasa

Seguimiento del diferencial de tipos de interés entre dos bancos centrales:

What is the current policy rate for Australia vs New Zealand? What is the rate differential?

Dos . indicator_query El agente hace las matemáticas y informa el spread de transporte.

Planificación comercial basada en el calendario

Compruebe lo que viene antes de abrir una posición:

Is there any high-impact USD data coming out this week? I am thinking about going long EUR/USD.

El agente llama . release_calendar para los eventos en USD, evalúa el riesgo y responde con una vista de calendario.

Verificación del posicionamiento del COT

Medir el sentimiento especulativo antes de una posición:

What does the latest COT report say about EUR positioning? Are specs net long or short?

Las llamadas . cot_data y resume el posicionamiento neto no comercial y el cambio semanal.


El objetivo de la presente propuesta es la mejora de la calidad de la información y la calidad del trabajo.

Automatizar una sesión informativa de macro de un día laborable

El verdadero poder de conectar una API de datos a un agente siempre activo es la automatización. Configure un flujo de trabajo programado de OpenClaw que ofrezca una sesión informativa macro matutina antes de comenzar a operar.

Crear un archivo de flujo de trabajo en ~/.openclaw/workflows/fx_morning_briefing.json¿ Qué ?

{
  "workflow_id": "fx_morning_briefing",
  "schedule": "0 7 * * 1-5",
  "description": "Weekday morning FX macro briefing at 07:00 UTC — covers key indicators and upcoming calendar events.",
  "steps": [
    {
      "skill": "fxmacrodata",
      "endpoint": "fetch_announcements",
      "params": { "currency": "usd", "indicator": "policy_rate" },
      "label": "Fed Funds Rate"
    },
    {
      "skill": "fxmacrodata",
      "endpoint": "fetch_announcements",
      "params": { "currency": "eur", "indicator": "inflation" },
      "label": "EUR Inflation"
    },
    {
      "skill": "fxmacrodata",
      "endpoint": "fetch_announcements",
      "params": { "currency": "gbp", "indicator": "unemployment" },
      "label": "GBP Unemployment"
    },
    {
      "skill": "fxmacrodata",
      "endpoint": "fetch_announcements",
      "params": { "currency": "aud", "indicator": "policy_rate" },
      "label": "RBA Policy Rate"
    }
  ],
  "output_channel": "your-channel-id"
}

Ajusta el schedule El cron se puede ajustar a su zona horaria y sesión de negociación. 0 6 * * 1-5 Un comerciante de Nueva York podría preferir 0 12 * * 1-5 (UTC / 08: 00 ET).

Recargar flujos de trabajo después de guardar:

openclaw workflows reload

Cada mañana de los días laborables, OpenClaw recupera los valores más recientes, los compila en una sesión informativa consolidada con lecturas actuales y cambios recientes y empuja el resumen a su canal configurado.


¿Qué construiste? ¿Qué fue lo que construiste?, ¿qué fue lo qué construiste?.

Lo que construiste

  • Conectado FXMacroData a OpenClaw a través de MCP o REST API habilidad
  • Le dio a su agente acceso a los datos de anuncios macro en 18 monedas
  • Las consultas en lenguaje natural probadas para tasas de interés, inflación, PIB y más
  • (MCP) Herramientas de escritura desbloqueadas para calendarios de lanzamiento, informes de COT, materias primas y divisas
  • (Opcional) Configurar las sesiones informativas de macro automáticas durante la semana
¿Qué es lo que está pasando?

Los siguientes pasos

  • Ampliar la cobertura de sus indicadores explorar el catálogo completo con data_catalogue o busque en el Documentación de las APILos puntos finales abarcan las tasas de interés, la inflación, el PIB, el desempleo, la balanza comercial, las ventas al por menor, Rendimientos de los bonos a 10 años, y más en las 18 monedas apoyadas.
  • Combina con una habilidad comercial conecta OpenClaw a la API de tu corredor junto con FXMacroData para que el agente pueda obtener una lectura macro y un precio en vivo en la misma respuesta.
  • Construir alertas condicionales sólo se activará una notificación cuando un tipo de interés de política cambie, cuando el IPC cruce un umbral o cuando el posicionamiento de la COT pase de largo neto a corto neto.
  • Utilice el calendario de lanzamiento de manera proactiva que su agente le avise antes de eventos de alto impacto para que pueda gestionar la exposición al riesgo antes de las huellas.

El equipo de FXMacroData

Blogroll