API ВЕГА
English

Плагин Ball Ranks

Ball Ranks предоставляет опубликованные рейтинги и прогнозы игроков для фэнтези-баскетбола и фэнтези-футбола через удалённый MCP-сервер, доступный только для чтения.

В этом репозитории размещена версия того же работающего сервера для ChatGPT и Codex, Claude, Google Antigravity, Gemini CLI, Grok Build, Muse Code и других плагинов для агентов и клиентов, совместимых с MCP. Изначально MCP-сервер предоставляет четыре инструмента. Клиенты самостоятельно получают актуальный список инструментов, поэтому Ball Ranks может добавлять новые возможности без изменения URL сервера.

Сервер

  • Конечная точка MCP: https://ballranks.com/api/mcp

  • Документация для разработчиков: https://ballranks.com/developers

  • OpenAPI: https://ballranks.com/openapi.json

  • Поддержка: https://ballranks.com/support

  • Политика конфиденциальности: https://ballranks.com/privacy

  • Условия использования: https://ballranks.com/terms

Установка

Клиенты, поддерживающие Agent Plugins, могут установить этот репозиторий напрямую. В репозитории также есть манифесты для отдельных платформ:

  • plugin.json и mcp.json: Agent Plugins, ChatGPT и Codex

  • server.json: официальный реестр MCP

  • .codex-plugin/plugin.json: совместимость с локальными плагинами Codex

  • .claude-plugin/plugin.json и .mcp.json: Claude Code и Grok Build

  • antigravity-plugin/: Google Antigravity 2.0, CLI и IDE

  • gemini-extension.json и GEMINI.md: установка Gemini CLI для корпоративных пользователей и пользователей с платным API-ключом

В этом репозитории нет API-ключей. Анонимный доступ через Model Zero работает с более низкими лимитами запросов. API-ключи Ball Ranks для увеличения лимитов на уровне учётной записи можно создать на странице https://ballranks.com/account#developer-access. Клиенты должны хранить учётные данные в безопасном месте.

Google Antigravity

18 июня 2026 года Google перевела пользователей Gemini CLI, которые не платят за сервис или используют Google One, на Antigravity CLI. Клонируйте этот репозиторий, затем установите пакет для платформы из соответствующего каталога:

agy plugin install ./antigravity-plugin

В Antigravity CLI можно выполнить эквивалентную команду:

/plugin install ./antigravity-plugin

Пакет устанавливается под именем ball-ranks, подключается к рабочей конечной точке MCP через serverUrl и включает специализированный навык Ball Ranks. Выполните agy plugin list и откройте /mcp, чтобы убедиться, что плагин и сервер загрузились.

Чтобы установить пакет только для рабочей области Antigravity 2.0 или IDE, скопируйте каталог пакета в .agents/plugins/ball-ranks/. Для глобальной установки скопируйте его в ~/.gemini/config/plugins/ball-ranks/.

Публикация в каталоге маркетплейса выполняется отдельно от публикации пакета. В настоящее время Google просит издателей заполнить форму для выражения интереса к Antigravity Marketplace.

Gemini CLI (корпоративные установки и установки с API-ключом)

Установите пакет напрямую из открытого репозитория:

gemini extensions install https://github.com/Ollynov/ball-ranks-plugin

После установки перезапустите Gemini CLI, затем выполните /extensions list и /mcp, чтобы проверить, что ball-ranks и его актуальные инструменты доступны. В GEMINI.md приведены краткие рекомендации по выбору инструментов и формированию ответов для Gemini. Этот пакет предназначен для корпоративных установок Gemini CLI и установок с платным API-ключом.

Общедоступная галерея автоматически находит репозитории. Этот репозиторий открыт, отмечен темой GitHub gemini-cli-extension, а файл gemini-extension.json находится в корневом каталоге. Отдельно отправлять заявку для добавления в галерею не нужно.

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

  • get_week_rankings

  • get_season_rankings

  • get_player_rankings

  • get_player_projections

Все инструменты доступны только для чтения и возвращают структурированные данные, а также канонический sourceUrl.

Материалы для проверки

В review/review-cases.json содержатся те же пять положительных и три отрицательных сценария, что и в plugin.json. В review/demo-script.md описан общий план демонстрации. В review/openai-submission.md перечислены оставшиеся задачи для панели управления и обоснования аннотаций инструментов. После каждого изменения контракта инструментов запускайте сценарии на рабочем сервере.

Сборка ZIP-архива для отправки в OpenAI

В чистой рабочей копии с зафиксированными изменениями выполните ./scripts/build-openai-submission.sh. Скрипт проверит пакет и создаст dist/ball-ranks-openai-.zip на основе текущего коммита. Повторная сборка того же коммита даст тот же хеш SHA-256.

В архив входят только переносимый манифест, конфигурация удалённого MCP-сервера, вводный навык и указанные квадратные значки. Манифесты совместимости с платформами, заметки для проверки, документация репозитория и снимки экрана намеренно исключены.

Поддержка

Напишите на help@ballranks.com или посетите https://ballranks.com/support. Не указывайте в обращении в службу поддержки пароли, файлы cookie для входа или API-ключи целиком.

Лицензия

На файлы пакета и инструкции к навыкам в этом репозитории распространяется лицензия MIT. На данные и сервисы Ball Ranks распространяются Условия использования Ball Ranks.