API pública

Base

https://api.postor.com.mx/api/open/v1

Consultas principales

/proveedores/buscar?q=medicamentos&limite=5 devuelve coincidencias públicas. Con el slug elegido, consulta /proveedores/{slug}/adjudicaciones; admite anio, limite y cursor. La paginación cuenta adjudicaciones y conserva el vínculo con su procedimiento.

/estadisticas?dimension=general devuelve los agregados generales. Para un ejercicio usa dimension=anio&clave=2025; para una entidad, dimension=estado&clave=7. Las claves de entidad son las del índice ComprasMX, no INEGI. Estas consultas devuelven {success:true,data:...}; los esquemas y límites actuales están en openapi.json.

Paginación

Los listados e historiales de ComprasMX se recorren por cursor; los parámetros page y offset se rechazan. La colección estatal usa page, como se describe arriba. La búsqueda transversal devuelve coincidencias limitadas por tipo: no equivale a una descarga completa.

Usa page_info.next_cursor. Un cursor recuerda con qué orden y combinación de filtros se generó; se rechaza si se usa con otros, porque si no devolvería una página plausible y equivocada.

Caché

En los recursos GET que devuelven ETag, envía If-None-Match para recibir 304 si no cambiaron. Las llamadas MCP son POST y no usan esa caché condicional. Para mantenerte al día usa /licitaciones/cambios?desde=.

Formatos por página

Los procedimientos aceptan .md, .json y .ocds.json (Open Contracting Data Standard 1.1). Los perfiles y sus historiales aceptan .md y .json, también mediante negociación por cabecera Accept.

MCP para agentes

Endpoint remoto: https://api.postor.com.mx/api/open/v1/mcp. Usa JSON-RPC 2.0 mediante POST, sin autenticación. Descubre nombres, filtros y esquemas actuales con tools/list y ejecuta consultas con tools/call. Las cinco herramientas principales de ComprasMX son:

• buscarProcedimientos: texto y filtros públicos, con cursor para continuar.
• buscarProveedores: encontrar perfiles públicos por nombre; utiliza el slug devuelto.
• obtenerProcedimiento: ficha pública por número, con las adjudicaciones publicadas disponibles.
• listarAdjudicacionesProveedor: adjudicaciones públicas paginadas de un proveedor.
• estadisticasContratacion: agregados publicados, con cobertura y criterio de importes.

Las herramientas previas de perfiles y precios siguen disponibles. Las estatales conservan su colección y cobertura independientes. llms.txtdescribe las URLs y los límites del conjunto de datos.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "buscarProcedimientos",
    "arguments": {
      "q": "medicamentos",
      "limite": 5
    }
  }
}

Los resultados incluyen texto y datos estructurados. Revisa isError: un error de validación o de servicio no significa que la consulta no tenga coincidencias. Si recibes HTTP 429, respeta Retry-After antes de reintentar.

Cómo verificar un resultado

En procedimientos ComprasMX, licitia_url identifica la ficha HTML de Postor; source_id es el identificador público del registro oficial ysource_url enlaza al expediente oficial cuando está disponible. El número de procedimiento sigue siendo la clave de consulta. Un campo ausente o nulo no autoriza a inventar una URL. Los agregados remiten a su página y metodología; no representan un expediente oficial único. Las fichas estatales conservan sus campos html_url y referencias de fuente propias.

Los importes agregados siguen la metodología del sitio: pesos, otras monedas al tipo de cambio de Banxico y contratos por verificar declarados. Una fecha programada no acredita un fallo. La cobertura refleja lo publicado en Postor, no la totalidad de las compras de México. Cita la URL HTML de Postor y, al verificar un expediente, incluye también la referencia oficial disponible.

WebMCP en el navegador

En navegadores compatibles, las páginas de datos abiertos registran las mismas cinco herramientas a partir del contrato del MCP público. En la sección estatal añaden coberturaEstatal, buscarLicitacionesEstatales yobtenerLicitacionEstatal. La herramienta abrirResultadoabre una ficha o búsqueda pública en la pestaña para que la persona vea el resultado.

Recorrido: busca procedimientos o proveedores, consulta el detalle y pasa su URL HTML de Postor a abrirResultado. Consultar datos es de sólo lectura; abrir un resultado cambia la página visible. Las herramientas no requieren una cuenta ni acceden a guardados o archivos de clientes.

WebMCP es experimental y requiere un navegador y agente compatibles con document.modelContext. Su disponibilidad depende de la versión y configuración del navegador. Consulta la documentación de Chrome. Si el navegador no lo admite, puedes usar la API, el MCP remoto y la navegación habitual.

Límites y licencia

600 peticiones por minuto por IP. CC BY 4.0: úsalo para lo que quieras, cita Postor y la URL HTML del recurso, sin sufijo de formato.