BirdieAPI

BirdieAPI MCP サーバー

ゴルフデータ API です。 PGA ツアーのリーダーボード（順位、賞金、ポイント）、ラウンドスコアとホールごとのスコアカード、各ホールのパーとヤーデージを含むコース情報、選手とコースの履歴、独自のフィールド対比ストローク評価、パー3／4／5のスコア内訳、そして男子4大メジャーの優勝者オッズをスポーツブック別に提供します。LPGA、LIV、DP ワールドツアー、コーンフェリーツアーでも同じツールを利用できます。REST API と MCP サーバーを提供します。毎月500クレジットを無料で利用でき、カードは不要です。

ウェブサイト：https://birdieapi.com · ドキュメント：https://birdieapi.com/docs · キーの取得：https://birdieapi.com/signup

You:    "How did Scottie Scheffler score on each hole of the 2025 Masters?"
Claude: [calls get_scorecard]

You:    "Which players have the best record at Pebble Beach since 2010?"
Claude: [calls get_course_history]

You:    "What did sportsbooks price Scottie Scheffler to win the 2025 Masters?"
Claude: [calls get_winner_odds]

ローカルで実行する（stdio）

ほとんどのクライアントは https://mcp.birdieapi.com/mcp に直接接続します。代わりにローカルプロセスを起動するクライアントを使用する場合：

git clone https://github.com/noahowsh/birdieapi-mcp.git && cd birdieapi-mcp && npm install
BIRDIEAPI_API_KEY=your_key node index.js

{ "mcpServers": { "birdieapi": { "command": "node", "args": ["/path/to/birdieapi-mcp/index.js"], "env": { "BIRDIEAPI_API_KEY": "your_key" } } } }

この設定では、キーを使ってホスト型サーバーに転送するため、すべてのツールとクレジット消費量は同じです。

スキル

skills/ にある16個の無料 Claude スキルを使うと、これらのツールを活用して Claude をゴルフアナリストとして利用できます。トーナメントや選手の検索、フィールド対比ストローク評価、パー3／4／5やホールごとのスコア分析、コース適性、トーナメントのシミュレーション、4大メジャーの優勝者予想市場のオッズ計算に加え、独自モデルを検証するための手法（リークのない特徴量、ウォークフォワード検証、キャリブレーション、エッジ検出、バックテスト）も含まれています。

git clone https://github.com/noahowsh/birdieapi-mcp.git

Claude Code プラグインとしてインストールすることもできます：

/plugin marketplace add noahowsh/birdieapi-mcp
/plugin install birdieapi-skills@birdieapi

または、スキル CLI を使います：npx skills add noahowsh/birdieapi-mcp。

Claude に skills/ フォルダーを指定し、以下の MCP サーバーに接続してライブデータ（毎月500クレジット無料、カード不要）を利用し、質問してください。どのスキルを使えばよいかわからない場合は、dispatch スキルから始めてください。全カタログは skills/README.md にあります。

Python

公式 Python クライアントは PyPI で提供されています：birdieapi。

pip install birdieapi
export BIRDIEAPI_API_KEY=sk_live_...

from birdieapi import Client

client = Client()

events = client.list_tournaments(status="final", limit=3)["tournaments"]
for e in events:
    print(e["tournament_id"], e["name"], e["winner_name"], e["winning_to_par"])

無効なキー、クレジット不足、見つからない項目、レート制限に対応する型付きエラー、自動再試行、pandas 用の to_dataframe を備えています。

クイックスタート

これは Streamable HTTP を介したホスト型（リモート）MCP サーバーです。インストールは不要です。

Claude Code

claude mcp add --transport http birdieapi "https://mcp.birdieapi.com/mcp?key=YOUR_API_KEY"

Claude Desktop、Cursor、その他のクライアント

{
  "mcpServers": {
    "birdieapi": {
      "url": "https://mcp.birdieapi.com/mcp?key=YOUR_API_KEY"
    }
  }
}

キーは x-api-key ヘッダーまたは Authorization: Bearer で送信することもできます。キーがなくても接続してツール一覧を取得できますが、ツールの呼び出しにはキーが必要です。

REST

curl -X POST https://mcp.birdieapi.com/v1/list_tournaments -H "x-api-key: YOUR_API_KEY"

すべてのツールは JSON ボディを指定して POST /v1/{tool} で呼び出します。

使用例

examples/ に、実行可能な Python（標準ライブラリのみ）および Node 18+（依存関係なし）の例があります：

• examples/python/quickstart.py と examples/node/quickstart.mjs：スケジュールと概要取得の呼び出し。
• examples/python/golf_major_leaderboard_and_odds.py：メジャー大会1試合の前後を比較します。

export BIRDIEAPI_API_KEY=your_key
python3 examples/python/quickstart.py
node examples/node/quickstart.mjs

詳細は examples/README.md をご覧ください。https://birdieapi.com/signup で無料キー（毎月500クレジット、カード不要）を取得できます。

ツール（14）

ツール	返される内容
list_tournaments	シーズンのトーナメント。日程、優勝者、賞金総額、コースを含みます
search_players	名前で選手を検索します
get_schedule	今週と今後のトーナメント、および開催コースを返します
get_leaderboard	トーナメントの全リーダーボード。順位、ラウンド、合計、獲得賞金、ポイントを含みます
get_scorecard	トーナメントにおける選手のホールごとのスコアカード。パーとヤード数を含みます
get_course	トーナメント用に設定されたコース。各ホールのパーとヤード数、および各ホールのプレー状況を含みます
get_ratings	当社のフィールド平均との差ストローク評価。フィールドの強さを調整した全アクティブ選手の評価です
get_player	プロフィール、評価、シーズン成績、直近の順位です
get_player_results	シーズン別の選手のトーナメントとラウンド、およびフィールド平均との差ストロークです
get_player_stats	シーズン別の選手の成績。スコアリング、バーディー、パー3／4／5のスコアリング、ドライビング、グリーン、パッティングを含みます
get_course_history	1つのトーナメントまたはコースにおける選手の各年の記録です
get_head_to_head	両方が出場したすべてのトーナメントにおける、2人の選手の順位とラウンドです
get_leaders	算出または保持している任意のスタッツのシーズンリーダーです
get_winner_odds	4つのメジャーの第1ラウンド前の優勝オッズ。ブックメーカー別の開幕時と最新のオッズ、および暗黙の確率を含みます

リーグ：golf（デフォルト、PGA Tour）、lpga、liv、dpwt、kornferry（任意のツールに league を渡します。省略するとPGA Tourになります）。

データ

• 2001年以降のPGA Tourのリーダーボード、ラウンド、ホールごとのスコア
• 同じツールで、LPGA、LIV、DP World Tour、Korn Ferry Tour（ホールごとのデータは2007年以降）
• 各ホールのパーとヤード数、および各ホールのプレー状況を含むコースデータ、選手のコース履歴、対戦成績
• 当社のフィールド平均との差ストローク評価（フィールドの強さを調整済み）と、パー3／4／5のスコアリング内訳（平均値に加え、PGA TourとKorn Ferry Tourのホールタイプ別のフィールド平均との差ストローク）。ショット単位のストロークスゲインではなく、スコアに基づいています
• メジャーの優勝オッズ（get_winner_odds）：男子4大メジャーの優勝オッズをブックメーカー別に収録。第1ラウンド前の開幕時と最新のオッズを、2021年以降のすべてのメジャーと2020年のU.S. Openについて提供します（過去のメジャーの最新オッズは、最初のティーオフの最大1週間前のものとなる場合があります）。開催予定のメジャーの市場が開いている間は毎日、トーナメント開催週は6時間ごとに更新します
• ラウンド、マッチアップ、トップ10、その他のトーナメントのオッズ、および他のツアーのオッズはありません

シーズンごとのカバレッジはデータベースからリアルタイムで読み込まれます：https://birdieapi.com/docs

料金

毎月500クレジット無料。カード登録は不要です。プラン：Starter 月額$19（10,000クレジット）、Pro 月額$49（30,000クレジット）、Scale 月額$149（125,000クレジット）。$5からウォレットにチャージでき、クレジットに有効期限はありません。https://birdieapi.com/pricing

便利なページ

• ドキュメント：https://birdieapi.com/docs（すべてのエンドポイントと実際のレスポンス）
• データアトラス、シーズン別のカバレッジ：https://birdieapi.com/data
• ゴルフメジャーのオッズ一覧（ブックメーカー別の優勝オッズ）：https://birdieapi.com/odds
• メジャー優勝オッズのデータ：https://birdieapi.com/data/major-winner-odds
• ホールごとのデータ：https://birdieapi.com/data/pga-tour-hole-by-hole-data
• ガイド（Python、JavaScript、cURL）：https://birdieapi.com/guides
• 用語集（フィールド平均との差ストローク、フィールドの強さ、パータイプ別の内訳）：https://birdieapi.com/glossary
• 料金：https://birdieapi.com/pricing
• ベッターとモデラー向け：https://birdieapi.com/for/bettors
• 比較：Data Golf API、ESPNのゴルフJSON、SportsDataIO、Sportradar

クレジット表記

評価は当社独自のものです。PGA Tour、LPGA、LIV Golf、DP World Tour、Korn Ferry Tourとは提携していません。

ライセンス

このリポジトリの内容はMITライセンスです。データの利用条件は上記のとおりです。

Codex で使う

このリポジトリを Codex プラグインマーケットプレイスとして追加し、プラグインをインストールします。

codex plugin marketplace add noahowsh/birdieapi-mcp

次に、Codex でプラグインディレクトリを開き、birdieapi マーケットプレイスから birdieapi-skills をインストールします。このプラグインには、skills/ のスキルと BirdieAPI MCP サーバー（https://mcp.birdieapi.com/mcp）が含まれています。まずキーを設定してください（https://birdieapi.com/signup で無料登録できます）。

export BIRDIEAPI_API_KEY=your_key

Codex はベアラートークンとして送信します。

Gemini CLI で使う

export BIRDIEAPI_API_KEY=your_key
gemini extensions install https://github.com/noahowsh/birdieapi-mcp

この拡張機能は BirdieAPI MCP サーバー（https://mcp.birdieapi.com/mcp）を追加し、`x-api-key` ヘッダーにキーを含めて送信します。無料キー（月 500 クレジット）は https://birdieapi.com/signup で取得できます。