BirdieAPI

BirdieAPI MCP 服务

高尔夫数据 API。 PGA Tour 排行榜，包含最终名次、奖金和积分、每轮得分和逐洞记分卡；球场每洞的标准杆数和码数；球员和球场历史；我们自有的相对全场杆数评分；按标准杆 3/4/5 杆洞划分的得分数据，以及四大男子大满贯赛事各体育博彩平台的冠军赔率。LPGA、LIV、DP World Tour 和 Korn Ferry Tour 也使用相同的工具。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

skills/ 中的 16 个免费 Claude 技能可基于这些工具，将 Claude 打造成高尔夫分析师：查询赛事和球员、评估相对全场杆数、分析标准杆 3/4/5 杆洞及逐洞得分、评估球场适配度、模拟赛事、计算四大满贯赛事独赢投注市场的赔率数学，以及测试自有模型的方法（无数据泄漏的特征、滚动验证、校准、优势检测、回测）。

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

也可以将它们安装为 Claude Code 插件：

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

也可以使用 skills CLI：npx skills add noahowsh/birdieapi-mcp。

将 skills/ 文件夹提供给 Claude，并连接下方的 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"

每个工具都通过 POST /v1/{tool} 接收 JSON 请求体。

示例

examples/ 中提供可运行的 Python（仅使用标准库）和 Node 18+（无依赖项）示例：

• examples/python/quickstart.py 和 examples/node/quickstart.mjs：赛程加一项摘要查询。
• examples/python/golf_major_leaderboard_and_odds.py：一场大满贯赛事，赛前与赛后。

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	球员的赛季数据：得分、小鸟球、三杆洞／四杆洞／五杆洞得分、开球、上果岭和推杆
get_course_history	球员在某场赛事或某座球场历年的战绩
get_head_to_head	两名球员共同参加的每场赛事中的名次和轮次
get_leaders	我们计算或记录的任意数据项的赛季领先者
get_winner_odds	四大满贯赛首轮前各博彩公司开出的冠军赔率：初盘和最新赔率，以及隐含概率

联赛：golf（默认，PGA Tour）、lpga、liv、dpwt、kornferry（对任意工具传入 league；省略时默认为 PGA Tour）。

数据

• 自 2001 年以来的 PGA Tour 排行榜、轮次和逐洞得分
• LPGA、LIV、DP World Tour 和 Korn Ferry Tour 的数据也可通过相同工具获取（自 2007 年起提供逐洞数据）
• 球场每洞的标准杆和码数、每洞的比赛情况；球员的球场历史；交手记录
• 我们的相对全场杆数评级（根据全场实力调整），以及三杆洞／四杆洞／五杆洞得分细分（平均值，以及 PGA Tour 和 Korn Ferry Tour 按洞类型划分的相对全场杆数）；基于得分，不是逐杆的得分杆数
• 大满贯赛冠军赔率（get_winner_odds）：四大男子大满贯赛按博彩公司划分的独赢赔率，包括首轮前的初盘和最新赔率；涵盖 2021 年以来的所有大满贯赛，以及 2020 年美国公开赛（往届大满贯赛的最新赔率可能早于首发时间一周）；即将举行的大满贯赛赔率市场开放期间每日更新，赛事周每六小时更新一次
• 不提供单轮、对阵、前十名或其他赛事的赔率，也不提供其他巡回赛的赔率

按赛季查看覆盖范围，数据实时读取自数据库：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 的 golf 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 会将其作为 bearer token 发送。

与 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 标头中发送密钥。可在 https://birdieapi.com/signup 免费获取密钥（每月 500 个积分）。