portal-transparencialisted

# Portal da Transparência (Brasil) Dois modos, nenhum exige chave de API: | | quando usar | script | |---|---|---| | **Massa** | série histórica, tudo de um mês/ano, análise agregada | `pt.py` | | **Consulta** | filtro específico (nome, CNPJ, órgão, período), poucos registros, e os temas sem zip (contratos, convênios) | `site.py` | `pt.py` baixa os zips do bucket aberto da CGU (`dadosabertos-download.cgu.gov.br`) e trata os CSVs localmente. `site.py` consulta as APIs internas do site — que estão atrás de AWS WAF, vencido com browser stealth (Camoufox) + reuso do cookie `aws-waf-token`; detalhes e armadilhas em `references/site-api.md`. Comece pelo modo massa quando a pergunta for agregada ("quanto o MEC gastou em maio"), e pelo modo consulta quando for pontual ("contratos dessa empresa", "salário do servidor X"). `curl`/WebFetch direto no site não funcionam. ## Modo massa ```bash S=~/.claude/skills/portal-transparencia/scripts/pt.py python3 $S datasets # o que existe (filtro opcional: `datasets cartao`) python3 $S descobrir cpgf # período mais recente publicado + tamanho python3 $S baixar cpgf 202605 --dir dados python3 $S colunas dados/202605_CPGF.csv python3 $S agregar dados/202605_CPGF.csv --por "NOME ÓRGÃO" --valor "VALOR TRANSAÇÃO" python3 $S filtrar dados/202605_CPGF.csv --onde "NOME FAVORECIDO~auto posto" \ --cols "NOME ÓRGÃO" "NOME FAVORECIDO" "VALOR TRANSAÇÃO" --out achados.csv ``` `descobrir` antes de `baixar`: a defas