mcp-tennis-match-data

テニス試合データ MCP サーバー

Apify 上の Mamba Labs Tennis Match Data アクター向け MCP サーバーです。日付ごとの ATP と WTA の試合結果、スケジュール、ランキングを取得できます。

内容

• 機能
• クイックスタート
• 前提条件
• プロンプトの例
• ツール
• 入力
• 料金
• アクターの全ドキュメント
• ライセンス

機能

日付または日付範囲を指定してください。アクターは公開されている ESPN のテニススコアボードを読み取り、選手、シード、ラウンド、ステータス、各セットのスコアを含む試合ごとの行を返します。現在の ATP と WTA のランキングも取得できます。取得できなかったデータや概要行は無料です。

すべての処理は Apify 上で実行されます。このパッケージは、アクターの実行を開始して完了を待ち、データセットの行を返すだけのシンクライアントです。

クイックスタート

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 の試合結果を取得して。」
• 「2025年7月のヤニック・シナーの試合をすべて表示して。」
• 「WTA のトップ50ランキングを取得して。」

ツール

get_tennis_match_data。ツールは1つです。引数の例：

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

入力

アクターの購入者向け入力です。省略した入力には、アクター独自のデフォルト値が適用されます。

入力	型	必須	説明
mode	string	いいえ	matches は結果と日付ごとのスケジュールを取得します。rankings は現在の ATP と WTA のランキングを返します。
date_from	string	いいえ	YYYY-MM-DD 形式の最初の UTC 日付、または today、yesterday、tomorrow です。matches モードでは必須です。
date_to	string	いいえ	最後の UTC 日付です。空欄の場合は date from と同じ日付になります。1回の実行で取得できる期間は最大366日です。
tours	array	いいえ	atp、wta、または両方（デフォルト）です。混合ダブルスはいずれかに含まれます。
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	いいえ	1回の実行で取得する試合行の最大数です。デフォルトは500です。
top_n	number	いいえ	ランキングモードで、ツアーごとに取得する行数です。最大150です。デフォルトは100です。
max_charge_usd	string	いいえ	任意です。この金額を超える課金が発生する前に実行を停止します。サマリー行は常に返されます。

料金

Apify でイベントごとに課金され、料金はお客様の Apify アカウントに請求されます。価格は USD です。

イベント	無料プラン	Bronze	Silver	Gold
match-row、試合1件	$0.0018	$0.00171	$0.00162	$0.00153
ranking-row、ランキング対象選手1人	$0.001	$0.00095	$0.0009	$0.00085
empty-read、該当する試合がない日付とツアー1組（最初の2回は無料）	$0.002	$0.0019	$0.0018	$0.0017
apify-actor-start、実行開始1回あたり	$0.006	$0.006	$0.006	$0.006

サマリー行、拒否された読み取り、拒否された入力、および最初の2回の空の読み取りは無料です。実行にかかるプラットフォーム料金は Mamba Labs が負担します。プロキシ通信料を含む実行のプラットフォーム料金は、Mamba Labs が負担します。

アクターの完全なドキュメント

apify.com/mambalabs/tennis-match-data

ライセンス

MIT です。LICENSE を参照してください。