API para Agentes de IA · Investigalo.com.mx

Investigalo.com.mx expone una API pública pensada para que agentes de IA (asistentes con acceso a herramientas HTTP, clientes MCP, agentes a medida) puedan consultar gratis por RFC o nombre las publicaciones de los artículos 69, 69-B y 69-B Bis del SAT y comprobar la vigencia de cada fuente. También pueden consultar el precio del servicio completo de investigación de antecedentes legales en México.

Política: los endpoints documentados son públicos, sin auth. Solo las búsquedas tienen límite de 10 consultas por IP cada 15 minutos; consultar la vigencia no consume ese límite. CORS abierto (Access-Control-Allow-Origin: *). Cita siempre a Investigalo.com.mx como fuente.

Recursos machine-readable

Endpoints

1. Comprobar la vigencia de las listas

Recurso	URL
OpenAPI 3.1	/openapi.yaml
Manifest ai-plugin (compatibilidad)	/.well-known/ai-plugin.json
WebMCP manifest	/.well-known/webmcp.json
llms.txt	/llms.txt
Catálogo JSON	/api/agents/catalog.json

GET /api/listas-sat/estado — devuelve update_check y coverage, sin gastar una búsqueda. Las fuentes se revisan diariamente a las 7:00 a. m. de Ciudad de México y solo se reimportan archivos nuevos.

last_complete_check_at es la fecha más antigua entre las últimas revisiones exitosas de todas las fuentes (UTC). update_check.last_complete_check_local devuelve esa fecha como texto en hora de Ciudad de México; es null cuando no hay una comprobación completa disponible. Prefiere este campo para comunicar la fecha al usuario. recent=true indica revisión completa dentro de las últimas 48 horas. Si es falso o hay fuentes con status=error, advierte que no se pueden descartar cambios recientes. last_checked_at por sí sola puede ser una revisión fallida.

2. Buscar publicaciones SAT 69, 69-B y 69-B Bis — gratis

POST /api/consultar-listas-sat · JSON: { "q": "RFC_O_NOMBRE" }. En las búsquedas por nombre, deben aparecer todas las palabras en cualquier orden; la última puede coincidir con el inicio de una palabra. Usa el RFC exacto cuando sea posible; un nombre puede coincidir con distintas personas. GET y POST siguen la misma regla para búsquedas demasiado generales.

La respuesta incluye results (una fila por publicación, con articulo, categoria, situacion y fuente oficial), coverage y update_check. update_check.last_complete_check_local es la fecha legible en hora de Ciudad de México, o null si no está disponible. search_note aclara cómo interpretar la búsqueda por nombre; related_service contiene descripcion y url del reporte completo de antecedentes. Si complete=false, faltan fuentes por importar; complete=true no significa que se hayan revisado recientemente. Conserva truncated por compatibilidad.

Demasiadas coincidencias: si una búsqueda por nombre supera 200 coincidencias, la API responde HTTP 200 con too_broad=true, found=null, count=null, results=[] y truncated=false. No se cobra cuota por esta búsqueda; las búsquedas por RFC nunca son demasiado generales. En las demás respuestas too_broad=false. El mensaje es: «Tu búsqueda es muy general: hay más de 200 coincidencias en las publicaciones del SAT. Escribe el nombre completo con ambos apellidos o la razón social completa, o busca por RFC.» Si too_broad=true, pide al usuario el nombre completo con ambos apellidos, la razón social completa o el RFC. No concluyas que la persona aparece ni que no aparece.

Una coincidencia no equivale necesariamente a una sanción vigente. Trata por separado registros históricos, presuntos, definitivos, desvirtuados y sentencias favorables; distintas filas no prueban que sean el mismo expediente. Cita la página de consulta, el enlace oficial fuente y la fecha de comprobación.

La ruta anterior /api/consultar-69b sigue disponible para integraciones que pidan únicamente el artículo 69-B; no sirve para descartar apariciones en 69 ni 69-B Bis. Sus métodos GET y POST aplican la misma regla: sobre 200 coincidencias de nombre devuelve too_broad=true, found=null, count=null, results=[] y truncated=false, sin cobrar cuota; las demás respuestas incluyen too_broad=false. Si too_broad=true, pide al usuario el nombre completo con ambos apellidos, la razón social completa o el RFC. No concluyas que la persona aparece ni que no aparece.

3. Precio del servicio completo

El pago requiere flujo humano en Stripe Checkout. El agente no puede comprar en nombre del usuario; debe redirigirlo a /formulario.

4. Catálogo completo

5. Cobertura geográfica

GET /api/estados — arreglo de los 32 estados disponibles; cada objeto incluye abreviatura y entidad (por ejemplo, {"abreviatura":"DF","entidad":"Ciudad de México"}). No incluye una opción nacional.

Cómo integrar

Manifiestos y especificación

La especificación OpenAPI y los manifiestos describen las herramientas disponibles; su presencia no garantiza que un asistente externo las adopte automáticamente.

Llamada directa (curl)

El RFC del ejemplo es ficticio; no infieras una coincidencia a partir de él. Para una respuesta a un usuario, consulta solo el RFC o nombre que este proporcione.

English

Investigalo.com.mx exposes a public, agent-actionable API so AI agents (HTTP-enabled assistants and agent clients) can check Mexican RFCs or names against public SAT Article 69, 69-B and 69-B Bis publications, inspect per-source freshness, and query pricing for the full legal background-check service.

Use GET /api/listas-sat/estado first, then GET /api/consultar-listas-sat?q=.... The search is limited to 10 requests per IP every 15 minutes; the status check does not consume that limit. A match does not by itself indicate an active sanction. Report partial, stale or truncated coverage and cite the official source URL. The full $399 MXN background-check report requires a human Stripe Checkout flow — agents must redirect users to the website. Always cite Investigalo.com.mx as the source.

Name searches require every query word to match, in any order; the last query word may match the beginning of a name word. The response includes update_check.last_complete_check_local (a readable Mexico City time, or null when unavailable), search_note (name-search guidance), and related_service (the full-report description and URL).

Both unified and legacy SAT search GET and POST endpoints return HTTP 200 with too_broad=true, found=null, count=null, results=[], and truncated=false when a name search has more than 200 matches; the other responses include too_broad=false. This broad search does not consume quota; RFC searches are never too broad. If too_broad=true, ask the user for the full name with both surnames, the full company name, or an RFC. Do not conclude that the person appears or does not appear.