Apuração Eleições 2026 (TSE)

2026 年选举计票（TSE）——MCP 服务 + Telegram 机器人

巴西选举的官方和部分计票结果，直接来自 TSE 公共发布文件（resultados.tse.jus.br），作为 Claude、Cursor、VS Code 和任何 Model Context Protocol 客户端的 MCP 工具提供，也可选择作为 Telegram 内联机器人使用。

• 第一轮：2026 年 10 月 4 日（已完成计票，实时验证） · 第二轮：2026 年 10 月 25 日，星期日——使用 turno=2
• 无需密钥，无需注册：TSE 公开发布 JSON。本项目只负责解读代码（sp-c0003-e006259-u.json……）、进行适度缓存（每个文件 ≥ 45 秒，使用 If-Modified-Since）并规范化响应。2026 年，TSE 以与市级文件相同的“完整”格式（dados/<uf>/<uf>-c<cargo>-e<eleicao>-u.json）发布州/巴西汇总数据；简化格式（dados-simplificados/…-r.json，2022 年）已从门户下架——v0.1.1 会读取两种格式，并选择实际存在的格式。
• **中立性：**仅提供官方数字，始终包含 apurado_pct 和 TSE 的时间戳。没有预测，没有评论，没有广告。
• 收录于 awesome-mcp-brasil——一个经过策展和自动验证的巴西 MCP 服务与技能目录（选举 / 政府类别）。

安装

Docker（已发布至 ghcr.io 的镜像）

docker run -i --rm ghcr.io/daniel-filius/apuracao-2026-mcp:v0.1.1

Claude Desktop（claude_desktop_config.json）/ Cursor / VS Code（mcp.json）：

{
  "mcpServers": {
    "apuracao-2026": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/daniel-filius/apuracao-2026-mcp:v0.1.1"]
    }
  }
}

不使用 Docker（Python 3.11+ 和 uv）

uvx --from git+https://github.com/daniel-filius/apuracao-2026-mcp apuracao-mcp

{
  "mcpServers": {
    "apuracao-2026": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/daniel-filius/apuracao-2026-mcp", "apuracao-mcp"]
    }
  }
}

Claude Code：

claude mcp add apuracao-2026 -- uvx --from git+https://github.com/daniel-filius/apuracao-2026-mcp apuracao-mcp
# ou
claude mcp add apuracao-2026 -- docker run -i --rm ghcr.io/daniel-filius/apuracao-2026-mcp:v0.1.1

也已收录于 官方 MCP 注册表，名称为 io.github.daniel-filius/apuracao-2026。

工具

工具	返回内容
listar_eleicoes()	TSE 官方配置中的常规选举（选举周期、代码、日期、轮次、按覆盖范围划分的职位）及可用历史数据
resultado(uf, cargo, turno=1, ano=None, limite=20)	按州（SP、RJ……）或 BR（仅总统）查询官方部分计票结果
resumo_brasil(turno=1, ano=None)	总统选举，全国汇总
municipio(uf, municipio, cargo, turno=1, ano=None)	按市查询官方部分计票结果（精确名称、IBGE 代码或 TSE 代码）

职位：presidente、governador、senador、deputado_federal、deputado_estadual、 deputado_distrital、prefeito、vereador。

每个响应都包含：

{
  "fonte": "TSE – divulgação oficial, resultado parcial",
  "atualizado_em": "04/10/2026 19:32:11",
  "apurado_pct": 87.31,
  "matematicamente_definido": false,
  "eleicao": {"ano": 2026, "turno": 1, "codigo": "…", "ciclo": "ele2026"},
  "cargo": "Governador", "abrangencia": "SP",
  "totais": {"votos_validos": 0, "brancos": 0, "nulos": 0, "abstencao_pct": 0.0, "…": "…"},
  "candidatos": [
    {"posicao": 1, "nome": "…", "numero": "10", "partido": "…", "votos": 0, "pct": 0.0, "situacao": "…", "eleito": false}
  ]
}

向 Agent 提问示例：“RS 州州长选举谁领先？”、“总统选举计票进展如何？”、 “2024 年 Campinas 市长选举结果”。

第一轮（2026 年 10 月 4 日）——实时验证

计票当晚，服务（镜像 v0.1.1）读取了 TSE 的真实文件。resultado("SP", "governador") 的真实响应摘要：

{
  "fonte": "TSE – divulgação oficial, resultado parcial",
  "atualizado_em": "05/10/2026 11:44:29",
  "eleicao": {"ano": 2026, "turno": 1, "codigo": "6259", "ciclo": "ele2026", "nome": "Eleição Ordinária Estadual - 2026 1º Turno"},
  "cargo": "Governador", "abrangencia": "SP",
  "url_tse": "https://resultados.tse.jus.br/oficial/ele2026/6259/dados/sp/sp-c0003-e006259-u.json",
  "apurado_pct": 100.0, "secoes_totalizadas": 103656, "secoes_total": 103656,
  "totais": {"eleitorado": 34081699, "comparecimento_pct": 77.44, "votos_validos": 23130513, "brancos_pct": 5.11, "nulos_pct": 7.26},
  "candidatos": [
    {"posicao": 1, "nome": "TARCÍSIO", "numero": "10", "partido": "REPUBLICANOS", "votos": 14491874, "pct": 62.65, "situacao": "Eleito", "eleito": true},
    {"posicao": 2, "nome": "FERNANDO HADDAD", "numero": "13", "partido": "PT", "votos": 8423656, "pct": 36.42, "situacao": "Não eleito", "eleito": false}
  ]
}

第二轮——2026 年 10 月 25 日，星期日

总统（BR）选举，以及没有候选人获得超过 50 % 有效票的州的州长选举。只需使用 turno=2：

• “总统第二轮计票进展如何？” → resumo_brasil(turno=2)
• “RJ 州州长第二轮选举” → resultado("RJ", "governador", turno=2)

TSE 会在投票前不久将第二轮选举加入官方配置（ele-c.json；联邦选举为 6258，州选举为 6260）。在此之前，turno=2 会返回解释性消息（而非笼统错误）；10 月 25 日星期日，结果将从 17 时（Brasília 时间）开始公布，apurado_pct 会逐步上升，直至计票完成。第一轮结果仍可通过 turno=1 查询。

历史数据：ano=2022（大选，第一轮 / 第二轮）和 ano=2024（市政选举）。

apuracao-mcp --smoke                 # lê o config do TSE e imprime o ciclo/eleições atuais
apuracao-mcp --demo SP governador    # resultado normalizado sem iniciar o MCP

Telegram 机器人（可选）

在任何群组中使用 @Apuracao2026Bot：@Apuracao2026Bot SP governador 或 @Apuracao2026Bot br。 命令：/start、/br、/uf SP [cargo]。

只有在设置了 APURACAO_BOT_TOKEN 时才会启动机器人（参见 .env.example）；未设置令牌时会立即退出。使用长轮询，仅依赖标准库；匿名指标（ID 已哈希）存储于 metrics.jsonl。

APURACAO_BOT_TOKEN=... apuracao-bot

开发

python -m venv .venv && . .venv/bin/activate
pip install -e ".[dev]"
pytest -q                       # fixtures reais do TSE (2022) em fixtures/
python -m apuracao_mcp.server   # stdio

发布：标签 vX.Y.Z → 工作流 publish-mcp.yml 运行测试，将镜像发布到 ghcr.io/daniel-filius/apuracao-2026-mcp，并通过 GitHub OIDC 在官方 MCP 注册表中登记 （server.json）。

支持

这是一个志愿项目，不涉及政治，也没有广告。如果它在计票之夜帮到了你，可以通过 Pix 捐款，助力项目在 2028 年继续运行：

Pix 复制粘贴码（金额不限）：

00020101021226530014br.gov.bcb.pix0131danielfilho.workspace@gmail.com5204000053039865802BR5913DANIEL FILIUS6009SAO PAULO62160512APURACAO20266304CC54

变更

• v0.1.1 (2026-10-05) — 第一轮投票之夜的热修复：TSE 不再在 dados-simplificados/…-r.json 中发布州/巴西汇总数据（404 NoSuchKey），改为通过 dados/<uf>/<uf>-c<cargo>-e<eleicao>-u.json 提供。resultado/resumo_brasil 现在会先尝试完整格式，失败后回退到简化格式（2022 年历史数据），并记住成功使用的格式；测试中加入了真实的 2026 年数据样例（SP 州长、BR 总统、05/10 的 ele-c.json）。
• v0.1.0 (2026-09-28) — 首次发布到 MCP 注册表（ghcr.io 上的 OCI）。

来源与限制

• 数据：TSE 官方公布的数据（https://resultados.tse.jus.br/oficial/…）。本项目与 TSE 无关。“部分”数据可能会在最终汇总前发生变化。
• 缓存：每个结果文件缓存 45 秒，配置缓存 5 分钟，市级列表缓存 1 小时；不会在每次调用时扫描所有州。
• User-Agent 会标识本项目。

MIT 许可证。