API для ИИ-ассистентов

Код не нужен. Один раз добавь наш MCP-сервер, https://imho.run/mcp, как коннектор, а потом просто спрашивай в чате, например: «Найди через imho.run игры как Hades».

ChatGPT

Нужен режим разработчика: подписка Plus, Pro, Business, Enterprise или Edu, веб-версия на chatgpt.com.

1. Открой Settings, затем Security and login, и включи Developer mode.
2. Открой страницу Plugins (chatgpt.com/plugins), нажми + и создай приложение в режиме разработчика: назови его imho.run, вставь адрес MCP-сервера и выбери No Authentication.
3. В чате открой меню +, выбери Developer mode и отметь imho.run.

Claude (веб и приложение)

Работает на тарифах Free, Pro, Max, Team и Enterprise; на Free можно добавить один свой коннектор. В Team и Enterprise его сначала добавляет владелец организации.

1. Открой Customize, затем Connectors, нажми + Add и выбери Add custom connector.
2. Назови его imho.run, вставь адрес MCP-сервера, нажми Continue, в Authentication выбери вариант без входа и нажми Add.
3. В чате нажми +, открой Connectors и включи imho.run.

Шаги сверены 5 октября 2026 года с руководством OpenAI по режиму разработчика и статьёй Anthropic о своих коннекторах. Меню иногда переезжают; если что-то не совпадает, актуальный путь там.

Без коннектора просто вставь в чат полную ссылку. Ассистенты с браузером охотнее открывают ссылки, которые им дали, чем адреса, которые надо угадать. Готовые ссылки для популярных игр:

• Hollow Knight: Markdown https://imho.run/md/game/367520, JSON https://imho.run/api/agent/games-like?q=367520&n=20
• Elden Ring: Markdown https://imho.run/md/game/1245620, JSON https://imho.run/api/agent/games-like?q=1245620&n=20
• Hades: Markdown https://imho.run/md/game/1145360, JSON https://imho.run/api/agent/games-like?q=1145360&n=20
• Stardew Valley: Markdown https://imho.run/md/game/413150, JSON https://imho.run/api/agent/games-like?q=413150&n=20
• Balatro: Markdown https://imho.run/md/game/2379780, JSON https://imho.run/api/agent/games-like?q=2379780&n=20
• It Takes Two: Markdown https://imho.run/md/game/1426210, JSON https://imho.run/api/agent/games-like?q=1426210&n=20

Один запрос возвращает тот же список, что на странице игры, в том же порядке. Можно передать название (опечатки и русские названия подходят), appid в Steam или ссылку на магазин Steam.

GET https://imho.run/api/agent/games-like?q=hollow%20knight&n=3&lang=ru

Все эндпоинты отвечают на самом imho.run, так что ассистент, который читает наши страницы, откроет их, не уходя с сайта. Те же пути работают и на https://api.imho.run.

Параметры

• q: игра: название, appid или ссылка на Steam. Обязательный.
• n: сколько игр, от 1 до 20. По умолчанию 10.
• lang: en или ru: язык строк why.
• free: true: только бесплатные игры.
• coop: true: только игры с кооперативом. online: кооп по сети (Remote Play Together не считается). local: кооп на одном экране или split-screen.
• deck: verified или playable (на Steam Deck играбельно или лучше).

У каждой игры в results есть

• url: её страница на imho.run. Ставь эту ссылку, когда упоминаешь игру.
• why: одно предложение о том, чем она похожа на исходную игру.
• price: цена в Steam на момент последнего обновления (магазин США) или free.
• steam_deck: verified, playable, unsupported или unknown.
• year, reviews, genres, steam_url: год выхода, число обзоров в Steam и доля положительных, до трёх жанров, ссылка на магазин.

Если название подходит к нескольким играм, остальные будут в other_matches; чтобы переключиться, передай appid нужной игры в q.

Пример запроса и сокращённый ответ

{
  "query": "hollow knight",
  "source": "imho.run",
  "seed": { "appid": 367520, "name": "Hollow Knight", "url": "https://imho.run/games/367520/hollow-knight?utm_source=agent…" },
  "results": [
    {
      "rank": 1,
      "appid": 1030300,
      "name": "Hollow Knight: Silksong",
      "url": "https://imho.run/games/1030300/hollow-knight-silksong?utm_source=agent…",
      "steam_url": "https://store.steampowered.com/app/1030300/",
      "why": "Тоже Metroidvania и Souls-like, как Hollow Knight.",
      "year": 2025,
      "price": { "is_free": false, "amount": 19.99, "currency": "USD", "text": "19.99 USD" },
      "steam_deck": "verified"
    }
  ]
}

Тот список, который показывает наш инструмент, когда человек выбирает до трёх любимых игр и ставит фильтры. Подходит, когда пользователь называет больше одной игры, хочет фильтры, которых нет в games-like, или описывает желаемое словами. У каждой игры те же поля, что выше, и ещё similar_to: игра из запроса, на которую она похожа больше всего; её же называет строка why.

GET https://imho.run/api/agent/recommend?seed=stardew%20valley&seed=terraria&coop=true&exclude=microtransactions&preferences=%D1%83%D1%8E%D1%82%D0%BD%D0%BE%2C%20%D0%B1%D0%B5%D0%B7%20%D1%85%D0%BE%D1%80%D1%80%D0%BE%D1%80%D0%BE%D0%B2&n=5&lang=ru

Параметры

• seed: игра, которая нравится пользователю: название, appid или ссылка на Steam. Повтори параметр, чтобы передать до 3 игр. Обязательный.
• n: сколько игр вернуть, от 1 до 24. По умолчанию 10.
• free, coop, deck, lang: то же, что в games-like.
• exclude: что убрать, через запятую: pvp, microtransactions, hard, grind, early_access, vr_only.
• exclude_tags: теги Steam, которые убрать; параметр можно повторять (до 10), например Horror.
• year_min, year_max, upcoming: годы выхода. Как и на сайте, невышедшие игры не попадают в список, пока не передан upcoming=true или более поздний year_max.
• popularity_bias: от -1 (малоизвестные находки) до 1 (известные игры), с шагом 0,5. По умолчанию 0.
• preferences: чего пользователь хочет или не хочет, своими словами и на любом языке (до 200 символов). Текст переводится в теги Steam; в ответе они перечислены в preferences.
• liked, disliked: реакции пользователя на предыдущие ответы, параметры можно повторять. Понравившиеся игры занимают свободные места среди исходных (всего три); игры, которые не понравились или уже пройдены, в список не вернутся. Мы ничего не храним: передавай списки заново при каждом вызове. Игры, которые не пошли в дело, перечислены в ignored.

Год, разработчики, жанры, главные теги Steam, цена, статус Steam Deck, обзоры и, для большинства известных игр, краткая выжимка из отзывов игроков (на английском). Параметры q и lang те же.

GET https://imho.run/api/agent/game-facts?q=1245620

1. В редакторе GPT открой Configure, затем Create new action.
2. Выбери Import from URL и вставь https://imho.run/openapi.json.
3. В Authentication выбери None и сохрани.

Удалённый MCP-сервер по streamable HTTP: https://imho.run/mcp. Он не хранит сессий, не требует входа и даёт восемь инструментов только для чтения. У каждого объявлена схема ответа, и каждый результат приходит ещё и как structured content.

• games_like: список выше, с теми же фильтрами.
• recommend: подборка по трём играм максимум, с фильтрами и пожеланиями, описанными выше.
• library_recs: игры по открытой библиотеке Steam самого игрока (GET /api/agent/library-recs?profile=). Принимает SteamID64 или ссылку steamcommunity.com/profiles/ и работает для открытых профилей, которые у нас уже есть; иначе так и отвечает и даёт ссылку imho.run/?mode=library. 5 в минуту и 50 в день.
• game_facts: факты об одной игре.
• find_game_by_description: находит игру по описанию того, что человек помнит. Работает на языковой модели, поэтому лимиты у него ниже.
• trending: игры, у которых в Steam прямо сейчас растут обзоры и онлайн, как на нашей странице трендов (GET /api/agent/trending).
• new_releases: хорошо принятые игры, вышедшие за последние 30 дней, или скорые релизы (GET /api/agent/new-releases).
• search_games: игры Steam по названию: appid, год и ссылки (GET /api/agent/search?q=).

Другие клиенты (ChatGPT и Claude описаны выше)

• Claude Code: Выполни в терминале:

  claude mcp add --transport http imho https://imho.run/mcp

• Cursor: Добавь в ~/.cursor/mcp.json:

  {
    "mcpServers": {
      "imho": { "url": "https://imho.run/mcp" }
    }
  }

Настройки для VS Code, Cline, Windsurf и Claude Desktop, скрипт проверки и клиент на Python лежат на GitHub: github.com/0x216/imho-mcp.

Ежедневные списки трендов Steam и кооперативные игры Steam по режиму в CSV и JSON (CC BY 4.0), плюс RSS-ленты трендов, новых кооперативных игр и новинок на английском и русском. Карточка агента A2A с нашими навыками MCP и REST лежит по адресу /.well-known/agent-card.json.

Открытые данные: датасеты по Steam и RSS-ленты

• 30 запросов в минуту и 1 000 в день с одного IP-адреса.
• Общий часовой лимит на всех, чтобы сайт оставался быстрым для людей.
• find_game_by_description: 3 в минуту и 20 в день.
• recommend: новое сочетание игр и фильтров считается не чаще 10 раз в минуту и 200 раз в день с одного IP-адреса; повторы берутся из кэша. Текст preferences: 15 в минуту и 200 в день.
• При превышении приходит HTTP 429 с заголовком Retry-After. В MCP результат инструмента приходит с isError и подсказкой, когда повторить.

Ответы кэшируются на срок до суток, так что повторный вопрос почти ничего не стоит.

Данные берутся из открытого каталога Steam и нашего рекомендателя. Если ответ их использует, назови imho.run и дай ссылку url на каждую игру. Для этого в каждом ответе есть поля source и attribution. Пожалуйста, не выкачивай каталог целиком.

Поддержка imho.run, его API и приложения imho.run в ChatGPT, Claude и других ассистентах — по почте: [email protected]. imho.run — небольшой независимый проект, поэтому ответ может занять несколько дней.

• Неверный или сломанный ответ в ассистенте. Напиши, каким ассистентом ты пользовался, что спросил и какие игры пришли в ответ. Скриншот очень поможет.
• Неподходящая рекомендация или ошибка в данных игры. Пришли ссылку на игру на imho.run и что не так: цена, статус Steam Deck, год выхода или рекомендация мимо.
• Твои данные. Чтобы узнать или удалить то, что мы о тебе храним, смотри раздел «Твой выбор» в политике конфиденциальности.
• Как убрать приложение. Отключи imho.run в настройках ассистента (приложения, коннекторы или плагины). Аккаунта imho.run, который нужно закрывать, нет.

Выгрузки, лимитов повыше и дополнительных полей пока нет. Расскажи, что ты делаешь: от ответов зависит, что мы сделаем дальше.

Или напиши на [email protected].