MéxicoAPI

MéxicoAPI

Datos de referencia de México, abiertos y al día, con su fuente oficial.

Cualquier sistema que se hace en México termina necesitando lo mismo:

• estados y municipios;
• bancos y validación de CLABE;
• tipo de cambio y UDIS;
• días inhábiles del SAT o de los bancos;
• UMA, salario mínimo y tablas de ISR.

Hoy cada quien descarga esos datos por su cuenta, los limpia a mano y deja de actualizarlos. MéxicoAPI los publica una sola vez, bien hechos, con su fuente. Un bot revisa las fuentes de los datos automáticos, a diario o cada semana, y los actualiza cuando cambian; los que se transcriben del DOF los captura una persona con cada publicación.

La API v1 ya está en línea en https://mexicoapi.dagel4k.workers.dev, con las descargas y el sitio. Los paquetes mexicoapi y mexicoapi-mcp están en npm desde el 2026-10-18 (0.1.0).

Qué incluye

• API pública de solo lectura, rápida (archivos estáticos en el borde) y gratuita.
• Paquete de npm (mexicoapi) con cliente, validadores y datos para usar sin conexión: npm install mexicoapi.
• Servidor MCP (mexicoapi-mcp) para que los asistentes de IA consulten el dato oficial en vez de inventarlo: npx -y mexicoapi-mcp.
• Descargas completas en JSON, CSV y SQLite.

Cada respuesta indica de dónde salió el dato, su licencia y la fecha de su última actualización.

Datos de la primera versión

Los códigos postales de SEPOMEX no se pueden redistribuir. El paquete trae un comando (mexicoapi sepomex sync) que los descarga directamente de Correos de México en tu máquina y los deja listos para usar.

Datos disponibles hoy

Además, la API valida CLABE, calcula días hábiles con los calendarios de la Ley Federal del Trabajo, la CNBV y el SAT, y responde la UMA vigente en una fecha.

Cada carpeta incluye manifest.json con la fuente, la licencia y el hash, y los archivos fuente en raw/ (los descargados tal cual y, en bancos, la compilación mensual del CEP). Los datos curados (días inhábiles, UMA, salario mínimo e ISR) no tienen raw/: se transcriben del DOF a data/curado/, un YAML por dataset con la cita literal de cada valor, y el comando curar genera su carpeta. Los días que fija una ley no se transcriben: los del art. 12 del CFF en el calendario del SAT (y los del art. 74 de la LFT) los calcula una regla del núcleo, y del SAT solo se capturan las vacaciones. Los términos de uso de cada fuente están en DATA_LICENSE.md.

API

API de solo lectura, con respuestas JSON { data, meta }, descargas completas y especificación OpenAPI, en https://mexicoapi.dagel4k.workers.dev (workers.dev de Cloudflare; todavía sin dominio propio). No pide llave ni cuenta. La referencia está en docs/api/README.md y los errores en docs/api/problemas.md; el despliegue, en docs/operacion/cloudflare.md.

curl https://mexicoapi.dagel4k.workers.dev/v1/estados/25
curl https://mexicoapi.dagel4k.workers.dev/v1/clabe/002010077777777771

El mismo despliegue sirve el sitio, que genera el build con los datos: en / la página de inicio con los datasets, su fuente y las descargas; en /estado/, si cada dataset automático está al día; y en /llms.txt, un resumen de la API para herramientas que leen ese formato, con la documentación completa en /llms-full.txt (detalles).

Documentación

• API v1 y errores
• Paquete mexicoapi: validadores, datos sin red, cliente, SEPOMEX y CLI
• Servidor MCP mexicoapi-mcp: herramientas, configuración del cliente y MEXICOAPI_BASE
• Diseño técnico v1
• Bot de datos
• Datos curados: cómo se transcriben del DOF los calendarios y las constantes
• Publicación en npm: cómo se arman y se publican los paquetes
• Cómo contribuir y política de seguridad

Licencia

El código se publica bajo la licencia MIT. Los datos conservan la licencia de su fuente oficial, indicada en cada dataset.