The latest articles on DEV Community by Luciano Matos Santos (@lucianoms). https://dev.to/lucianoms https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F2596960%2F14ced3c9-5986-4d0d-b564-0df9b63b857c.png https://dev.to/lucianoms en Luciano Matos Santos Fri, 16 Oct 2026 15:23:34 +0000 https://dev.to/lucianoms/como-detecto-cambios-en-apis-mexicanas-automaticamente-gratis-con-github-actions-4d22 https://dev.to/lucianoms/como-detecto-cambios-en-apis-mexicanas-automaticamente-gratis-con-github-actions-4d22 <p>Si alguna vez integraste un PAC para timbrar CFDI, SPEI o una paquetería mexicana, seguro te pasó: algo cambió en la documentación y te enteraste cuando producción ya estaba fallando. Muchas de estas APIs no tienen changelog, y las que sí lo tienen no siempre avisan.</p> <p>Me cansé de eso y armé <a href="https://apisdemexico.pages.dev" rel="noopener noreferrer">APIs de México</a>, un directorio gratis en español de 36 APIs que usamos aquí y que revisa cada mañana si cambió algo. Aquí les cuento cómo funciona por dentro.</p> <h2> Dos tipos de fuente </h2> <ul> <li> <strong>Feeds y changelogs oficiales (13 APIs).</strong> Fáciles: se descargan y se compara la última entrada.</li> <li> <strong>Páginas de documentación (23 APIs).</strong> Aquí está lo difícil: no hay feed, así que hay que guardar una "foto" de la página y compararla con la del día anterior.</li> </ul> <h2> La arquitectura </h2> <ol> <li>Un script en Python descarga cada fuente.</li> <li>Extrae solo el texto relevante y guarda un snapshot en el mismo repo.</li> <li>Compara contra el snapshot anterior y, si hay cambio real, lo registra con un resumen.</li> <li>Genera un sitio estático (con RSS por API) y lo publica en Cloudflare Pages.</li> </ol> <p>Guardar los snapshots en git me da el historial completo gratis: cada cambio queda como un commit.</p> <h2> Matar el ruido </h2> <p>El primer día casi todo "cambiaba". Las páginas traen fechas, banners, scripts e IDs aleatorios que se mueven solos. WhatsApp Business y UPS eran los peores.</p> <p>Lo que funcionó:</p> <ul> <li>Quitar scripts y estilos y quedarme solo con el texto.</li> <li>Normalizar espacios en blanco.</li> <li>Reemplazar con un comodín los patrones que siempre cambian (fechas, horas, tokens).</li> <li>Para algunas páginas, leer solo un selector concreto en vez de todo el HTML.</li> </ul> <p>Con eso los falsos positivos desaparecieron y quedaron solo cambios de contenido.</p> <h2> Corre solo con GitHub Actions </h2> <p>Un workflow con <code>cron</code> corre todos los días a las 6 am hora de Mérida (12:00 UTC), detecta, hace commit de los snapshots y despliega a Cloudflare con un secreto del repo. No hay servidor.</p> <h2> El primer cambio real </h2> <p>El primer día ya detectó algo de verdad: un incidente en la página de estado de Mercado Pago que pasó a resuelto.</p> <h2> Costo </h2> <p>$0 al mes: GitHub Actions y Cloudflare Pages en sus planes gratuitos.</p> <h2> ¿Qué API agrego? </h2> <p>El directorio no pide registro y tiene RSS por API y un boletín semanal: <a href="https://apisdemexico.pages.dev" rel="noopener noreferrer">https://apisdemexico.pages.dev</a></p> <p>¿Qué API mexicana o de LatAm les ha roto algo sin avisar? Los leo en los comentarios.</p> spanish api githubactions webdev