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

2026年選挙集計（TSE）— MCP サーバー＋Telegram ボット

ブラジル選挙の公式・暫定結果を、TSEの公開データファイル （resultados.tse.jus.br）から直接取得し、Claude、Cursor、VS Code、および Model Context Protocol のあらゆるクライアント向けの MCP ツールとして提供します。また、オプションでTelegramのインラインボットとしても利用できます。

• 第1回投票 04/10/2026（集計済み、ライブ検証済み） · 第2回投票：日曜日 25/10/2026 — 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}
  ]
}

エージェントへの質問例：「RS州の知事選で誰がリードしていますか？」、 「大統領選の集計状況はどうですか？」、「2024年のカンピーナス市長選の結果」。

第1回投票（04/10/2026）— ライブ検証済み

集計当日の夜、サーバー（イメージ 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}
  ]
}

第2回投票 — 日曜日 25/10/2026

大統領（BR）と、第1回投票で有効票の50％を超える候補がいなかった州の知事が対象です。 turno=2 を指定するだけです。

• 「大統領選の第2回投票の集計状況はどうですか？」 → resumo_brasil(turno=2)
• 「RJ州知事選の第2回投票」 → resultado("RJ", "governador", turno=2)

TSEは投票の少し前に、第2回投票を公式設定（ele-c.json、選挙コードは連邦選挙が6258、州選挙が6260）に追加します。それまでは、turno=2 を指定すると一般的なエラーではなく、その旨を説明するメッセージが返されます。日曜日の25/10には、17時（ブラジリア時間）から結果が表示され始め、集計完了まで apurado_pct が上昇します。第1回投票は引き続き turno=1 で利用できます。

過去の選挙：ano=2022（総選挙、第1回／第2回投票）および 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）。

ご支援

政治的な目的や広告のないボランティアプロジェクトです。開票の夜に役立った場合は、2028 年も続けられるよう Pix でご支援ください。

Pix のコピー＆ペースト用コード（金額自由）：

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

変更履歴

• v0.1.1 (2026-10-05) — 第 1 回投票の夜に発生したホットフィックス：TSE は UF/BR 集計値を 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 時間です。呼び出しごとに全 UF を 走査することはありません。
• User-Agent にはプロジェクトを識別する情報が含まれます。

MIT ライセンス。