AcesAPI

AcesAPI MCP 服务

网球数据 API。 ATP 和 WTA 单打比赛数据，包含每盘和抢七的比分、按轮次划分的赛事签表、球员档案、每周排名、交手记录、场地类型细分、我们自有的场地类型 Elo，以及大满贯和 Masters / WTA 1000 比赛的体育博彩独赢赔率。REST API 和 MCP 服务。每月免费提供 500 点数，无需银行卡。

网站：https://acesapi.com · 文档：https://acesapi.com/docs · 获取密钥：https://acesapi.com/signup

You:    "What is Carlos Alcaraz's record on clay against top-10 players?"
Claude: [calls get_surface_splits]

You:    "Who leads the Sinner and Alcaraz head to head, and how many of their meetings were finals?"
Claude: [calls get_head_to_head]

You:    "Which moneylines were posted for the 2025 US Open men's final?"
Claude: [calls get_matches, then get_match]

在本地运行（stdio）

大多数客户端可直接连接到 https://mcp.acesapi.com/mcp。对于会启动本地进程的客户端：

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

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

它会使用你的密钥转发到托管服务，因此所有工具和点数成本都相同。

Skills

此仓库还提供 16 个免费的 Claude skills，位于 skills/，可基于下方工具让 Claude 成为网球分析师：比赛和球员查询、场地类型 Elo、交手记录、排名历史、盘分建模、赔率计算、优势检测和回测。它们会调用 AcesAPI 工具，并严格依据数据内容（不含发球统计；独赢赔率仅涵盖大满贯、Masters 和 WTA 1000）。

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

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

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

或者使用 skills CLI：npx skills add noahowsh/acesapi-mcp。

将 skills/ 文件夹指向 Claude，添加 MCP 服务（参见快速开始），然后提出诸如“明天上海的比赛谁更被看好？为什么？”这样的问题。完整目录：skills/README.md。这些 skills 也可以处理你自己的 CSV 或 JSON，无需密钥。

实用页面

• 文档：包含参数和实时示例的所有端点
• 网球赔率：即将举行的 ATP 和 WTA 比赛，以及各家体育博彩机构的独赢赔率
• 数据图谱：提供的数据及覆盖不完整的部分
• 指南：介绍场地类型 Elo、交手记录、排名、盘分和场地类型细分的 Python 操作指南
• 数据：比赛结果、排名历史、赔率历史
• 定价：每次调用的点数，每月免费提供 500 点数
• 场地类型 Elo 说明
• 比较：API Tennis、ESPN 网球数据源、Sportradar、SportsDataIO

Python

官方 Python 客户端已发布到 PyPI：acesapi。

pip install acesapi
export ACESAPI_API_KEY=sk_live_...

from acesapi import Client

client = Client()

ranks = client.get_rankings(limit=5)
for row in ranks["rankings"]:
    print(row["rank"], row["name"], row["points"])

针对密钥无效、点数不足、未找到和速率限制提供类型化错误，支持自动重试，并提供适用于 pandas 的 to_dataframe。

快速开始

这是一个通过 Streamable HTTP 提供的托管（远程）MCP 服务，无需安装任何东西。

Claude Code

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

Claude Desktop、Cursor 和其他客户端

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

也可以通过 x-api-key 标头或 Authorization: Bearer 发送密钥。连接并列出工具无需密钥；调用工具则需要密钥。

REST

curl -X POST https://mcp.acesapi.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/tennis_head_to_head_surface_elo.py：并排比较两名球员。

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

详情请参阅 examples/README.md。前往 https://acesapi.com/signup 免费获取密钥（每月 500 个积分，无需信用卡）。

工具（13）

工具	返回内容
list_tournaments	某个赛季的赛事，包括日期、场地类型、状态和冠军
search_players	按姓名或国家/地区查找球员
get_tournament	某项赛事的签表和结果，按轮次列出每一盘
get_matches	按日期、赛事或赛季查询比赛结果，包括盘分和抢七比分
get_schedule	接下来几天即将开始和正在进行的比赛
get_match	一场比赛的详情：盘分、抢七得分、种子、评级和比分说明
get_rankings	自 2007 年以来的每周排名榜单，或某位球员的排名历史
get_ratings	我们的 Elo 评级，包含综合评级或按场地类型划分的评级
get_head_to_head	两名球员的交锋记录、按场地类型和决赛划分的胜场
get_surface_splits	某位球员按场地类型划分的战绩：盘数、局数、抢七和决胜盘
get_player_stats	根据比分统计的球员赛季数据，按轮次和对手排名划分
get_player	简介、排名、评级、职业生涯战绩、冠军头衔和近期比赛
get_player_matches	球员的比赛记录，含比分和评级；可按赛季、场地类型或对手筛选

联赛：tennis（默认，ATP）、wta（向任意工具传入 league: "wta"）。

数据

• 自 2007 年以来的 ATP 和 WTA 单打数据（自 2022 年起包含资格赛），含盘分和抢七比分
• 按轮次列出的赛事签表和结果；自 2007 年以来的每周排名
• 交锋记录、按场地类型划分的数据、根据比分计算的球员赛季统计，以及我们的综合和按场地类型划分的 Elo 评级
• 体育博彩独赢赔率，通过 get_match 的 odds 数组返回（没有单独的赔率工具）：2020 年年中以来的大满贯比赛，以及 2024 年 8 月以来的 ATP 大师赛和 WTA 1000 赛事；赛前数据，每小时刷新；其他赛事的数组为空
• 不提供发球统计数据（Ace、双误、破发点）

赛季覆盖范围可从数据库实时读取：https://acesapi.com/docs

定价

每月 500 个免费积分，无需信用卡。套餐：Starter 19 美元/月（10,000 个积分）、Pro 49 美元/月（30,000 个积分）、Scale 149 美元/月（125,000 个积分）。钱包充值最低 5 美元，积分永不过期。https://acesapi.com/pricing

署名

场地类型和评级由我们提供。与 ATP、WTA、ITF 或任何赛事均无关联。

许可证

本仓库内容采用 MIT 许可证。数据条款如上。

在 Codex 中使用

将此仓库添加为 Codex 插件市场，然后安装插件：

codex plugin marketplace add noahowsh/acesapi-mcp

然后在 Codex 中打开插件目录，从 acesapi 市场安装 acesapi-skills。此插件包含 skills/ 中的技能和 AcesAPI MCP 服务（https://mcp.acesapi.com/mcp）。请先设置密钥（可在 https://acesapi.com/signup 免费获取）：

export ACESAPI_API_KEY=your_key

Codex 会将其作为 bearer token 发送。

在 Gemini CLI 中使用

export ACESAPI_API_KEY=your_key
gemini extensions install https://github.com/noahowsh/acesapi-mcp

该扩展会添加 AcesAPI MCP 服务（https://mcp.acesapi.com/mcp），并在 x-api-key 标头中发送密钥。前往 https://acesapi.com/signup 免费获取密钥（每月 500 个积分）。