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 分

    请在仓库或注册中心条目中声明许可证。