# 💱 Monitor de Divisas y Tipo de Cambio en Vivo (ExchangeRate-API & Fixer.io)

> **Resumen para No Técnicos**: Permite que tu Inteligencia Artificial consulte el precio exacto del dólar, euro y monedas locales de Latinoamérica (pesos mexicanos, colombianos, chilenos, soles peruanos, etc.) en tiempo real, actualizando cotizaciones comerciales y evitando pérdidas por devaluación de la moneda.

| Metadato | Detalle |
|---|---|
| **Tipo** | API REST Oficial de Tasas de Cambio y Divisas |
| **Área Empresarial** | 03. Finanzas, Presupuestos y Comercio Internacional |
| **Nivel de Dificultad** | 🟢 Fácil |
| **Modelo de Costo** | Plan Gratuito con 1,500 solicitudes al mes sin costo |
| **Enlace Oficial** | [ExchangeRate-API](https://www.exchangerate-api.com/) / [Fixer.io](https://fixer.io/) |

---

## 💡 ¿Para qué le sirve a tu empresa? (Valor Real)

En Latinoamérica, la volatilidad cambiaria es un desafío constante. Si compras insumos importados en dólares pero cotizas a tus clientes en moneda local con una tasa desactualizada, puedes terminar **perdiendo dinero en cada venta sin darte cuenta**.

Con esta API conectada a tu IA:
- Tu asistente consulta la tasa de cambio oficial al segundo antes de emitir un presupuesto.
- Aplica el margen de seguridad cambiaria que tú definas (por ejemplo: TRM oficial + 2.5% de comisión bancaria).
- Te dice exactamente cuántos pesos equivalen a la cotización en dólares.

---

## 🎁 ¿Qué valor aporta frente a soluciones tradicionales?

- **Cero desfase en presupuestos**: Tus cotizaciones reflejan siempre el valor real del dinero el día de hoy.
- **Soporte para más de 160 monedas**: Convierte entre USD, EUR, MXN, COP, CLP, PEN, ARS, BRL, etc.
- **Historial de Variación**: Permite a la IA analizar si una moneda se apreció o devaluó en los últimos 30 días para anticipar compras de insumos.

---

## 🔑 ¿Qué necesitas para activarlo?

1. Una cuenta gratuita en [ExchangeRate-API](https://www.exchangerate-api.com/).
2. Tu clave de API generada en 1 clic (no requiere tarjeta bancaria).

---

## ⚙️ Configuración Paso a Paso

Variables de entorno para tu backend o servidor MCP:

```env
# Variables de entorno (.env)
EXCHANGERATE_API_KEY=1234567890abcdef12345678
MONEDA_BASE_EMPRESA=USD
MONEDAS_LOCALES=MXN,COP,CLP,PEN
```

---

## 🤖 Consultor Interactivo (Prompt Guiado para tu IA)

Copia y pega este prompt en tu chat con la IA:

```markdown
Actúa como mi Analista de Tesorería y Riesgo Cambiario.
Vamos a calcular el precio de una cotización multimoneda utilizando la tasa de cambio en vivo.

Por favor, pregúntame:
1. ¿Cuál es el monto original y en qué moneda está expresado (ej: $2,500 USD)?
2. ¿A qué moneda local latinoamericana deseas convertirlo (MXN, COP, CLP, PEN, ARS)?
3. ¿Deseas aplicar algún margen de cobertura cambiaria o comisión bancaria adicional (ej: +2%)?

Con esa información, consultaré la API en tiempo real, calcularé la conversión exacta y generaré una cláusula de validez de la cotización (por ejemplo: "Cotización válida por 5 días calendario sujeta a fluctuaciones mayores al 3%").
```

---

## 🌎 Caso de Uso Real en América Latina

**Empresa**: "Maquinaria Agrícola del Bajío" (Importación de repuestos y tractores en León, México).
- **Problema**: Cotizaban refacciones traídas de EE.UU. a tipo de cambio fijo. Cuando el dólar subía bruscamente, el margen de ganancia de la empresa desaparecía por completo.
- **Resultado con la API**: La IA actualiza automáticamente la lista de precios en pesos mexicanos cada mañana según la tasa de cambio interbancaria oficial. Blindaron sus márgenes de utilidad en un 100%.

---

## 🛡️ Consideraciones de Buenas Prácticas

- **Cláusulas de Vigencia en Cotizaciones**: Incluye siempre en tus propuestas comerciales una nota legal que aclare el periodo de vigencia de los precios en moneda local frente al dólar.
- **Tasa Interbancaria vs. Tasa Comercial**: Recuerda que la tasa interbancaria del mercado puede diferir ligeramente de la tasa que te cobra tu banco local por comprar divisas.