Portal da Transparência PR: skill de investigación para datos públicos de Paraná

TL;DR

• La skill guía consultas reproducibles en las diez macroáreas del portal de transparencia de Paraná, de planificación y presupuesto a obras y acciones e información general.
• Convierte una pregunta en área, objeto, periodo y métrica, encuentra el tema del menú oficial por lenguaje natural y consulta los servicios web públicos en JSON — sin clave de API en los servicios probados.
• Donde el portal es JSF/PrimeFaces, FlexPortal, SIAFIC o un sistema externo, la skill guía la navegación en vez de fingir que consulta.
• Cada respuesta registra fuente, URL, periodo, fecha de actualización y sistema de origen, y conserva las respuestas de error y los resultados vacíos en vez de rellenar huecos con suposiciones.

Qué es y para quién

Portal da Transparência PR es una skill en portugués de Brasil para investigar datos públicos del portal de transparencia del estado de Paraná con Claude Code y agentes compatibles.

Es para quien hace una pregunta razonable — cuánto se pagó a un proveedor en un mes, qué gastó un organismo en viajes, qué salario lleva un cargo — y recibe una página de menú. El README declara lo que no es: no sustituye al portal oficial; organiza el camino de la consulta, identifica el sistema de origen y ayuda a interpretar lo publicado.

Qué hace

• Convierte una pregunta en área, objeto, periodo y métrica.
• Localiza el tema del menú oficial por lenguaje natural, en vez de hacerte adivinar la sección.
• Consulta servicios web públicos en JSON, sin clave de API en los servicios probados.
• Guía la navegación en páginas JSF y PrimeFaces, FlexPortal, SIAFIC y sistemas externos cuando no hay servicio.
• Distingue previsión, compromiso, liquidación, pago, dotación y saldo — lo más útil que puede hacer una skill de transparencia, porque son seis números distintos que se confunden de rutina.
• Registra fuente, URL, periodo, fecha de actualización y sistema de origen junto con la respuesta.
• Convierte la primera lista JSON en CSV para análisis pequeños.
• Conserva las respuestas de error y los resultados vacíos, sin rellenar huecos con suposiciones.

Instalación y uso rápido

Copia o expón el directorio como skill de tu agente: SKILL.md, references/catalogo.md, references/flexportal.md, references/webservices.md y scripts/pr.py. El script usa solo la biblioteca estándar de 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

La orientación del README sobre parámetros es concreta: para consultas particulares, indica el ejercicio y el mes cuando el servicio lo exija, y para totales actuales, gráficos, jerarquías, documentos y detalles que no están en el JSON, sigue el flujo del portal en el navegador.

Cobertura

El README lista diez macroáreas en total, incluyendo responsabilidad fiscal, justicia fiscal, transparencia temática, obras y acciones, e información general.

Cuándo usarla, cuándo no

Úsala cuando una pregunta sobre gasto de Paraná tiene que terminar en una consulta reproducible, cuando necesites saber qué sistema produjo una cifra, o cuando quieras la misma respuesta dos veces con la fuente registrada.

No la uses como portal oficial, y no esperes que cada página sea un servicio JSON: el README separa explícitamente servicio de navegación JSF, FlexPortal y SIAFIC. Y no esperes un hueco rellenado — un resultado vacío sigue vacío, por diseño.

Sources

1. Portal da Transparência PR — repositorio — qué hace, instalación, uso rápido, tabla de cobertura y el aviso citados arriba.
2. README.md — comandos de uso, cobertura, referencias, licencia.

Página del proyecto: Portal da Transparência PR

Para el portal de São Paulo, mira la skill del Portal da Transparência SP, y para el portal federal, la skill del Portal da Transparência.

FAQ

¿Necesita clave de API? No en los servicios probados: el README afirma que el servicio web público devuelve JSON sin clave de API ahí.

¿Qué áreas cubre? Diez macroáreas, de planificación y presupuesto a ingresos, gastos, personal, compras, responsabilidad fiscal, justicia fiscal, transparencia temática, obras y acciones, e información general.

¿Cuál es la diferencia que insiste en marcar? Previsión, compromiso, liquidación, pago, dotación y saldo — seis números distintos que se confunden de rutina.

¿Y cuando no hay servicio web? La skill guía el flujo en el navegador: páginas JSF y PrimeFaces, FlexPortal, SIAFIC y sistemas externos.