# Portal da Transparência do Paraná — Skill

Skill em português do Brasil para pesquisar dados públicos do **Portal da Transparência do Estado do Paraná** com Claude Code e agentes compatíveis.

A skill orienta consultas reproduzíveis nas dez macroáreas do portal, incluindo planejamento e orçamento, receitas, despesas, pessoal, compras públicas, responsabilidade fiscal, justiça fiscal, transparência temática, obras e ações e informações gerais.

> Esta skill não substitui o portal oficial. Ela organiza o caminho de consulta, identifica o sistema de origem e ajuda a interpretar os resultados publicados.

## O que ela faz

- transforma perguntas em área, objeto, período e métrica;
- localiza assuntos do menu oficial por linguagem natural;
- consulta Web Services públicos em JSON, sem chave de API nos serviços testados;
- orienta a navegação em páginas JSF/PrimeFaces, FlexPortal, SIAFIC e sistemas externos;
- diferencia previsão, empenho, liquidação, pagamento, dotação e saldo;
- registra fonte, URL, período, data de atualização e sistema de origem;
- converte a primeira lista JSON em CSV para análises pequenas;
- preserva respostas de erro e resultados vazios, sem preencher lacunas com suposições.

## Instalação

Copie ou disponibilize este diretório como uma skill do seu agente:

```text
SKILL.md
references/
  catalogo.md
  flexportal.md
  webservices.md
scripts/
  pr.py
```

O script usa somente a biblioteca padrão do Python 3.

## Uso rápido

```bash
python3 scripts/pr.py self-check
python3 scripts/pr.py buscar salario --area pessoal
python3 scripts/pr.py buscar fornecedor --area despesas
python3 scripts/pr.py consultar receitas/listarorgao --param exercicio=2016
python3 scripts/pr.py consultar receitas/listarreceita \
  --param exercicio=2016 --param mes=1 --csv
python3 scripts/pr.py consultar despesas/listardespesa \
  --param exercicio=2016 --param mes=1 --param orgao=1 --csv
python3 scripts/pr.py menu
```

Para consultas específicas, informe o exercício e o mês quando o serviço exigir. Para totais atuais, gráficos, hierarquias, documentos e detalhes que não estejam no JSON, siga o fluxo do portal no navegador.

## Cobertura

| Área | Exemplos de assuntos |
|---|---|
| Planejamento e Orçamento | PPA, LDO, LOA, alterações orçamentárias e programação financeira |
| Receitas | receita arrecadada, dívida ativa, renúncias e benefícios fiscais |
| Despesas | gastos, pagamentos, credores, convênios e despesas SIAFIC |
| Pessoal | remuneração, servidores, concursos e viagens |
| Compras | licitações, contratos, fornecedores e preços registrados |
| Responsabilidade Fiscal | RREO, RGF, balanços e prestação de contas |
| Justiça Fiscal | devedores, CEIS e CNEP |
| Transparência Temática | instituições, assuntos e parcerias |
| Obras e Ações | obras, projetos, audiências e obras paralisadas |
| Informações Gerais | legislação, diários, patrimônio, downloads e Web Services |

O inventário observado de assuntos e IDs está em [`references/catalogo.md`](references/catalogo.md).

## Fonte oficial

- [Portal da Transparência do Paraná](https://www.transparencia.pr.gov.br/pte/home)
- [Web Services públicos](https://www.transparencia.pr.gov.br/pte/informacoes/webservices)
- [Dados abertos e downloads](https://www.transparencia.pr.gov.br/pte/informacoes/download)

As respostas geradas com esta skill devem citar a fonte oficial e deixar claro quando o dado vem de SIAF/SIAFIC, GMS, FlexPortal, Diário Oficial ou outro sistema vinculado.

## Limites conhecidos

- O catálogo do portal é dinâmico; `python3 scripts/pr.py menu` deve ser usado antes de afirmar que um assunto existe.
- Os Web Services não oferecem necessariamente todos os detalhes publicados na interface.
- Painéis FlexPortal usam estado de sessão e podem exigir navegador para filtros, tabelas e drill-down.
- Valores atuais podem incluir aditivos; sempre compare valor inicial, valor atual e pagamentos efetivos.
- O script não inventa paginação, dados ausentes ou equivalência entre métricas financeiras diferentes.

## Estrutura do repositório

- [`SKILL.md`](SKILL.md): instruções operacionais para o agente.
- [`references/catalogo.md`](references/catalogo.md): mapa de macroáreas, assuntos e URLs.
- [`references/webservices.md`](references/webservices.md): contratos, parâmetros e limitações das APIs públicas.
- [`references/flexportal.md`](references/flexportal.md): rotas, filtros e coleta em painéis FlexPortal.
- [`scripts/pr.py`](scripts/pr.py): cliente CLI sem dependências externas.

## Contribuição

Contribuições são bem-vindas quando preservam a rastreabilidade ao portal oficial. Inclua URL, data de consulta, exercício/período, sistema de origem e comportamento reproduzível. Não inclua credenciais, dados pessoais desnecessários ou cópias de consultas específicas de indivíduos.

## Licença

MIT. Consulte [`LICENSE`](LICENSE).