Portal da Transparência PR: skill de pesquisa para dado público do Paraná

TL;DR

• A skill orienta consulta reproduzível nas dez macroáreas do portal da transparência do Paraná, de planejamento e orçamento a obras e ações e informações gerais.
• Ela transforma pergunta em área, objeto, período e métrica, acha o assunto do menu oficial por linguagem natural e consulta os web services públicos em JSON — sem chave de API nos serviços testados.
• Onde o portal é JSF/PrimeFaces, FlexPortal, SIAFIC ou sistema externo, a skill orienta a navegação em vez de fingir que consulta.
• Toda resposta registra fonte, URL, período, data de atualização e sistema de origem, e preserva resposta de erro e resultado vazio em vez de preencher lacuna com suposição.

O que é e para quem

O Portal da Transparência PR é uma skill em português do Brasil para pesquisar dado público do portal da transparência do estado do Paraná com Claude Code e agentes compatíveis.

É para quem faz uma pergunta razoável — quanto foi pago a um fornecedor num mês, o que um órgão gastou em viagem, qual salário um cargo carrega — e recebe uma página de menu. O README declara o que ela não é: não substitui o portal oficial; ela organiza o caminho da consulta, identifica o sistema de origem e ajuda a interpretar o que foi publicado.

O que ela faz

• Transforma pergunta em área, objeto, período e métrica.
• Localiza assunto do menu oficial por linguagem natural, em vez de te fazer adivinhar a seção.
• Consulta web service público em JSON, sem chave de API nos serviços testados.
• Orienta a navegação em página JSF/PrimeFaces, FlexPortal, SIAFIC e sistema externo quando não há serviço.
• Diferencia previsão, empenho, liquidação, pagamento, dotação e saldo — que é a coisa mais útil que uma skill de transparência pode fazer, porque são seis números diferentes que as pessoas confundem de rotina.
• Registra fonte, URL, período, data de atualização e sistema de origem junto com a resposta.
• Converte a primeira lista JSON em CSV para análise pequena.
• Preserva resposta de erro e resultado vazio como estão, sem preencher lacuna com suposição.

Instalação e uso rápido

Copie ou disponibilize o diretório como skill do seu agente: SKILL.md, references/catalogo.md, references/flexportal.md, references/webservices.md e scripts/pr.py. O script usa só a biblioteca padrão do Python 3.

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

A orientação do README sobre parâmetro é específica: para consulta particular, informe o exercício e o mês quando o serviço exigir; para total atual, gráfico, hierarquia, documento e detalhe que não estão no JSON, siga o fluxo do portal no navegador.

Cobertura

O README lista dez macroáreas no total, incluindo responsabilidade fiscal, justiça fiscal, transparência temática, obras e ações, e informações gerais.

Quando usar, quando não usar

Use quando uma pergunta sobre gasto do Paraná precisa terminar em consulta reproduzível, quando você precisa saber qual sistema produziu um número, ou quando quer a mesma resposta duas vezes com a fonte registrada.

Não use como portal oficial, e não espere que toda página seja serviço JSON: o README separa explicitamente serviço de navegação em JSF, FlexPortal e SIAFIC. E não espere lacuna preenchida — resultado vazio continua vazio, por projeto.

Sources

1. Portal da Transparência PR — repositório — o que faz, instalação, uso rápido, tabela de cobertura e o aviso citados acima.
2. README.md — comandos de uso, cobertura, referências, licença.

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

Para o portal de São Paulo, veja a skill do Portal da Transparência SP, e para o portal federal, a skill do Portal da Transparência.

FAQ

Precisa de chave de API? Não nos serviços testados: o README declara que o web service público devolve JSON sem chave de API lá.

Quais áreas ela cobre? Dez macroáreas, de planejamento e orçamento a receita, despesa, pessoal, compras, responsabilidade fiscal, justiça fiscal, transparência temática, obras e ações, e informações gerais.

Qual é a diferença que ela insiste em marcar? Previsão, empenho, liquidação, pagamento, dotação e saldo — seis números distintos que são confundidos de rotina.

E quando não existe web service? A skill orienta o fluxo no navegador: página JSF e PrimeFaces, FlexPortal, SIAFIC e sistema externo.