Portal da Transparência SP: skill de pesquisa para dado do estado de São Paulo

TL;DR

• A skill é uma CLI em Python, só biblioteca padrão, que cobre todas as seções do menu do transparencia.sp.gov.br: as APIs estruturadas, as seções que não têm API e os sistemas de origem por trás delas.
• Dez áreas têm API estruturada: despesas, contratos, licitações, sanções, convênios, emendas, remuneração, diárias, terceirizados, obras mais estagiários.
• O resto é seção de navegação e download — planejamento e orçamento, receitas via Power BI e Sigeo, investimentos em PDF, XLSX e CSV, governança pública, participação social, relatórios, dados abertos via CKAN e obras paralisadas via Pentaho.
• Toda resposta vem com o sistema de origem, porque o mesmo número existe em Contratos.gov, Sigeo, SIAF ou CKAN e a diferença entre eles é o que costuma confundir a leitura.

O que é e para quem

O Portal da Transparência SP é uma skill de pesquisa para o portal de transparência do estado de São Paulo, com CLI em Python que usa só a biblioteca padrão.

É para jornalista, analista e cidadão curioso que precisam de um número do portal e não fazem ideia em qual das dez áreas ele mora, se existe API ou qual sistema de origem o produziu. É também para quem já baixou um CSV e descobriu que o total não bate com a página.

Os comandos

S=scripts/sp.py
python3 $S catalogo                 # inventário de áreas e endpoints
python3 $S combos obras             # opções de filtro de uma á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               # checagens mais smoke test ao vivo

O primeiro comando é o que se roda antes de tudo: catalogo é inventário de áreas e endpoints, então você vê o que tem API antes de escrever consulta.

O que ela cobre

Dez áreas têm API estruturada: despesas, contratos, licitações, sanções, convênios, emendas, remuneração, diárias, terceirizados, e obras mais estagiários.

As seções sem API são tratadas como navegação e download: planejamento e orçamento, receitas via Power BI e Sigeo, investimentos em relatório PDF, XLSX e CSV, governança pública, participação social, relatórios, dados abertos via CKAN, e obras paralisadas via Pentaho do TCE.

O README também nomeia os sistemas de origem, que é a parte que transforma número em evidência: Contratos.gov, Sigeo e FlexCons, SIAF e SIAFIC, e-Sanções e SICAF, GMS, Power BI e o TCE.

O retrato de 2026

O README descreve dado de 2020 a 2026, com diárias de 2026, remuneração até julho de 2026 e investimento de 2026 no portal da Fazenda. Isso importa porque total que parece errado muitas vezes tem fronteira de data, não erro de conta.

O que tem dentro do repositório

O SKILL.md traz o roteamento e as regras de resposta; references/catalogo.md é o inventário por seção com URL e sistema; references/apis.md traz o contrato de corpo por área, os endpoints de combo e os limites conhecidos; references/paineis.md cobre os painéis de Power BI, Sigeo, TCE e de download.

Testes

python3 scripts/sp.py self-check   # offline mais smoke test ao vivo em /Sancoes/Buscar

O CI roda o self-check a cada push, e é isso que mantém skill de endpoint vivo honesta: o portal muda, e a checagem é o que avisa antes do usuário.

Quando usar, quando não usar

Use quando você precisa de consulta reproduzível em seção que não conhece, quando precisa saber qual sistema produziu um número, ou quando você quer a mesma resposta duas vezes por CLI em vez de um caminho de clique.

Não use como portal oficial nem como substituto dele, e não presuma que a CLI cobre o que o portal renderiza em gráfico — o README separa os dois, e para total, gráfico, hierarquia, documento e detalhe fora do JSON, você segue o portal no navegador.

Sources

1. Portal da Transparência SP — repositório — áreas com API, seções sem, sistemas de origem, comandos, referências e testes citados acima.
2. README.md — uso rápido, cobertura, referências, licença (MIT).

Página do projeto: Portal da Transparência SP

A skill tem licença MIT. Para o portal do Paraná, veja a skill do Portal da Transparência PR, e para o portal federal, a skill do Portal da Transparência.

FAQ

Precisa de chave de API? O README documenta as APIs estruturadas das dez áreas e não menciona chave obrigatória; ele também nomeia as seções que não têm API.

Quais áreas têm API estruturada? Despesas, contratos, licitações, sanções, convênios, emendas, remuneração, diárias, terceirizados, obras mais estagiários.

Dá para ler receita? Receita é uma das seções sem API: vai por Power BI e Sigeo, e o README aponta para a referência de painel.

Como sei se um número está atual? Confira a área e a data no retrato de 2026 do README, e siga o sistema de origem nomeado para cada área.