mcp-tennis-match-data

网球比赛数据 MCP 服务

用于 Apify 上 Mamba Labs 网球比赛数据 Actor 的 MCP 服务。按日期提供 ATP 和 WTA 的比赛结果、赛程和排名。

内容

• 功能介绍
• 快速开始
• 前提条件
• 提示词示例
• 工具
• 输入
• 定价
• 完整 Actor 文档
• 许可证

功能介绍

提供一个日期或日期范围。Actor 会读取 ESPN 网球记分牌中的公开数据，并为每场比赛返回一行，包含球员、种子、轮次、状态和各盘比分。它还可以返回当前的 ATP 和 WTA 排名。被拒绝的读取请求和摘要行均免费。

所有工作都在 Apify 上运行。此软件包是一个轻量客户端，用于启动 Actor 运行、等待运行完成，并返回数据集中的行。

快速开始

你需要 Node.js 18 或更高版本，以及一个带 API 令牌的 Apify 账户。

将以下内容添加到 Claude Desktop 配置文件（claude_desktop_config.json）、Cursor 或任何 MCP 客户端中：

{
  "mcpServers": {
    "mamba-tennis-match-data": {
      "command": "npx",
      "args": [
        "-y",
        "@mambalabsdev/mcp-tennis-match-data"
      ],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

重启客户端。随后会显示 get_tennis_match_data 工具。

前提条件

• Node.js 18 或更高版本。
• 从 console.apify.com/account/integrations 获取 Apify API 令牌，并将其设置为 APIFY_TOKEN。服务无需令牌即可列出其工具；调用工具时需要令牌。

提示词示例

• “获取昨天的 ATP 和 WTA 比赛结果。”
• “显示 Jannik Sinner 在 2025 年 7 月的所有比赛。”
• “获取 WTA 排名前 50 的排名。”

工具

get_tennis_match_data。只有这一个工具。参数示例：

{
  "date_from": "2025-07-13",
  "tours": [
    "atp"
  ],
  "draws": [
    "singles"
  ],
  "max_matches": 10
}

输入

该 Actor 面向买家的所有输入。省略的输入将使用 Actor 自身的默认值。

输入	类型	必填	描述
mode	string	否	matches（比赛）读取结果和赛程。rankings（排名）返回当前的 ATP 和 WTA 榜单。
date_from	string	否	起始 UTC 日期，格式为 YYYY-MM-DD，也可以是 today、yesterday 或 tomorrow。matches 模式下必填。
date_to	string	否	结束 UTC 日期。留空表示与起始日期相同。一次运行最多读取 366 天。
tours	array	否	atp、wta 或 both（默认值）。混双比赛会归入任一巡回赛。
draws	array	否	mens-singles、womens-singles、mens-doubles、womens-doubles、mixed-doubles，或快捷选项 singles 和 doubles。留空表示全部。
statuses	array	否	final、retired、walkover、in_progress、scheduled、other，或快捷选项 finished、live 和 upcoming。留空表示全部。
tournaments	array	否	保留名称中包含这些词语的赛事，例如 wimbledon。
players	array	否	保留参赛选手姓名中包含这些词语的比赛，例如 sinner。
include_qualifying	string	否	yes（默认值）或 no。
whole_tournament	string	否	no（默认值）仅保留所查询日期进行的比赛。yes 会返回在这些日期期间举行的每项赛事的所有比赛。
max_matches	number	否	一次运行中最多返回的比赛行数。默认值为 500。
top_n	number	否	排名模式：每个巡回赛的行数，最多 150 行。默认值为 100。
max_charge_usd	string	否	可选。若费用将超过此金额，运行会在产生该费用前停止。始终返回摘要行。

定价

在 Apify 上按事件付费，费用计入您的 Apify 账户。价格以 USD 计。

事件	免费计划	Bronze	Silver	Gold
match-row，一场比赛	$0.0018	$0.00171	$0.00162	$0.00153
ranking-row，一名排名选手	$0.001	$0.00095	$0.0009	$0.00085
empty-read，一个没有符合条件比赛的日期和巡回赛，前 2 次免费	$0.002	$0.0019	$0.0018	$0.0017
apify-actor-start，每次运行启动	$0.006	$0.006	$0.006	$0.006

摘要行、被拒绝的读取、被拒绝的输入以及前 2 次空读取均免费。Mamba Labs 承担运行的平台费用，包括 Apify 代理流量费用。

Actor 完整文档

apify.com/mambalabs/tennis-match-data

许可证

MIT。请参阅 LICENSE。