colombia-open

Datos públicos de Colombia, listos para usar en Python.

Los datos públicos de Colombia existen, pero cada uno en su portal y en su formato. Aquí los encuentras limpios, en un mismo lugar y listos para cargar, con su fuente y licencia siempre a la vista.

ParaAnalistasPeriodistas de datosInvestigadoresAgentes de IA

Así se usa

Sin cuentas, sin tokens, sin lidiar con decenas de portales distintos.

$ pip install colombia-open

from colombia_open import ColombiaOpen

hub = ColombiaOpen()
municipios = hub.load_polars("municipios")
municipios.filter(municipios["cod_dpto"] == "05")  # municipios de Antioquia

hub.resolve_municipios(["medellín", "BOGOTÁ, D.C.", "santiago de cali"])
# tolera tildes y mayúsculas → cod_mpio: 05001, 11001, 76001

Hace coincidencia exacta tras normalizar tildes y mayúsculas, no adivina apodos — por eso el ejemplo usa "santiago de cali" y no "cali".

Paquete en PyPI. ¿Usas agentes de IA? Instala el extra mcp y conecta el catálogo a tu agente — ver servidor MCP.

Servidor MCP

El mismo catálogo, expuesto a tu agente por Model Context Protocol. Tres herramientas, no treinta: list_datasets para explorar, describe_dataset para ver el esquema de uno, y query para correr SQL de solo lectura entre todos los datasets a la vez.

$ pip install "colombia-open[mcp]"

# claude_desktop_config.json
{"mcpServers": {"colombia-open": {"command": "colombia-open", "args": ["mcp"]}}}

Ver la documentación del servidor MCP para la lista completa de herramientas y sus límites de seguridad.

Roadmap

Lo ya publicado está arriba, en el Catálogo. Acá solo lo que falta por incorporar.

DominioFuente oficial
Vivienda / edificaciónDANE / Camacol
PobrezaDANE
Consumo eléctricoXM (API pública) / UPME
Economía municipal / finanzas territorialesDNP Terridata
SaludMinSalud — REPS / SISPRO
ClimaIDEAM (vía datos.gov.co)
Agro (EVA)MinAgricultura / UPRA
Contratación pública (SECOP II)Colombia Compra Eficiente
Educación superior (SNIES)MinEducación — SNIES
Biodiversidad (SiB / GBIF)SiB Colombia (vía GBIF)
Empresas (Supersociedades)Superintendencia de Sociedades
ElectoralRegistraduría
Mercado laboral (GEIH)DANE — microdatosLicencia restringida
Calidad de vida (ECV)DANE — microdatosLicencia restringida

¿Falta algo?

¿Conoces una fuente pública que no está aquí?

Con su endpoint verificable y licencia clara, entra directo al roadmap.

Proponer fuente en GitHub

Contribuir

colombia-open es abierto y crece con quien lo usa. Hay tres formas de sumarse, ninguna requiere permiso previo.

01 · Datos

Propón una fuente

Una fuente oficial con endpoint verificable y licencia clara. Cada propuesta pasa por el mismo filtro: procedencia, vigencia y validación.

Proponer fuente

02 · Código

Escribe código

Toma un issue marcado para empezar, comenta que lo trabajas y sigue la guía: una fuente por PR, de punta a punta, con tests y docs.

Ver issues para empezar →Guía de contribución

03 · Comunidad

Conversa

Preguntas de uso, ideas aún sin forma o casos de uso que te gustaría resolver. Un buen lugar para empezar antes de abrir un issue.

Ir a Discussions

Al participar aceptas el Código de Conducta. ¿Encontraste una vulnerabilidad? Repórtala en privado — ver la política de seguridad.