Referencia
El catálogo de herramientas.
Leyes y códigos
obtener_articulo_por_numero
Devuelve el texto íntegro de un artículo por número, ley y jurisdicción. Por defecto separa y devuelve solo el número jurídico exacto; conserva sus fragmentos y homónimos permanentes/transitorios. Usa include_family: true solo para incluir también sufijos como Bis, Ter o 153-A…J; cada fila distingue coincidencia_numero: exacta|familia. Sin ley, una primera etapa acotada intenta durante un máximo de 8 segundos devolver hasta 25 leyes candidatas y nunca sus textos completos; elige una y repite la llamada. requiere_ley indica que la grafía no pudo descubrirse con seguridad o que venció ese plazo, no que el artículo no exista. Si llega aviso_sin_exacto, la familia se recuperó pero el miembro solicitado no existe y no debe citarse como encontrado. Si llega aviso_homonimos, revisa posicion_en_ley y estado_vigencia; si llega aviso_solo_transitorio, verifica el artículo sustantivo en la fuente oficial.
- pais
requerido- jurisdicción (p. ej.
MX)
- numero
requerido- número de artículo (p. ej.
123, 1916 Bis)
- ley
- nombre de la ley, para desambiguar
- estado
- entidad federativa, para derecho estatal
- include_family
false por defecto: solo el número exacto; true: incluye además sus sufijos Bis/Ter/A/B…
buscar_articulos_semantico
Búsqueda semántica (vectorial): describe un concepto legal y devuelve los artículos más relevantes con un extracto. Úsala cuando no sabes en qué ley o artículo vive el tema. En México, pedir un estado combina derecho federal y el de esa entidad. Antes de responder un asunto local, revisa cobertura y resultados_estatales_relevantes: el runtime trata similitudes estatales inferiores a 0.70 como vecinos débiles y emite un aviso.
- pais
requerido
- concepto
requerido- el concepto en lenguaje natural
- estado
- incluye derecho federal y el de esa entidad; revisa
cobertura antes de aplicar resultados federales a un caso local
- match_count
- cuántos resultados traer
buscar_articulos_keyword
Búsqueda literal (full-text) por palabra o frase exacta, agrupada por ley y con snippet. Sin costo de embedding — ideal para términos técnicos que se citan textual. Cero coincidencias no prueba que la regla no exista: reduce la frase a un término distintivo o prueba la búsqueda semántica sin restringir la ley.
- query
requerido- palabras a buscar
- pais
requerido
- estado_mx
- entidad federativa
- ley
- acota a una sola ley
leer_indice_ley
Devuelve el índice estructurado de una ley — libros, títulos y capítulos con sus rangos de artículos. Para entender dónde vive un tema antes de traer artículos. Compara total_articulos con articulos_en_corpus; si llega un aviso de índice sin texto, úsalo solo como mapa y consulta la fuente oficial.
Los códigos grandes tienen índices que no caben en una respuesta, así que se devuelven resumidos: solo la jerarquía, sin el detalle de temas por rango. El campo indice_modo dice qué estás viendo — completo, esqueleto, seccion, o con sufijo _truncado — y indice_tokens_completo el tamaño real del índice. Para bajar al detalle de una parte, repite la llamada con seccion. Un índice resumido no prueba que la ley no regule algo.
- pais
requerido
- ley
requerido
- estado
- para leyes estatales
- seccion
- detalle completo solo de las partes cuyo título contenga este texto (p. ej.
De las obligaciones)
buscar_seccion_indice
Prototipo para la Ley Federal del Trabajo de México. Busca en su índice las secciones más afines a un concepto y devuelve rangos de artículos (inicio–fin) con su descripción. Contrasta sus propuestas con buscar_articulos_semantico antes de traer un rango: una similitud inferior a 0.75 o una descripción que mezcla materias no basta para elegir la primera sección.
- pais
requerido
- ley
requerido
- concepto
requerido
- estado
- para leyes estatales
- match_count
fetch_articulos_rango
Trae el texto completo de un rango de artículos de una ley — sin top-K ni muestreo. Incluye artículos derogados con su bandera y acepta como máximo 50 artículos por llamada; divide rangos mayores. Es el paso natural después de leer_indice_ley para analizar un capítulo entero.
- pais
requerido
- ley
requerido
- numero_inicio
requerido
- numero_fin
requerido
- estado
- para leyes estatales
listar_metadata
Descubre los valores válidos de filtro del corpus: países, materias, leyes de un país, estados, tribunales y años de jurisprudencia, o el catálogo de NOMs.
- que
requeridopaises, materias, leyes, estados, tribunales, noms_dependencias o noms
- pais
- contexto de jurisdicción
- estado
- contexto estatal
- dependencia
- sector
- filtros del catálogo NOM
Jurisprudencia
buscar_jurisprudencia_semantico
Devuelve las tesis y sentencias más afines a un concepto jurídico, con tribunal, fecha y extracto del criterio, priorizando la jurisprudencia obligatoria. Formúlala con un concepto corto por llamada — no con la narrativa del caso — y trata similitudes <0.70 como señal de reformular.
- pais
requerido
- query
requerido- un concepto jurídico corto (3–6 palabras)
- materia
- civil, familiar, mercantil, penal, laboral, fiscal, administrativo, constitucional o procesal
- solo_vinculante
- prioriza la jurisprudencia obligatoria — la sube al frente sin descartar tesis aisladas on-topic; no es un filtro de exclusión
- match_count
buscar_jurisprudencia_classic
Búsqueda por filtros, paginada y sin costo de embedding: número o nombre de caso, tribunal, sala, materia y rango de años. Para cuando ya conoces el identificador. tribunal y sala son coincidencia exacta y caso es substring. Si ratio_truncado es verdadero, verifica el criterio en url_original.
materia no es un filtro exacto: incluye también las materias equivalentes — laboral⇄administrativo y constitucional⇄procesal — porque en México un conflicto laboral del personal al servicio del Estado se clasifica como administrativo, y una impugnación constitucional suele ser procesal en su forma. La respuesta devuelve en materias_incluidas las materias realmente filtradas, y cada resultado conserva la suya.
- pais
requerido
- caso
- número o nombre
- tribunal
- sala
- materia
- civil, familiar, mercantil, penal, laboral, fiscal, administrativo, constitucional o procesal
- anio_desde
- anio_hasta
- page
- per_page
buscar_jurisprudencia_interamericana
Búsqueda semántica sobre el corpus incremental de la Corte Interamericana de Derechos Humanos. Por el control de convencionalidad, en asuntos de derechos humanos o constitucionales se consulta junto a la jurisprudencia nacional. Cada resultado indica el tipo de decisión y la procedencia del criterio: Resumen Oficial de la Corte o síntesis que debe verificarse contra el PDF oficial. Fondo, Interpretación y Cumplimiento pueden ser etapas del mismo caso: agrúpalas, no las cuentes como condenas distintas.
- query
requerido- un concepto jurídico corto (3–6 palabras)
- estado
- prioriza decisiones contra ese Estado; si no hay coincidencias entre las candidatas, la respuesta lo advierte y devuelve resultados de todo el sistema
- match_count
Normas Oficiales Mexicanas (NOM)
buscar_nom_semantico
Búsqueda semántica sobre NOMs — etiquetado, seguridad e higiene, sanitarias, ambientales, metrología. Devuelve las normas y numerales más relevantes al concepto; verifica vigencia y reforma en los enlaces oficiales antes de concluir cumplimiento.
- concepto
requerido
- dependencia
- coincidencia parcial, p. ej.
Salud, Trabajo, Economía o COFEPRIS
- sector
- match_count
obtener_nom_numeral
Texto íntegro de uno o varios numerales de una NOM por su clave exacta. El paso de verificación después de buscar_nom_semantico. Si la sección puede ser extensa, consulta primero el índice omitiendo numerales y solicita solo los subnumerales pertinentes.
- clave
requerido- p. ej.
NOM-251-SSA1-2009
- numerales
- cuáles traer; sin él, la estructura de la norma
buscar_noms_por_fraccion
Dada una fracción arancelaria (TIGIE, 8 dígitos; tolera el NICO de 10), devuelve las NOM de despacho aduanero mapeadas en el Anexo 2.4.1. El mapeo es una referencia de descubrimiento con snapshot 2020: confirma el Anexo vigente y sus modificaciones en la fuente oficial antes de tratar la lista como exhaustiva.
- fraccion
requerido- con o sin puntos (p. ej.
8471.30.01)
- pais
- opcional; solo acepta
MX
Boletín judicial
buscar_en_boletin
Movimientos (acuerdos) del propio expediente en los boletines judiciales cubiertos y el TFJA. La lista viva de entidades la devuelve la propia herramienta si pides una no disponible. El número no identifica por sí solo un asunto: puede repetirse entre juzgados y amparos, por lo que conviene desambiguar con parte o juzgado. Los campos parseados son auxiliares; extracto_crudo es el texto autoritativo.
- expediente
requerido- número del propio asunto; formato común
N/AAAA y variantes compuestas propias de algunos tribunales
- entidad
- p. ej.
CDMX, BC, TFJA
- parte
- filtra por nombre de una parte (actor/demandado)
- nombre
- alias deprecado de
parte
- juzgado
- acota a un juzgado
buscar_en_boletin_cdmx
Alias deprecado de buscar_en_boletin con entidad="CDMX". Se conserva temporalmente para clientes existentes; las integraciones nuevas deben usar la herramienta general.
- expediente
requerido- número del propio asunto
- parte
- filtra por nombre de una parte
- nombre
- alias deprecado de
parte