arancel-mx
Datos arancelarios de México, verificables y listos para usar
arancel-mx convierte publicaciones oficiales de LIGIE/NICO en una capa de datos abierta, reproducible y fácil de consumir desde archivos, DuckDB, CLI, Python o HTTP.
Español · English
Por qué existe. Los datos arancelarios mexicanos aparecen en fuentes, páginas y documentos con roles distintos. Consumirlos bien exige conservar procedencia, vigencia, jerarquía, evidencia, hashes y una identidad reproducible del dataset. arancel-mx concentra ese trabajo para que una aplicación no tenga que reconstruir su propia versión de LIGIE/NICO.
La experiencia interactiva vive en arancel-mx.vercel.app. GitHub conserva el código, las releases verificables y la documentación profunda.
Qué puedes hacer
| Quiero... | Superficie | Empieza aquí |
|---|---|---|
| Buscar una fracción, HS o NICO desde el navegador | Hub web | arancel-mx.vercel.app |
| Analizar muchas filas con SQL, BI, notebooks o ETL | Datos / DuckDB | arancel-mx data download |
| Consultar códigos y fichas rápidamente | CLI | arancel-mx lookup 01012101 |
| Integrar datos en una aplicación | Python | from arancel_mx import Dataset |
| Consumir una interfaz GET-only/read-only | HTTP / API | GET /v1/meta, /v1/search, /v1/lookup/... |
| Comprobar cómo se produjo un resultado | Auditoría y reproducción | manifest.json, SHA256SUMS, provenance, data verify |
La API HTTP pública es GET-only, read-only y funciona sin API key. El contrato interactivo vive en /docs; /readyz reporta readiness y /v1/meta identifica el dataset servido.
El paquete Python y el dataset se versionan por separado. Una versión del paquete no fija los datos: las releases del dataset usan tags inmutables data-YYYY.MM.DD.
Descargas directas: DuckDB · CSV · JSON · Manifest · SHA256SUMS
Empieza en 60 segundos
pip install arancel-mx
arancel-mx doctor
arancel-mx data download
arancel-mx lookup 01012101
arancel-mx data verify
O usa el mismo front door HTTP público:
curl "https://arancel-mx.vercel.app/v1/meta"
curl "https://arancel-mx.vercel.app/v1/search?q=telefonos&limit=5"
curl "https://arancel-mx.vercel.app/v1/lookup/8517130100"
Para formatos, caché, modo offline y selección explícita de dataset, sigue el inicio rápido y la referencia CLI.
Por qué confiar
La confianza no depende de que el README diga “está actualizado”. Cada publicación válida conserva una cadena verificable desde las fuentes observadas hasta los bytes publicados:
fuentes oficiales
↓
captura + identidad + SHA256
↓
reconciliación y validación
↓
DuckDB canónico + CSV + JSON
↓
manifest + checksums + fuentes capturadas
↓
GitHub Release inmutable
El hub de Vercel es una superficie de consumo. /v1/meta y /v1/search usan la capa operacional read-only sincronizada con releases verificadas; el resto de la API pública se presenta bajo el mismo dominio mediante el runtime FastAPI. La release verificada sigue siendo la fuente de verdad.
Profundiza en roles de fuentes oficiales, fuentes y reconciliación, modelo de datos y proceso de release.
Documentación
| Necesidad | Documento |
|---|---|
| Instalar, descargar y consultar | Inicio rápido · CLI |
| Integrar archivos, Python o HTTP | Consumo externo |
| Entender HS → fracción MX → NICO | Guía NICO/LIGIE |
| Entender procedencia y promoción de fuentes | Roles oficiales · Fuentes · Promoción SNICE_DOCS |
| Consultar el contexto oficial de comercio exterior sin mezclarlo con la tarifa | Mapa de cobertura oficial de comercio exterior |
| Entender el proyecto y sus fronteras | Visión del proyecto |
| Navegar toda la documentación | Centro de documentación |
Alcance
arancel-mx es una capa técnica y pública de datos para LIGIE/NICO, procedencia y consumo reproducible. No pretende ser un sistema completo de comercio exterior. No clasifica mercancías. No constituye asesoría legal.
El código se distribuye bajo Apache-2.0. Para colaborar consulta CONTRIBUTING.md, SECURITY.md, CODE_OF_CONDUCT.md y TERMS.md.
Metadata
Release files for arancel-mx 0.3.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| arancel_mx-0.3.6.tar.gz | 820.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| arancel_mx-0.3.6-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.6 MB
Release files / arancel_mx-0.3.6.tar.gz
| Download URL | arancel_mx-0.3.6.tar.gz |
|---|---|
| Size | 820.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d09e26fe2327710909163a53010395f4efcffc030a0a75c53f61f4e888acf90c
|
|
BLAKE2b-256 checksum How to use checksums |
6cd4dddab2b54b1d7a454c3f7447a653d437c2257b40efa0e8571c3c3591d9f4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 21, 2026.
Transparency logRelease files / arancel_mx-0.3.6-py3-none-any.whl
| Download URL | arancel_mx-0.3.6-py3-none-any.whl |
|---|---|
| Size | 822.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
276ad8edbb85f2e3d7212115e513747efd0cbef5847a6b628c05a45134af2d87
|
|
BLAKE2b-256 checksum How to use checksums |
d9fe8d8b2748a9c8ca071703ed9070c3cedfc435fd1521aee262ee434152d86f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 21, 2026.
Transparency log