English Français العربية

Emendas parlamentares do Brasil

Registre officiel Administration et juridique

Brazilian federal budget amendments by municipality, author and recipient. Paid via Lightning.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http emendas-parlamentares-do-brasil 'https://painel-emendas.pages.dev/mcp'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "emendas-parlamentares-do-brasil": {
            "type": "http",
            "url": "https://painel-emendas.pages.dev/mcp"
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Painel de Emendas — ETL (semana 1)
  2. O que sai em data/out/
  3. Rodar no seu computador
  4. Colocar no ar (custo zero)
  5. Resultado da primeira execução real (02/11/2026)
  6. Pontos a conferir
  7. Próximas etapas

Painel de Emendas — ETL (semana 1)

Baixa as emendas parlamentares do Portal da Transparência, liga cada linha ao município (código IBGE) e gera as tabelas do painel. Roda de graça todo dia no GitHub Actions.

O que sai em data/out/

ArquivoConteúdo
fato_emenda.parquetUma linha por emenda × localidade × ano, com valores empenhado / liquidado / pago, escopo (municipal, estadual, regional, nacional, outro), municipio_ibge, uf e modalidade (pix / outras)
fato_favorecido.parquetQuem recebeu o dinheiro de cada emenda (CNPJ, natureza jurídica), por mês, com municipio_ibge
metricas_municipio.parquetValor recebido por município e ano (a partir dos favorecidos), nº de emendas, autores e favorecidos, posição no ranking da UF
autores.parquetTotais por parlamentar (ou bancada/comissão) e ano
qualidade.json% do valor pago que foi ligado a um município e as 20 localidades não resolvidas de maior valor

Rodar no seu computador

python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python -m pytest -q          # testes com a amostra em tests/fixtures
python -m etl.build          # baixa os dados reais e gera data/out/

ANO_INICIAL=2015 python -m etl.build muda o primeiro ano (padrão: 2020).

Colocar no ar (custo zero)

  1. Crie um repositório público no GitHub e suba esta pasta (Actions é ilimitado em repositório público).
  2. Em Actions, rode o workflow "ETL diário de emendas" na mão uma vez e baixe o artefato qualidade.
  3. Quando quiser publicar os dados: crie um bucket no Cloudflare R2 e, em Settings → Secrets and variables → Actions, cadastre R2_ACCOUNT_ID, R2_ACCESS_KEY_ID, R2_SECRET_ACCESS_KEY e R2_BUCKET. Sem esses segredos o workflow só gera e guarda o relatório.

Resultado da primeira execução real (02/11/2026)

  • 46.510 emendas desde 2020 e 654.094 pagamentos a favorecidos.
  • No arquivo principal, 83% do valor pago vem com localidade "MÚLTIPLO"; por isso o total por município usa o arquivo de favorecidos.
  • 99,8% do valor recebido ficou ligado a um município (5.568 municípios). O resto é "Sem informação" na própria fonte.
  • A API do IBGE não responde a partir do GitHub; a lista de municípios vem de uma cópia pública no GitHub.

Pontos a conferir

  • Nomes das colunas do CSV: o código aceita variações (etl/normalize.py, dicionário COLUNAS). Se o Portal mudar um rótulo, o build para e lista as colunas encontradas; basta acrescentar o novo nome ali.
  • Formato da localidade: os padrões reconhecidos são CIDADE - UF, CIDADE/UF, ESTADO (UF), REGIÃO (REGIÃO) e NACIONAL. O qualidade.json mostra o que sobrou; grafias diferentes entram em ALIASES_MUNICIPIO.
  • Emendas Pix: identificadas pelo nome da ação ("Transferência Especial"). Conferir com o tipo de emenda do arquivo real.
  • Acesso ao Portal a partir do GitHub: se o download falhar por bloqueio de IP estrangeiro, a alternativa é rodar o ETL no seu computador e subir os arquivos para o R2.

Próximas etapas

  • Semana 2: Transferegov (planos de ação das Emendas Pix) e população do IBGE para valor por habitante.
  • Semanas 3–4: páginas estáticas por município e parlamentar.

Questions fréquentes

Qu'est-ce que Emendas parlamentares do Brasil ?

Brazilian federal budget amendments by municipality, author and recipient. Paid via Lightning.

Comment installer Emendas parlamentares do Brasil ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http emendas-parlamentares-do-brasil 'https://painel-emendas.pages.dev/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Emendas parlamentares do Brasil ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

Emendas parlamentares do Brasil est-il open source ?

Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.

Qui maintient Emendas parlamentares do Brasil ?

Il est publié par projects-betanull. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.