Portal da Transparência SP: skill de investigación para datos del estado de São Paulo

TL;DR

• La skill es una CLI en Python, solo biblioteca estándar, que cubre todas las secciones del menú de transparencia.sp.gov.br: las APIs estructuradas, las secciones que no tienen API y los sistemas de origen detrás.
• Diez áreas tienen API estructurada: gastos, contratos, licitaciones, sanciones, convenios, enmiendas, nómina, dietas, tercerizados y obras más pasantes.
• El resto son secciones de navegación y descarga: planificación y presupuesto, ingresos por Power BI y Sigeo, inversiones en PDF, XLSX y CSV, gobernanza pública, participación social, informes, datos abiertos por CKAN y obras paralizadas por Pentaho.
• Cada respuesta llega con el sistema de origen, porque la misma cifra existe en Contratos.gov, Sigeo, SIAF o CKAN y la diferencia entre ellos es lo que suele confundir la lectura.

Qué es y para quién

Portal da Transparência SP es una skill de investigación para el portal de transparencia del estado de São Paulo, con una CLI en Python que usa solo la biblioteca estándar.

Es para el periodista, el analista y el ciudadano curioso que necesitan una cifra del portal y no tienen idea en cuál de las diez áreas vive, si hay API o qué sistema de origen la produjo. También para quien ya descargó un CSV y descubrió que el total no coincide con la página.

Los comandos

S=scripts/sp.py
python3 $S catalogo                 # inventario de áreas y endpoints
python3 $S combos obras             # opciones de filtro de un área
python3 $S buscar obras --param situacao="Em execução"
python3 $S exportar despesas --tipo csv --param anoExercicio=2024
python3 $S dados-abertos --q transparencia --rows 5
python3 $S self-check               # comprobaciones y smoke test en vivo

El primer comando es el que se corre antes que nada: catalogo es un inventario de áreas y endpoints, así que ves qué tiene API antes de escribir una consulta.

Qué cubre

Diez áreas tienen API estructurada: gastos, contratos, licitaciones, sanciones, convenios, enmiendas, nómina, dietas, tercerizados, y obras más pasantes.

Las secciones sin API se tratan como navegación y descarga: planificación y presupuesto, ingresos por Power BI y Sigeo, inversiones en informes PDF, XLSX y CSV, gobernanza pública, participación social, informes, datos abiertos por CKAN, y obras paralizadas por Pentaho del TCE.

El README también nombra los sistemas de origen, que es la parte que convierte una cifra en evidencia: Contratos.gov, Sigeo y FlexCons, SIAF y SIAFIC, e-Sanções y SICAF, GMS, Power BI y el TCE.

El retrato de 2026

El README describe datos de 2020 a 2026, con dietas de 2026, nómina hasta julio de 2026 e inversión de 2026 en el portal de Hacienda. Eso importa porque un total que parece equivocado muchas veces tiene un límite de fecha, no un error de cuenta.

Qué hay dentro del repositorio

SKILL.md trae el enrutado y las reglas de respuesta; references/catalogo.md es el inventario por sección con URL y sistema; references/apis.md trae el contrato de cuerpo por área, los endpoints de combo y los límites conocidos; references/paineis.md cubre los paneles de Power BI, Sigeo, TCE y descarga.

Tests

python3 scripts/sp.py self-check   # offline más smoke test en vivo en /Sancoes/Buscar

El CI ejecuta el self-check en cada push, y eso es lo que mantiene honesta una skill de endpoint en vivo: el portal cambia, y la comprobación avisa antes que el usuario.

Cuándo usarla, cuándo no

Úsala cuando necesites una consulta reproducible en una sección que no conoces, cuando necesites saber qué sistema produjo una cifra, o cuando quieras la misma respuesta dos veces desde una CLI en vez de un camino de clics.

No la uses como portal oficial ni como sustituto, y no asumas que la CLI cubre lo que el portal representa en un gráfico — el README separa las dos cosas, y para totales, gráficos, jerarquías, documentos y detalles fuera del JSON sigues el portal en el navegador.

Sources

1. Portal da Transparência SP — repositorio — áreas con API, secciones sin, sistemas de origen, comandos, referencias y tests citados arriba.
2. README.md — uso rápido, cobertura, referencias, licencia (MIT).

Página del proyecto: Portal da Transparência SP

La skill tiene licencia MIT. Para el portal de Paraná, mira la skill del Portal da Transparência PR, y para el portal federal, la skill del Portal da Transparência.

FAQ

¿Necesita clave de API? El README documenta las APIs estructuradas de las diez áreas y no menciona clave obligatoria; también nombra las secciones que no tienen API.

¿Qué áreas tienen API estructurada? Gastos, contratos, licitaciones, sanciones, convenios, enmiendas, nómina, dietas, tercerizados, obras más pasantes.

¿Se puede leer ingresos? Ingresos es una de las secciones sin API: va por Power BI y Sigeo, y el README apunta a la referencia de panel.

¿Cómo sé si una cifra está actualizada? Revisa el área y la fecha en el retrato de 2026 del README, y sigue el sistema de origen nombrado para cada área.