プロトタイプ · プレビュー版：公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説
☰ メニュー日本語 設定
初心者モード オン
配色システムに合わせるライトホワイトダーク
言語ไทยEnglish中文日本語한국어EspañolDeutsch

esportsodds.gg

作者：esportsoddsバージョン 0.4.5i★ 0iパソコンで動く
レジストリ名io.github.esportsodds/esportsodds

インストール方法

What it does

CS2 match data for AI assistants: matches, maps, vetoes, rounds, player stats, teams, rankings.

  • Connects パソコンで動く
  • Account or key Needs ESPORTSODDS_API_KEY
  • Category 旅行・地図・天気

インストール

使っているAIアプリを選んで、設定をコピーしてください。

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日

まず：どの AI を使っていますか？

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

esportsodds.gg のキーが必要です（提供元のサイトで作成） · 先にパソコンへ Python (uv) を入れてください（1 回だけ） · パソコン版 Claude アプリ（Windows または Mac）のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server esportsodds.gg を入れてください。順番に：1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う（PopNx MCP の確認済み）：{ "mcpServers": { "esportsodds": { "command": "uvx", "args": [ "esportsodds", "mcp" ], "env": { "ESPORTSODDS_API_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) ESPORTSODDS_API_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、esportsodds.gg のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる（まだなければ）

    もう入っていますか？先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号（例 uv …）が出る = 入っています。この手順は飛ばせます
    • "command not found"（Windows では "is not recognized"）が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac：⌘ + Space を押し、Terminal と入力して Enter

    Windows：スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS（macOS か Windows）用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. esportsodds.gg に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  4. この設定を貼り付けて保存

    {
  "mcpServers": {
    "esportsodds": {
      "command": "uvx",
      "args": [
        "esportsodds",
        "mcp"
      ],
      "env": {
        "ESPORTSODDS_API_KEY": "your-value"
      }
    }
  }
}

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. Claude を終了してもう一度開く

  6. 試してみる

    esportsodds.gg を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が esportsodds.gg を使っていると言うか、回答に esportsodds.gg のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ esportsodds.gg につなげません

esportsodds.gg はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · esportsodds.gg につなげるアプリを使う

  • esportsodds.gg のキーが必要です（提供元のサイトで作成） · 先にパソコンへ Python (uv) を入れてください（1 回だけ） · パソコン版 Claude アプリ（Windows または Mac）のみ。Web やスマホでは使えません
  • esportsodds.gg のキーが必要です（提供元のサイトで作成） · 先にパソコンへ Python (uv) を入れてください（1 回だけ）
  • esportsodds.gg のキーが必要です（提供元のサイトで作成） · 先にパソコンへ Python (uv) を入れてください（1 回だけ）
  • esportsodds.gg のキーが必要です（提供元のサイトで作成） · 先にパソコンへ Python (uv) を入れてください（1 回だけ）

B · 旅行・地図・天気 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

esportsodds.gg のキーが必要です（提供元のサイトで作成） · 先にパソコンへ Python (uv) を入れてください（1 回だけ）

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server esportsodds.gg を入れてください。順番に：1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う（PopNx MCP の確認済み）：claude mcp add --scope user esportsodds --env ESPORTSODDS_API_KEY=your-value -- uvx esportsodds mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) ESPORTSODDS_API_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、esportsodds.gg のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる（まだなければ）

    もう入っていますか？先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号（例 uv …）が出る = 入っています。この手順は飛ばせます
    • "command not found"（Windows では "is not recognized"）が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac：⌘ + Space を押し、Terminal と入力して Enter

    Windows：スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS（macOS か Windows）用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. esportsodds.gg に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. ターミナルを開く

    Mac：Command+スペースで Terminal と入力 · Windows：PowerShell を開く

  4. このコマンドを貼り付けて Enter

    claude mcp add --scope user esportsodds --env ESPORTSODDS_API_KEY=your-value -- uvx esportsodds mcp

    Enter の前に「your-value」を自分のキーに書き換えてください

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. Claude Code で /mcp と入力

    esportsodds.gg が一覧にあり、接続済みと表示されれば OK です

  6. 試してみる

    esportsodds.gg を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が esportsodds.gg を使っていると言うか、回答に esportsodds.gg のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

esportsodds.gg のキーが必要です（提供元のサイトで作成） · 先にパソコンへ Python (uv) を入れてください（1 回だけ）

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server esportsodds.gg を入れてください。順番に：1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う（PopNx MCP の確認済み）：{ "mcpServers": { "esportsodds": { "command": "uvx", "args": [ "esportsodds", "mcp" ], "env": { "ESPORTSODDS_API_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) ESPORTSODDS_API_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、esportsodds.gg のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる（まだなければ）

    もう入っていますか？先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号（例 uv …）が出る = 入っています。この手順は飛ばせます
    • "command not found"（Windows では "is not recognized"）が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac：⌘ + Space を押し、Terminal と入力して Enter

    Windows：スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS（macOS か Windows）用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. esportsodds.gg に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  4. キーを入力

    esportsodds.gg の設定で ESPORTSODDS_API_KEY が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. Cursor の AI チャットを Agent モードで開く

  6. 試してみる

    esportsodds.gg を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が esportsodds.gg を使っていると言うか、回答に esportsodds.gg のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

esportsodds.gg のキーが必要です（提供元のサイトで作成） · 先にパソコンへ Python (uv) を入れてください（1 回だけ）

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server esportsodds.gg を入れてください。順番に：1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う（PopNx MCP の確認済み）：{ "servers": { "esportsodds": { "type": "stdio", "command": "uvx", "args": [ "esportsodds", "mcp" ], "env": { "ESPORTSODDS_API_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) ESPORTSODDS_API_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、esportsodds.gg のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる（まだなければ）

    もう入っていますか？先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号（例 uv …）が出る = 入っています。この手順は飛ばせます
    • "command not found"（Windows では "is not recognized"）が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac：⌘ + Space を押し、Terminal と入力して Enter

    Windows：スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS（macOS か Windows）用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. esportsodds.gg に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  4. キーを入力

    esportsodds.gg の設定で ESPORTSODDS_API_KEY が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. VS Code の AI チャットを Agent モードで開く

  6. 試してみる

    esportsodds.gg を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が esportsodds.gg を使っていると言うか、回答に esportsodds.gg のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら？esportsodds.gg を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け：ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user esportsodds --env ESPORTSODDS_API_KEY=your-value -- uvx esportsodds mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "esportsodds": {
      "command": "uvx",
      "args": [
        "esportsodds",
        "mcp"
      ],
      "env": {
        "ESPORTSODDS_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "esportsodds": {
      "command": "uvx",
      "args": [
        "esportsodds",
        "mcp"
      ],
      "env": {
        "ESPORTSODDS_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "esportsodds": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "esportsodds",
        "mcp"
      ],
      "env": {
        "ESPORTSODDS_API_KEY": "your-value"
      }
    }
  }
}

自分で入力する値

  • ESPORTSODDS_API_KEY 秘密 必須 env
    Your esportsodds.gg API key

説明は英語の原文のままです。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
178/週
接続方法
パソコンで動く
最新バージョンi
0.4.5
レジストリ公開日i
2026年11月2日
コードの最終更新i
2026年11月3日
作者
esportsodds
パッケージ
pypi: esportsodds
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月15日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント esportsodds で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新：12 日前

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性（OSV.dev）

OSV.dev に esportsodds@0.4.5 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日

確認していること → · JSON

作者の方へ：再確認の依頼・情報の誤りの報告

ログイン

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

旅行・地図・天気のほかのサーバーとの比較i

  • このカテゴリのほかの1904件のうち0%よりスターが多い
  • このカテゴリのほかの1904件のうち71%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの1904件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

esportsodds.ggは安全ですか？

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

入力が必要なもの：ESPORTSODDS_API_KEY

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は12 日前、最新バージョン（0.4.5）がレジストリに届いたのは13 日前です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。

代わりに使えるものは？

同じカテゴリには：Mu, Award Travel Finder, Killbottleneck, Whimsical, HasData Google Maps

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方：↓ 週あたりのダウンロードi★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

Mu

News, web search, mail, markets, weather, places, files, calendar, contacts. 67 tools, one endpoint.

作者：micro成長中★ 4403 か月前更新

クラウドで動く✓ micro.mu
接続方法

Award Travel Finder

Search award flight availability and points pricing across 27 airlines and 23 loyalty programs.

作者：AwardTravelFinder初期★ 153 か月前更新

クラウドで動く✓ 提供元 · awardtravelfinder.com
接続方法

Killbottleneck

Free-to-self-host goal and process maps for humans and AI agents, with REST API and MCP.

作者：tengolabs初期↓ 328/週★ 148 日前更新

パソコンで動く✓ 提供元 · killbottleneck.com
インストール

Whimsical

Create and edit flowcharts, mind maps, wireframes, and docs in Whimsical, or search your workspace.

作者：WhimsicalCode初期★ 112 か月前更新

クラウドで動く✓ 提供元 · whimsical.com
接続方法

HasData Google Maps

Google Maps places, reviews, contributor history, photos and posts as JSON. No Google Cloud.

作者：HasData初期↓ 107/週★ 102 か月前更新

パソコンでもクラウドでも✓ 提供元 · hasdata.com
インストール
  • Mu — クラウドで動き、インストール不要 · キー不要
  • Award Travel Finder — クラウドで動き、インストール不要 · キー不要
  • Killbottleneck — パソコンにインストールが必要 · キーが必要
  • Whimsical — クラウドで動き、インストール不要 · キー不要
  • HasData Google Maps — クラウドでもパソコンにインストールでも使える · キーが必要

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

esportsodds

The official Python client for the [esportsodds.gg](https://esportsodds.gg/cs2-api) CS2 data API.

Counter-Strike 2 matches and results, team and player stats, tournaments, rankings and a derived market line, returned as plain Python dicts. Standard library only: there is nothing else to install.

Get CS2 match data and stats without scraping HLTV. This package is a client for a paid API; it is not an official HLTV/Valve API.

Install

pip install esportsodds

Python 3.10 or newer. No dependencies.

Try it first, with no account: set ESPORTSODDS_API_KEY to the public sample key eo_sample_public, which reads a fixed sample of past matches. It is shared by everyone and rate-limited per network address. For evaluation; our Terms apply.

No subscription yet? A free sandbox key reads a fixed sample of past matches, so you can build against real responses first. The quickstart below asks for upcoming matches, which are outside the sample, so with either key start with sandbox_tour.py and a tournament id from the guide. Any request outside the sample raises PermissionDeniedError (sandbox_scope), and its message names the events that work.

Quickstart

from esportsodds import Client

client = Client() # reads ESPORTSODDS_API_KEY from the environment

for match in client.matches.list(status="scheduled", sort="scheduled_at", limit=5).data: print(match["scheduled_at"], match["team_a_name"], "vs", match["team_b_name"])

2026-10-08T14:00:00Z Team A vs Team B

2026-10-08T17:30:00Z Team C vs Team D

Every call returns what the API sent, as ordinary dicts and lists. A list call returns a Page (page.data, page.next_cursor, page.has_more, page.meta); a call for one thing returns a dict.

Matches come newest first unless you say otherwise, which is what you want for results. For scheduled matches that order starts with the fixture furthest away, so the quickstart passes sort="scheduled_at" to get the next ones to be played.

Your API key and the plan

There are two plans, billed monthly or yearly and paid up front: Standard is $99 a month for 50,000 requests and Pro is $299 a month for 150,000 requests. A year costs ten months: $990 a year for Standard and $2,990 a year for Pro, two months free. Requests are counted per account, per calendar month (UTC), across every key the account owns. There is no trial. A free sandbox key reads a fixed sample of past matches, up to 2,000 requests in total, with no card; it is not a plan, and current data needs one. Past your plan's requests, calls get a 429 with the code quota_exceeded until the month resets, and this client raises QuotaExceededError without retrying (retrying cannot help). A spent sandbox key gets sandbox_quota_exceeded, raised the same way (it never resets), and a request outside its sample raises PermissionDeniedError (sandbox_scope, not counted).

The bulk export (matches.bulk() and the walkers built on it) has one more limit. On a Standard account that first subscribed on or after 30 October 2026 you may make up to 250 bulk-export requests a month; past that the API answers 429 with bulk_quota_exceeded, which raises QuotaExceededError without retrying and leaves every other call working. Pro has no bulk limit, and a Standard account that first subscribed before that date has none either.

Create a key in your account after you subscribe, then keep it out of your code:

export ESPORTSODDS_API_KEY="eo_live_..."
  • The client sends the key only in the Authorization: Bearer header, never in a URL. It shows only the last four characters in repr() and never puts the key in an error message or a log line.
  • It talks HTTPS only. Plain http:// is accepted for localhost and other loopback addresses (127.0.0.1, ::1) alone, and redirects are never followed, so a key cannot be sent to a different host.
  • Keep the key on your server. A browser or mobile app should call your backend, not the API.
  • You can look at real responses before subscribing on the public demo.

Configuration

Environment variableMeaning
ESPORTSODDS_API_KEYYour API key, used when api_key is not passed.
ESPORTSODDS_BASE_URLThe API address, used when base_url is not passed.
Client(...) argumentDefaultMeaning
api_keyNoneYour key. When omitted, ESPORTSODDS_API_KEY is read; with neither, ValueError.
base_urlhttps://api.esportsodds.ggThe API address. HTTPS only, except localhost and other loopback addresses.
game"cs2"The title to query. CS2 is the only one with data today.
timeout30.0Seconds to wait for a reply. The bulk export always waits at least 120.
max_retries3Retries per call for the failures listed under Errors. 0 turns retries off.
transportNoneYour own HTTP stack: any object with send(TransportRequest) -> TransportResponse.

A Client is safe to share between threads. Use it as a context manager (with Client() as client:) or call client.close() when you are finished: it closes a custom transport that has a close() method (the default one keeps no connections open, so it has nothing to release).

Methods

Every endpoint is one method. {game} is the client's game, and {id} accepts the UUID or, for teams, players and tournaments, the slug.

CallEndpointReturnsWhat it gives you
client.matches.list()GET /v1/{game}/matchesPageFixtures and results, newest first; filter by status, tournament, team, dates and has, order with sort.
client.matches.bulk()GET /v1/{game}/matches/bulkPageMatches with their maps, stats and more embedded (include=), 25 per request.
client.matches.get(match)GET /v1/{game}/matches/{id}dictOne match; include= embeds teams, tournament, odds or sub-resources.
client.matches.maps(match)GET /v1/{game}/matches/{id}/mapsPageMap-by-map results.
client.matches.stats(match)GET /v1/{game}/matches/{id}/statsPagePer-player stat lines, whole match and per map.
client.matches.vetoes(match)GET /v1/{game}/matches/{id}/vetoesPageThe map pick and ban sequence.
client.matches.rounds(match)GET /v1/{game}/matches/{id}/roundsPageRound-by-round team stats: economy, opening duels, clutches, bomb events.
client.matches.history(match)GET /v1/{game}/matches/{id}/historyPageWhat a match used to say: each change with its value before and after.
client.matches.depth(match)GET /v1/{game}/matches/{id}/depthdictPer-player weapons, grenades, hit groups, duels and flashes.
client.matches.lineups(match)GET /v1/{game}/matches/{id}/lineupsPageEach team's listed roster before the match.
client.matches.streams(match)GET /v1/{game}/matches/{id}/streamsPageThe channels broadcasting a match.
client.odds.list()GET /v1/{game}/oddsPageThe derived market line, as history or as the current board.
client.teams.list()GET /v1/{game}/teamsPageEvery team, alphabetically; find one by name with q.
client.teams.get(team)GET /v1/{game}/teams/{id}dictOne team.
client.teams.h2h(team, opponent=...)GET /v1/{game}/teams/{id}/h2hdictThe head-to-head record between two teams.
client.teams.form(team)GET /v1/{game}/teams/{id}/formPageRecent completed results, newest first.
client.teams.ratings(team)GET /v1/{game}/teams/{id}/ratingsPageThe team's rating history, one point per match.
client.teams.maps(team)GET /v1/{game}/teams/{id}/mapsPageThe team's record on each map.
client.teams.round_stats(team)GET /v1/{game}/teams/{id}/round-statsdictRound-level playstyle rates: side win rates, pistols, opening duels.
client.teams.vetoes(team)GET /v1/{game}/teams/{id}/vetoesdictA team's own picks, bans and deciders per map, with a permaban flag.
client.teams.results(team)GET /v1/{game}/teams/{id}/resultsPageRecent results with every map's score and both teams' ratings going in.
client.teams.rivals(team)GET /v1/{game}/teams/{id}/rivalsPageThe opponents a team meets most, with the head-to-head and rating gap.
client.teams.roster_history(team)GET /v1/{game}/teams/{id}/roster-historyPageThe five players fielded in each recent match, with roster changes.
client.teams.players(team)GET /v1/{game}/teams/{id}/playersdictThe players in the team's newest match with stats, with their last-12-month figures.
client.tournaments.list()GET /v1/{game}/tournamentsPageEvery tournament, newest first; search by name with q.
client.tournaments.get(tournament)GET /v1/{game}/tournaments/{id}dictOne tournament.
client.tournaments.teams(tournament)GET /v1/{game}/tournaments/{id}/teamsPageThe participating teams, by seed.
client.players.list()GET /v1/{game}/playersPageEvery player, alphabetically by nickname; search by nickname with q.
client.players.get(player)GET /v1/{game}/players/{id}dictOne player.
client.players.career(player)GET /v1/{game}/players/{id}/statsdictA player's career totals and averages.
client.players.performance(player)GET /v1/{game}/players/{id}/performancedictLast-12-month figures over recorded maps, each with its percentile among players with a page.
client.players.maps(player)GET /v1/{game}/players/{id}/mapsdictThe player's figures on each map they have a recorded map on.
client.players.matches(player)GET /v1/{game}/players/{id}/matchesPageRecent completed matches, newest first, with the player's own line.
client.players.teams(player)GET /v1/{game}/players/{id}/teamsdictThe player's team history as stints.
client.players.weapons(player)GET /v1/{game}/players/{id}/weaponsdictWeapon and hit-group totals over the last 12 months.
client.rankings.list()GET /v1/{game}/rankingsPageA team or player leaderboard over a rolling three-month window.
client.rankings.history()GET /v1/{game}/rankings/historyPageThe team board at each of the last weekly marks.
client.rankings.round_stats()GET /v1/{game}/rankings/round-statsPageRound-level figures for the top teams, in board order.
client.maps.list()GET /v1/{game}/mapsPageLeague-wide figures for each competitive map.
client.maps.teams(map)GET /v1/{game}/maps/{id}/teamsPageHow each team fares on, and chooses around, one map.
client.coverage.list()GET /v1/{game}/coveragePageWhat data exists and how often it refreshes.
client.model.metrics()GET /v1/{game}/model/metricsPageTransparency metrics for the model line, per market. The model line is coming soon; the list may be empty.
client.ws_token()POST /v1/{game}/ws-tokendictA 60-second ticket for the WebSocket. Costs no requests.
client.health()GET /healthdictThe service status. Needs no key and is never retried.

Filters are keyword arguments named as in the API reference. A list given for a comma-separated filter (has=["rounds", "depth"], include=["maps", "stats"]) is joined for you; a datetime or

冒頭だけを表示しています。続きはリポジトリで読めます