Emendas parlamentares do Brasil

io.github.projects-betanull由 GitHub 帳號 projects-betanull 發布v1.2.0更新於 Nov 7, 2026

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

已驗證Streamable HTTP可網頁執行金融資料與分析

概覽

AI 產生的概覽

遠端 MCP 伺服器，依鄉鎮市區查詢巴西聯邦議會修正案（emenda）經費資料，提供免費查詢與付費的明細、排名和合約工具。

可以做什麼
  • 依名稱尋找鄉鎮市區，回傳 IBGE 代碼、州別與收到的修正案總額
  • 取得鄉鎮市區彙總：總額、人均金額與頁面連結；付費權杖可含依年度、提案人、受款方（CNPJ）、領域與類型的細分
  • 依總額或人均金額排名鄉鎮市區，可涵蓋全國或單一州（付費）
  • 列出某鄉鎮市區公所近 12 個月在 PNCP 發布的合約，含主要供應商與近期合約（付費）
  • 透過產生 Lightning 帳單購買 24 小時通行證，付款後啟用
適用情境
適合需要快速了解某鄉鎮市區取得的巴西聯邦預算修正案資料、比較不同鄉鎮市區，或查看鄉鎮市區近期合約資料，而不想自行建置從透明入口網站擷取的 ETL 流程時使用。
執行需求
遠端 streamable HTTP 端點；未宣告帳號或 API 金鑰。免費工具無需權杖；付費工具需透過購買與啟用工具支付 Lightning 帳單後取得 24 小時存取權杖。
安裝前請注意
付費工具需透過 Lightning 帳單實際付款，付款確認後才發放權杖。資料來自公開來源（透明入口網站、PNCP），可能不完整或落後。README 提到的 R2 密鑰屬於其 ETL 流程，與使用本端點無關。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Emendas parlamentares do Brasil，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.projects-betanull%2Fpainel-emendas/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "emendas-parlamentares-do-brasil": {
      "type": "http",
      "url": "https://painel-emendas.pages.dev/mcp"
    }
  }
}

README

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

bash
python -m venv .venv && source .venv/bin/activatepip install -r requirements.txtpython -m pytest -q          # testes com a amostra em tests/fixturespython -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.

來源：README.md，提交 0dcca82

工具

6

buscar_municipio

Buscar município

Encontra municípios pelo nome e devolve código IBGE, UF e total recebido em emendas parlamentares (gratuito).

輸入參數nome必填

resumo_municipio

Resumo de emendas do município

Resumo das emendas parlamentares recebidas por um município: total, por habitante e página. Com token pago, inclui por ano, autores, favorecidos (com CNPJ), áreas e tipos.

輸入參數tokencodigo_ibge必填

ranking_municipios

Ranking de municípios

Ranking dos municípios que mais receberam emendas, no Brasil ou numa UF, por valor total e por habitante (municípios acima de 50 mil habitantes). Requer token pago.

輸入參數uftoken必填

contratos_prefeitura

Contratos da prefeitura (PNCP)

Contratos dos últimos 12 meses publicados no PNCP pela prefeitura de um município: principais fornecedores (CNPJ) e contratos recentes. Requer token pago.

輸入參數token必填codigo_ibge必填

comprar_acesso

Comprar passe de 24 h

Gera uma fatura Lightning para um passe de 24 horas às ferramentas pagas. Pague a fatura e depois chame ativar_acesso com o id.

無需輸入參數。

ativar_acesso

Ativar passe

Confere o pagamento de uma fatura gerada por comprar_acesso e devolve o token de acesso de 24 horas.

輸入參數fatura_id必填

版本歷史

3
  1. v1.2.0最新Nov 7, 2026
  2. v1.1.0Nov 5, 2026
  3. v1.0.0Nov 4, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。