Как подключить idealo к Gemini через MCP

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

idealo + Gemini

Управляйте предложениями вашего магазина в сервисе сравнения цен idealo из AI-агента через Partner Web Service idealo: читайте предложение по SKU, а с вашего согласия создавайте или заменяйте предложения, меняйте цены, сроки доставки и названия или снимайте предложения. Для магазинов, размещённых на idealo.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

IDEALO_CLIENT_ID, IDEALO_CLIENT_SECRET, IDEALO_SHOP_ID

Шаг 1 — Получите учётные данные

Настройка занимает около 3 минут. Нужен магазин, размещённый на idealo (договор продавца с idealo), и доступ к idealo Business.

1. Войдите в idealo Business и откройте Shop settings → API clients (business.idealo.com/direct/shops/settings/api-clients).
2. Создайте API-клиент с доступом к Partner Web Service и скопируйте его client ID и client secret. Secret показывается только один раз; если его больше нет, создайте новый клиент.
3. Вставьте client ID (UUID) в IDEALO_CLIENT_ID, secret в IDEALO_CLIENT_SECRET, а числовой shop ID, который показывает idealo Business, в IDEALO_SHOP_ID. AnythingMCP обменивает данные клиента на токен доступа сроком на один час и сам его обновляет.
4. Установите коннектор и запустите idealo_get_offer с SKU предложения, которое точно опубликовано: вы увидите предложение в том виде, в каком его хранит idealo.

Что он читает: одно предложение за раз по SKU, в том виде, в каком его хранит idealo: название, цену и прежнюю цену, URL, EAN и артикулы производителя, бренд, стоимость доставки и оплаты, срок доставки, энергетические этикетки, состояние товара и остальные поля предложения. В Partner Web Service нет вызова для списка, поэтому ИИ спрашивает у вас SKU.

Только предложения, без заказов: Partner Web Service 2.0 это интерфейс, через который размещённые на idealo магазины ведут предложения по одному, вместо товарного фида или вместе с ним, для idealo.de, .at, .fr, .it, .es и .co.uk. Сервис оформления покупки (Direktkauf) и его API заказов idealo закрыл в 2023 году, поэтому заказы по-прежнему приходят через ваш собственный магазин.

Как записываются предложения: цены передаются строками ровно с двумя знаками после точки, например "177.99"; прежняя цена это цена до снижения. Новому предложению нужны как минимум SKU, название, цена, URL, одна стоимость доставки (например, "DHL": "4.90") и одна стоимость оплаты (например, "PAYPAL": "0.00"); EAN, артикулы производителя и бренд помогают idealo сопоставить товар. idealo_upsert_offer заменяет предложение целиком, поэтому каждое не переданное поле удаляется; idealo_update_offer меняет только переданные поля, но не может изменить стоимость доставки и оплаты, размер, цвет, пол, материал и динамические атрибуты товара, а поля-списки вроде EAN или изображений нужно передавать полностью. SKU может содержать только буквы, цифры, подчёркивания, точки и дефисы.

Спрашивает перед каждым изменением: при установке ни один инструмент записи не включён. Когда администратор включит какой-то из них, ИИ покажет предложение со старым и новым значением или назовёт SKU, которое собирается снять, и дождётся вашего согласия, прежде чем что-то попадёт на сайт.

Отключено при установке: idealo_upsert_offer, idealo_update_offer и idealo_delete_offer. У idealo нет тестовой среды: каждая запись сразу меняет ваши живые предложения в сравнении цен, а снятое предложение исчезает с idealo. Включайте только те, которыми ИИ может пользоваться. Удалить все предложения разом намеренно нельзя.

Ограничения: idealo ограничивает число вызовов; текущий лимит виден в заголовке X-RateLimit-Limit. После 429 ИИ ждёт, прежде чем повторить попытку, и меняет предложения по одному.

Частые ошибки: 401 означает, что client ID или secret неверны или токен отклонён: проверьте их в Shop settings → API clients. 403 означает, что у API-клиента нет права на Partner Web Service или shop ID не ваш. 404 означает, что такого предложения в этом магазине нет (неверный SKU или shop ID). 400 перечисляет fieldErrors с полем и причиной, например цену без двух знаков после точки.

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

Шаг 2 — Установите адаптер

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

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты idealo.

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

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

• «Как сейчас выглядит на idealo моё предложение с SKU KS-4711: цена, срок доставки и стоимость доставки?»
• «Снизь цену для SKU TV-55-OLED до 899,00 евро и покажи 999,00 евро как прежнюю цену.»
• «Измени срок доставки для SKU BOSCH-GSR18 на 1-3 рабочих дня.»
• «Создай на idealo новое предложение для SKU LAMP-200 с EAN 4006381333931: 49,90 евро, доставка DHL за 4,90 евро и PayPal без доплаты.»
• «Сними с idealo предложение с SKU KS-4711, товар закончился.»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

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

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT