geizhals-mcp

MCP-сервер, который позволяет ИИ искать по данным сравнения цен Geizhals: товарам, лучшим ценам, истории цен, рейтингам и категориям. Он работает через API мобильного приложения Geizhals (api.geizhals.net/gh/v9) и возвращает ИИ важные поля.

Ключевые возможности

• Лучшая цена во всех магазинах
  Найдите товар и получите его лучшую цену, полный ценовой диапазон, звёздный рейтинг и количество тестовых обзоров, агрегированные по всем продавцам Geizhals, а не по одному объявлению.

• Знайте, когда покупать
  Возвращайте полную историю цен и актуальные акции (Schnäppchen) с сортировкой по максимальному проценту скидки, чтобы модель могла ответить: «дёшево ли это сейчас или стоит подождать».

• От ключевого слова к категории
  Ищите по свободному тексту или просматривайте полное дерево категорий Geizhals (более 2200 категорий, поставляемых вместе с сервером), чтобы попасть точно в нужный сегмент, а затем сравнивайте выбранный список товаров бок о бок.

Related MCP server: geizhals-mcp

Инструменты

search_geizhals(query, ...)

Поиск товаров по ключевым словам. Фильтры по стране (loc/hloc), категории и производителю, а также сортировка и постраничная разбивка. Возвращает результаты и агрегаты по фасетам (категории, производители, диапазон цен) для последующего уточнения.

get_product(product_id)

Полная информация о товаре: название, рейтинг, диапазон лучшей цены, изображения, ссылка на предложение и количество тестовых обзоров.

get_price_history(product_id, days=31)

Сводка по минимальной, максимальной и текущей цене, а также исходный ряд [timestamp, price, flag].

get_product_ratings(product_id)

Средний рейтинг, общие количество оценок, разбивка по звёздам и ссылка на обзоры.

browse_category(category, ...)

Список товаров в категории по её коду, с диапазоном цен и сортировкой.

compare_products(product_ids)

Сравнение нескольких товаров бок о бок.

get_deals(sort="percent", ...)

Текущие акции: товары, у которых только что упала лучшая цена, с процентом и суммой скидки. Сортировка по максимальному снижению percent, price, latest, popularity или top-предложениям, и фильтр min_discount_percent.

list_categories(query)

Просмотр дерева категорий Geizhals, чтобы найти коды категорий для browse_category. Полное дерево поставляется вместе с сервером в data/categories.json.

Установка

Требется Python 3.9+.

pip install -r requirements.txt

Запуск

python main.py

Сервер запускается по streameble HTTP и печатает адрес, на котором он слушает запросы:

Starting geizhals-mcp server on http://127.0.0.1:8000/mcp

Укажите вашему MCP-клиенту этот адрес. Хост, порт и путь указаны в начале main.py.

Использование с Claude Desktop

Claude Desktop запускает MCP-серверы через stdio, поэтому подключайте этот HTTP-сервер через mcp-remote (требуется Node.js):

1. Запустите сервер (python main.py) и оставьте его работать.

2. В Claude Desktop откройте Settings > Developer > Edit Config; откроется claude_desktop_config.json. Откройте его и добавьте запись geizhals:

   {
     "mcpServers": {
       "geizhals": {
         "command": "cmd",
         "args": ["/c", "npx", "-y", "mcp-remote", "http://127.0.0.1:8000/mcp"]
       }
     }
   }

   На macOS/Linux сбросьте Windows-обёртку: используйте "command": "npx" с "args": ["-y", "mcp-remote", "http://127.0.0.1:8000/mcp"].

3. Сохраните файл и перезапустите Claude Desktop.

Примечания

• data/categories.json — это снимок дерева категорий Geizhals (title, id, children). main.py загружает его для list_categories.

• coverage.json содержит количество позиций в каталоге, показанные на бейджах выше. scripts/update_coverage.py обновляет его с главной страницы Geizhals, а ежедневный GitHub Action коммитит любые изменения.

• Подробности об API описаны в search_api.md.

• Это внутренний мобильный API Geizhals, а не официальный API. Обращайтесь с ним вежливо.

Устранение проблем

403 invalid request_fingerprint in payload — HMAC-секрет или схема подписи в main.py (GH_HMAC_SECRET, request_signature, API_HOST) больше не соответствует тому, что отправляет живое приложение Geizhals. Это реверс-инжиниринг из приложения с жёстко заданными значениями, поэтому всё может разъехаться, как только Geizhals сменит секрет или изменит схему fingerprint.

Отказ от ответственности

Это независимый неофициальный проект, который не связан с Geizhals, не одобрен им и не может иметь к нему отношения. «Geizhals» и все связанные товарные знаки принадлежат их владельцам.

Этот проект опубликован только в образовательных и исследовательских целях. Он обращается к внутреннему API Geizhals, не предназначенному для публичного использования, который может сломаться или измениться в любой момент. Вы сами несёте ответственность за способ использования: соблюдайте Условия обслуживания Geizhals, правила для роботов и применимое законодательство и не перегружайте их серверы.

Лицензия

MIT LICENSE. Предоставляется «как есть», без каких-либо гарантий.