インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、API-Football をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
API-Football で AI にサッカーを追わせます。ライブスコアと試合イベント、日程、順位表、チームと選手の統計、スタメン、負傷者、移籍、対戦成績、試合予想、ブックメーカーのオッズを、世界中のリーグとカップ戦について取得できます。API-Sports アカウントの API キーを使います。
こう聞いてみよう
API-Football のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → API-Football をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
API-Football
API-Football で AI にサッカーを追わせます。ライブスコアと試合イベント、日程、順位表、チームと選手の統計、スタメン、負傷者、移籍、対戦成績、試合予想、ブックメーカーのオッズを、世界中のリーグとカップ戦について取得できます。API-Sports アカウントの API キーを使います。
セットアップ
- dashboard.api-football.com で無料アカウントを作成します。サインインするとダッシュボードに API キーが表示されます。試すだけなら無料プランで十分です。
- キーを
API_FOOTBALL_KEYに貼り付けて、コネクターをインストールします。キーはx-apisports-keyヘッダーとして API-Sports に送られます。API-Sports のダッシュボードのキーを使ってください。API マーケットプレイス経由で購入したキーは別のヘッダーを使うため、ここでは動きません。 - 最初に
af_statusを実行します。プラン、1 日のリクエスト上限、これまでの使用数が表示され、このツール自体はクォータを消費しません。 - 分析をするときは、まず
af_analysis_playbookから始めてください。API を呼び出さずに、依頼の種類ごとに使うツールの順番を返します。対象は試合のプレビューや予想、試合後のレポート、チームの調子、順位表、トッププレーヤー、選手のスカウティング、スカッド、負傷者、移籍、オッズ、ライブの試合です。
まず名前を ID に変換: ほぼすべてのツールが数値 ID を必要とし、AI が ID を推測してはいけません。大会は af_leagues の search フィルターで探します（例: ブンデスリーガは ID 78、ワールドカップは ID 1）。利用できるシーズンも一緒に表示されます。チームは af_teams で探します。チーム ID を指定し next を 1 にして af_fixtures を呼ぶと、次の試合とその fixture ID が返ります。af_predictions、af_fixture_lineups、af_fixture_events、af_fixture_statistics、af_fixture_players はこの ID を使います。選手はチームとシーズンを指定して af_players で、名前で探すなら af_player_profiles で取得します。
シーズンと時刻: season はシーズンが始まる年の 4 桁です。2025 は 2025/26 シーズン、2026 年のワールドカップは 2026 です。日付は YYYY-MM-DD 形式です。AI が af_timezone の値を timezone に渡さない限り、時刻は UTC です。
1 日のクォータ: データ系ツールの呼び出しは 1 回ごとに API-Sports への 1 リクエストになり、プランの 1 日のクォータを消費します。コネクターの説明は 1 日 100 リクエストの無料プランを前提にしています。有料プランではもっと多く使えます。af_status と af_analysis_playbook はクォータを消費しません。完全な試合プレビュー（予想、オッズ、スタメン、両チームの統計と負傷者、得点ランキング、選手の統計、対戦成績）には 12 回前後の呼び出しが必要です。af_players のようにページ分けされる結果は 1 ページごとに 1 リクエストかかるため、リーグ、シーズン、チーム、日付で絞り込むと大きく節約できます。
予想とオッズはデータであり、賭けの助言ではありません: af_predictions は 1 試合について、API-Football 独自の勝ち・引き分け・負けの確率、アドバイス、調子の比較を返します。af_odds_prematch と af_odds_live はブックメーカーのオッズを返し、AI はそれを暗示確率に換算して予想と比べられます。どちらも結果を保証するものではありません。小規模な試合やまだ先の試合ではオッズがないことがあります。af_odds_mapping はオッズのある試合を、af_odds_bookmakers、af_odds_bets、af_odds_live_bets はブックメーカーと賭けの種類を一覧にします。
データの範囲: スタメンは通常、キックオフの約 1 時間前に確定します。af_injuries では、Missing Fixture は欠場、Questionable は出場が不確かという意味です。審判用のツールはありません。審判は試合データにだけ載り、決まるのが遅いこともあります。対戦成績はクラブについては充実していますが、代表チームについてはほとんどありません。
読み取り専用: 40 個のツールはすべてデータを読み取るだけで、API-Sports アカウントの内容は何も変更しません。インストール時にオフになっているツールもありません。
よくあるエラー: API-Football は HTTP 200 を返しても失敗していることがあります。その場合、理由は errors フィールドにあり、response は空です。token の項目は、キーが間違っているか未設定であることを示します。API_FOOTBALL_KEY を確認してください。plan の項目は、そのシーズンや機能がプランに含まれていないことを示します。API-Sports のダッシュボードでプランを上げるか、プランの対象になっているシーズンで聞き直してください。1 日のクォータを使い切ると、リセットされるまで呼び出しは失敗します。残りは af_status で確認できます。errors がなく response が空なら、条件に合うデータがありません。たとえばオッズがまだ公開されていない、シーズンがまだ始まっていない、といった場合です。
このコネクターは賭けを行わず、API-Sports のほかの競技には対応せず、ライブ通知も送りません。ライブスコアは AI が問い合わせたときに取得します。また、football-data.org 独自のトークンを使う football-data.org コネクター とは別のものです。
前提条件: API_FOOTBALL_KEY
ローカルでコネクタをインストール
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
http://localhost:3000/connectors/store を開き、 API-Football を選択し、前提条件に記載された環境変数を入力します。
利用可能なツール
| Tool | What it does |
|---|---|
af_analysis_playbook | START HERE for football analysis (optional but recommended): returns, with NO API call, the exact ordered list of af_* tools to run for a… |
af_status | Account status: subscription plan, daily request limit and current usage |
af_timezone | List of all valid timezone strings accepted by the timezone parameter of other endpoints |
af_countries | List available countries (name, code, flag) |
af_leagues | Find LEAGUES & cups + their available seasons and numeric id (needed by standings/fixtures/topscorers/etc) |
af_leagues_seasons | List of all season years available across the API (e.g. 2010..2024) |
af_teams | Find TEAMS + their numeric id (needed by almost every other tool) |
af_team_statistics | A team's season STATISTICS in a competition: form, played, W-D-L, goals for/against (+ averages, home/away split), clean sheets, streaks… |
af_team_seasons | List of season years for which a given team has data |
af_team_countries | List of countries available for the teams endpoint |
af_venues | Search stadiums/venues (name, address, city, capacity, surface) |
af_standings | League TABLE / STANDINGS for a season: rank, points, W-D-L, goal difference, form. league=<id>, season=<year> |
af_fixtures | Football MATCHES & scores |
af_fixtures_rounds | List of round names for a league+season (e.g. 'Regular Season - 1') |
af_head_to_head | HEAD-TO-HEAD history between two teams (h2h='idA-idB'): past meetings with scores, competitions and venues |
af_fixture_statistics | Team match STATISTICS for a fixture: shots, shots on target, possession %, corners, fouls, offsides, passes & accuracy |
af_fixture_events | Match TIMELINE for a fixture: goals (with assist), cards, substitutions and VAR, each with minute & player |
af_fixture_lineups | Starting XI, bench, FORMATION and coach for a fixture |
af_fixture_players | Per-player match stats & RATINGS for a fixture (goals, shots, passes, duels, rating) |
af_injuries | INJURIES & suspensions, who is OUT or doubtful |
af_predictions | THE match-prediction endpoint for one fixture id (win/draw/loss %, advice, predicted winner, and a form/attack/defence comparison of the… |
af_coachs | Search coaches and their career |
af_players | PLAYER statistics for a season: goals, assists, rating, minutes, shots, passes, dribbles, duels, cards |
af_player_seasons | Season years available for a player (or all seasons if no player given) |
af_player_squads | Current squad of a team, or the teams a player belongs to |
af_player_teams | List of teams a player has played for |
af_player_profiles | Player personal data (name, age, nationality, height...) |
af_topscorers | TOP SCORERS / golden boot of a competition: goals, penalties, appearances, minutes-per-goal |
af_topassists | Top 20 assist providers of a league+season |
af_topyellowcards | Top 20 players by yellow cards in a league+season |
af_topredcards | Top 20 players by red cards in a league+season |
af_transfers | Transfer history |
af_trophies | Trophies won |
af_sidelined | Past absences (injuries/suspensions) for players/coaches |
af_odds_prematch | Pre-match betting ODDS for a fixture across bookmakers & markets (fixture=<id>; optional bookmaker=/bet=) |
af_odds_live | In-play (live) odds updated in real time |
af_odds_live_bets | Catalogue of available in-play bet (market) types for live odds |
af_odds_mapping | Mapping of fixtures that have pre-match odds available |
af_odds_bookmakers | List of available bookmakers (id + name) for the odds endpoints |
af_odds_bets | List of available pre-match bet (market) types (id + name) |
プロンプトの例
- 「アルゼンチンの次の試合を詳しくプレビューして。勝敗の確率、ブックメーカーのオッズ、予想スタメン、負傷者、両チームの最近の調子を教えて。」
- 「ブンデスリーガの現在の順位表と、今シーズンの得点ランキング上位 10 人を見せて。」
- 「今ライブ中のセリエ A の試合はどれ？スコアとここまでの得点者も教えて。」
- 「レアル・マドリードで今けがや出場停止で欠場しているのは誰？前回の移籍市場でクラブが獲得した選手も教えて。」
次のステップ
このガイドは役に立ちましたか?
