API-Football в MCP: управляйте API-Football из любого AI-агента

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → API-Football, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

API-Football

Дайте ИИ следить за футболом через API-Football: live-счёт и события матчей, календарь, турнирные таблицы, статистика команд и игроков, составы, травмы, трансферы, личные встречи, прогнозы на матчи и коэффициенты букмекеров по лигам и кубкам всего мира. С API-ключом из вашего аккаунта API-Sports.

Настройка

1. Создайте бесплатный аккаунт на dashboard.api-football.com. После входа панель покажет ваш API-ключ. Чтобы попробовать коннектор, бесплатного плана достаточно.
2. Вставьте ключ в API_FOOTBALL_KEY и установите коннектор. Ключ отправляется в API-Sports в заголовке x-apisports-key. Используйте ключ из панели API-Sports: ключ, купленный через маркетплейс API, работает с другим заголовком и здесь не подойдёт.
3. Сначала вызовите af_status. Он показывает ваш план, дневной лимит запросов и сколько уже израсходовано, а сам в квоту не засчитывается.
4. Любой анализ начинайте с af_analysis_playbook. Он не обращается к API и возвращает последовательность инструментов для нужного типа запроса: превью или прогноз матча, отчёт после матча, форма команды, таблица, лучшие игроки, скаутинг, состав, травмы, трансферы, коэффициенты или матчи в live.

Сначала названия превращаются в id: почти всем инструментам нужны числовые id, и ИИ никогда не должен их угадывать. Турнир он ищет через af_leagues с фильтром search (например, Бундеслига с id 78 или чемпионат мира с id 1), заодно получая список доступных сезонов, а команду через af_teams. af_fixtures с id команды и next, равным 1, возвращает следующий матч и его fixture id, который нужен af_predictions, af_fixture_lineups, af_fixture_events, af_fixture_statistics и af_fixture_players. Игроков дают af_players по команде и сезону или af_player_profiles для поиска по имени.

Сезоны и время: season это четырёхзначный год начала сезона: 2025 означает 2025/26, а чемпионат мира 2026 года это 2026. Даты в формате YYYY-MM-DD. Время указано в UTC, если ИИ не передаёт timezone со значением из af_timezone.

Дневная квота: каждый вызов инструмента с данными это один запрос к API-Sports, и он засчитывается в дневную квоту вашего плана. Инструкции коннектора рассчитаны на бесплатный план со 100 запросами в день; платные планы дают больше. af_status и af_analysis_playbook квоту не расходуют. Полное превью матча (прогноз, коэффициенты, составы, статистика и травмы обеих команд, бомбардиры, статистика игроков, личные встречи) занимает около дюжины вызовов, а постраничные результаты, как у af_players, стоят один запрос за страницу, поэтому точные фильтры (лига, сезон, команда, дата) заметно экономят квоту.

Прогнозы и коэффициенты это данные, а не советы для ставок: af_predictions возвращает для одного матча собственные вероятности победы, ничьей и поражения от API-Football, совет и сравнение формы. af_odds_prematch и af_odds_live возвращают коэффициенты букмекеров, которые ИИ может перевести в подразумеваемые вероятности и сравнить с прогнозом. Ни то ни другое не гарантирует результат. Для небольших или ещё далёких матчей коэффициентов может не быть; af_odds_mapping показывает матчи с коэффициентами, а af_odds_bookmakers, af_odds_bets и af_odds_live_bets перечисляют букмекеров и виды ставок.

Что покрывают данные: составы обычно подтверждаются примерно за час до начала матча. В af_injuries значение Missing Fixture означает, что игрок не сыграет, а Questionable, что его участие под вопросом. Отдельного инструмента для судей нет: судья указан только в данных матча и часто появляется поздно. Личные встречи хорошо покрыты для клубов и почти не покрыты для сборных.

Только чтение: все 40 инструментов только читают данные. В вашем аккаунте API-Sports ничего не меняется, и ни один инструмент не отключён при установке.

Частые ошибки: API-Football может ответить HTTP 200 и всё равно не выполнить запрос; тогда причина указана в поле errors, а response пустой. Запись token означает, что ключ неверный или отсутствует: проверьте API_FOOTBALL_KEY. Запись plan означает, что сезон или функция не входит в ваш план: повысьте план в панели API-Sports или спросите про сезон, который в него входит. Когда дневная квота исчерпана, вызовы не проходят до её сброса; af_status показывает, сколько осталось. Пустой response без ошибок означает, что под фильтры ничего не подошло, например коэффициенты ещё не опубликованы или сезон ещё не начался.

Коннектор не делает ставок, не охватывает другие виды спорта API-Sports и не присылает live-уведомления: live-счёт приходит, когда ИИ его запрашивает. Это также не коннектор для 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 и введите переменные, перечисленные в Предварительных требованиях.

Доступные инструменты

Примеры запросов

• «Сделай полное превью следующего матча Аргентины: вероятности победы, коэффициенты букмекеров, ожидаемые составы, травмы и текущая форма обеих команд.»
• «Покажи текущую таблицу Бундеслиги и 10 лучших бомбардиров этого сезона.»
• «Какие матчи Серии A идут прямо сейчас, какой счёт и кто уже забил?»
• «Кто сейчас пропускает матчи в «Реале» из-за травмы или дисквалификации и каких игроков клуб купил в последнее трансферное окно?»

Следующие шаги

• Подключить к Claude
• Подключить к ChatGPT