BuyWhere/buywhere-mcp

Сравнивает несколько товаров бок о бок. Возвращает цену, бренд, рейтинг и категорию для каждого.

ОБЯЗАТЕЛЬНЫЙ deliver_to. Сравнивает несколько товаров бок о бок. Всегда передавайте deliver_to="SG" (или страну вашего покупателя). Возвращает цену, бренд, рейтинг, категорию и итоговый outbound_url для каждого товара для рынка покупателя.

Используйте это всякий раз, когда пользователь спрашивает о ценах, хочет найти самый дешёвый вариант или задаёт вопрос «какая лучшая цена на X» или «где купить X по самой низкой цене». Возвращает сущности schema.org/Product с schema.org/AggregateOffer (lowPrice, offerCount, priceCurrency) по всем продавцам. Деградированный контракт BUY-74597: когда запрос кандидатов не успевает выполниться за пользовательский таймаут, этот инструмент возвращает конверт с кодом 200 OK с meta.degraded=true, meta.status="degraded", meta.emptiness_reason="api_error", с meta.degraded_kind="timeout" (или "partial_timeout" / "auth_failure"), meta.confidence="low" и meta.diagnostic.timed_out_stage="catalog_search", при этом best_price=null и alternatives=[]. Он никогда не возвращает пустой результат без пояснений, когда причина в таймауте, ошибке аутентификации, исключении на вышестоящем сервисе или срабатывании circuit breaker.

ОБЯЗАТЕЛЬНО deliver_to. Используйте этот инструмент всякий раз, когда пользователь спрашивает о ценах, хочет найти самый дешевый вариант или спрашивает «какая лучшая цена на X» или «где купить X по самой низкой цене». Всегда передавайте deliver_to="SG" (или страну вашего покупателя). Возвращает сущности schema.org/Product с schema.org/AggregateOffer (lowPrice, offerCount, priceCurrency) по всем продавцам. Ответ содержит shopping_job_id (UUID), который можно использовать для возобновления сессии сравнения цен по нескольким продавцам для покупателя.

Находит товары, похожие на заданный товар, с помощью векторной близости. Возвращает до 10 ближайших соседей по смыслу (эмбеддинг названия и описания). Полезен для рекомендаций «похожие товары».

Получает товары со скидкой, отсортированные по проценту скидки. Возвращает сущности schema.org/Product со свойствами schema.org/Offer: price, priceCurrency, availability, originalPrice и discountPercentage. Охватывает электронную коммерцию Сингапура, Малайзии, Индонезии, Таиланда, Вьетнама и США. Поддерживает фильтры по валюте, региону (sea, us, eu, au) и стране (SG, US, VN, MY, ...). Деградированный контракт BUY-74597: когда сканирование индекса скидок не может завершиться в пределах пользовательского таймаута, этот инструмент возвращает обёртку 200-OK с meta.status="degraded", meta.emptiness_reason="api_error", meta.degraded_kind="timeout" (или "partial_timeout" / "auth_failure"), meta.confidence="low" и meta.diagnostic.timed_out_stage (обычно offer_aggregation). Он никогда не возвращает пустой результат без пояснений, когда причиной является таймаут, сбой аутентификации, исключение вышестоящего сервиса или срабатывание предохранителя. Ветвитесь по meta.degraded === true или meta.status === "degraded".

ОБЯЗАТЕЛЬНЫЙ deliver_to. Получает товары со скидкой, отсортированные по проценту скидки. Всегда передавайте deliver_to="SG" (или страну вашего покупателя). Возвращает сущности schema.org/Product со свойствами schema.org/Offer: price, priceCurrency, availability, originalPrice и discountPercentage. Охватывает электронную коммерцию Сингапура, Малайзии, Индонезии, Таиланда, Вьетнама и США. Поддерживает фильтры по валюте, региону (sea, us, eu, au) и стране (SG, US, VN, MY, ...).

Получает конкретный продукт по его ID, включая все подробности и текущую цену.

ОБЯЗАТЕЛЬНО deliver_to. Получает конкретный продукт по его ID, включая полные сведения и текущую цену. Всегда передавайте deliver_to="SG" (или страну вашего покупателя). Ответ включает преобразованный outbound_url (https://…), который направляет покупателя через трекер кликов BuyWhere, когда у продукта есть предложения продавцов.

Загружает (создаёт или обновляет) пакет товаров в каталог BuyWhere. Добавляет или обновляет карточки товаров от любого продавца или источника. Требуется действующий API-ключ с правами на загрузку. Принимает до 1000 товаров за один вызов с указанием источника, SKU, названия, цены, URL и необязательных метаданных.

Получает список категорий верхнего уровня, доступных в каталоге BuyWhere.

Ищет в каталоге товаров BuyWhere по ключевому слову. Считает deliver_to ОБЯЗАТЕЛЬНЫМ для использования на стороне покупателя (страна конечного пользователя по ISO-3166); он имеет приоритет над country_code/country и предотвращает поиск по всем рынкам сразу. Возвращает записи о товарах с названием, описанием, изображением, ценой и информацией о продавце. Охватывает e-commerce платформы в Сингапуре, Малайзии, Индонезии, Таиланде, Вьетнаме и США. Использует compact=true для оптимизированных под агента ответов с полями structured_specs, comparison_attributes и normalized_price_usd. Деградированный контракт BUY-74597: когда запрос к каталогу не может завершиться в пределах пользовательского таймаута, этот инструмент возвращает конверт 200-OK с meta.status="degraded", meta.emptiness_reason="api_error" с meta.degraded_kind="timeout" (или "partial_timeout" / "auth_failure"), meta.confidence="low" и meta.diagnostic.timed_out_stage, указывающий на этап, на котором произошёл сбой (catalog_search / offer_aggregation / merchant_join). Он никогда не возвращает просто пустой результат, когда причина в таймауте, ошибке аутентификации, исключении вышестоящего сервиса или срабатывании circuit breaker. Агентам следует ветвить логику по meta.degraded === true (или meta.status === "degraded"), а не считать пустой data отсутствием совпадений.

ОБЯЗАТЕЛЬНЫЙ deliver_to. Ищет в каталоге товаров BuyWhere по ключевому слову. Параметр deliver_to обязателен (код страны ISO, например, "SG", "US"): он имеет приоритет над country_code/country и предотвращает поиск по всем рынкам. Всегда передавайте deliver_to="SG" (или страну вашего покупателя). Возвращает записи о товарах с названием, описанием, изображением, ценой и информацией о продавце. Охватывает платформы электронной коммерции в Сингапуре, Малайзии, Индонезии, Таиланде, Вьетнаме и США. Используйте compact=true для ответов, оптимизированных для агентов, с полями structured_specs, comparison_attributes и normalized_price_usd.