# Portal da Transparência SP — Skill

Skill de pesquisa para o **Portal da Transparência do Estado de São Paulo** (`transparencia.sp.gov.br`), com cliente CLI em Python (só stdlib) cobrindo **todas** as seções do menu, as APIs estruturadas e os sistemas de origem (Contratos.gov, Sigeo, SIAF, CKAN).

## Uso rápido

```bash
S=scripts/sp.py
python3 $S catalogo                 # inventário de áreas/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 + smoke test
```

## O que cobre

- **10 áreas com API estruturada**: despesas, contratos, licitacoes, sancoes, convenios, emendas, remuneracao, diarias, terceirizados, obras + estagiários.
- **Seções sem API** (navegador/downloads): Planejamento e Orçamento, Receitas (Power BI/Sigeo), Investimentos (relatórios PDF/XLSX/CSV), Governança Pública, Participação Social, Relatórios, Dados Abertos (CKAN), Obras paralisadas (Pentaho TCE).
- **Sistemas de origem**: Contratos.gov, Sigeo/FlexCons, SIAF/SIAFIC, e-Sanções/SICAF, GMS, Power BI, TCE.
- **Retrato de 2026**: dados cobrem 2020–2026 (diárias 2026, remuneração até Julho/2026, investimento 2026 no portal da Fazenda).

## Referências

- `SKILL.md` — roteamento e regras de resposta.
- `references/catalogo.md` — inventário por seção com URLs e sistemas.
- `references/apis.md` — contratos de corpo por área, endpoints de combos, limites conhecidos.
- `references/paineis.md` — painéis Power BI, Sigeo, TCE e downloads.

## Testes

```bash
python3 scripts/sp.py self-check   # offline + smoke test ao vivo (/Sancoes/Buscar)
```

CI (`.github/workflows/ci.yml`) roda o self-check a cada push.

## Licença

MIT — veja `LICENSE`.