Playbooks

Um playbook é um roteiro de extração: de onde vem o dado, qual chamada funciona, o que conferir antes de acreditar, o que declarar como lacuna, e o que o resultado não prova. Termina num CSV que as ferramentas daqui consomem. Quem roda é você — na sua máquina, com as suas ferramentas.

A regra que vale para todos

A IA é sua, o dado é seu, a fonte fica na sua mão. Este site publica o método, não o resultado. Se você usar um assistente para executar o roteiro, ele roda no seu computador ou na sua conta — nada passa por aqui, e não haveria por onde: a política de segurança deste site proíbe qualquer requisição de rede.
Toda linha extraída carrega a sua fonte. Uma coluna com a URL exata de onde o número saiu, e a data em que foi visto. Sem isso o dado não sustenta nada, e você não consegue refazer o caminho seis meses depois.
O que não se achou é dado. Declare a lacuna: "não localizado", "portal fora do ar em tal data", "documento sem o campo". Lacuna declarada é informação; lacuna escondida é erro.
Confirme antes de publicar. Um número de uma fonte só é um indício. Dois documentos independentes que batem é outra coisa — e é o que separa um apontamento de uma acusação.
O escopo é institucional. Os roteiros são sobre ente, órgão, cargo e procedimento. Nenhum é sobre pessoas, e a razão está nos princípios.

Os roteiros

Relatórios fiscais de qualquer ente, sem cadastro

A fonte mais rica e a mais fácil de começar: o SICONFI do Tesouro Nacional publica o RREO, o RGF e o balanço anual de todos os entes do país, em JSON, sem chave nenhuma. Termina na despesa por função pronta para o treemap e na execução bimestral pronta para a série temporal.

Inclui a armadilha que custa mais tempo: o Distrito Federal responde como esfera de estado, não como Distrito Federal, e consultar errado devolve zero linha sem erro nenhum.

População, PIB e geografia, para dar denominador ao dado fiscal

Sem população, "a cidade que mais gastou" é só "a maior cidade". O IBGE publica população, PIB municipal e a geometria dos municípios por API aberta, sem cadastro — e usa o mesmo código de ente que o Tesouro, o que faz as duas fontes conversarem sem tabela de tradução.

Inclui as duas armadilhas de contagem: o país já tem mais municípios do que a malha geográfica mostra, e somar Brasília com o Distrito Federal conta a mesma população duas vezes.

Buscar um termo nos diários oficiais municipais

O diário é onde o ato existe juridicamente. O Querido Diário transforma diários municipais em texto buscável por API aberta — é a forma mais direta de responder "isto foi publicado, e quando".

Com a ressalva que define o uso: menção em diário é publicação, não fato apurado, e ausência de menção não é ausência de ato, porque a cobertura não é nacional.

Contratos e licitações de um órgão, pelo PNCP

Desde a Lei 14.133, todo contrato tem de estar no portal nacional para ter eficácia. A API responde sem chave — devagar, e com limite de pedidos.

Inclui as armadilhas que mais derrubam: data sem hífen, CNPJ só com dígitos, período de até um ano, e o nome do parâmetro que muda de um endpoint para outro.

Transferências da União a um município, pelo TransfereGov

Convênios, contratos de repasse e transferências especiais de emendas, por ente recebedor, sem chave.

Inclui por que usar a API nova, o filtro errado que devolve vazio sem erro, e as colunas com nome de pessoa que devem ser descartadas.

Educação e saúde: o que o município declarou ter aplicado

O percentual em educação pelo SIOPE, do FNDE (API aberta), e em saúde pelo SIOPS, do Ministério da Saúde (formulário), contra os mínimos da Constituição.

Inclui o código de município de 6 dígitos, o bimestre que não é sequencial no SIOPS e o "0" que pode ser indicador não calculado.

Deslocamentos pela agenda oficial

Como pôr no mapa os deslocamentos de quem exerce cargo público, a partir da agenda oficial, com fonte por linha e lacunas declaradas.

O que ainda não está escrito

Estes roteiros estão planejados e ainda não existem — dizer isso é mais honesto que deixar a lista parecer completa: despesa federal pelo Portal da Transparência, que exige cadastro gratuito, e contratações pelo PNCP, cuja API não respondeu em nenhuma das verificações mais recentes. Enquanto isso, os endereços, as armadilhas e o estado atual de cada fonte estão em de onde vem o dado.

Antes de publicar o que sair daqui: como ler um gráfico. Para limpar o arquivo que você baixar: limpar os dados. Educação cívica, não aconselhamento.