API ВЕГА

BuyWhere MCP Server — поиск товаров и сравнение цен для AI-агентов

AI-агенты используют BuyWhere, чтобы в режиме реального времени искать товары, сравнивать цены и находить выгодные предложения у продавцов в Сингапуре и США.

Установка за 30 секунд

export BUYWHERE_API_KEY=bw_live_xxxx
npx -y @buywhere/mcp-server

Работает с Claude Desktop, Cursor, VS Code Copilot, Cline, Windsurf, OpenCode, Codex, Continue.dev и любым клиентом, совместимым с MCP.

AI-агенты: возможности пакета

  • Искать товары на рынках Сингапура, США, Малайзии, Таиланда и Вьетнама по ключевым словам, категориям или ценовому диапазону

  • Сравнивать товары на Lazada, Shopee, Amazon и в местных магазинах одним запросом

  • Находить выгодные предложения и отслеживать цены в реальном времени с поддержкой нескольких валют

  • Создавать shopping-агентов, которые программно рекомендуют товары, сравнивают их и предоставляют ссылки

  • Изучать каталоги товаров с продуманной системой категорий для поддерживаемых рынков

API для поиска товаров AI-агентами через Model Context Protocol. Создан для торговли с участием AI-агентов, а не для управления магазинами.

Официальная запись в MCP Registry: io.github.BuyWhere/buywhere-mcp

Работает с Claude Desktop, Cursor, VS Code Copilot, Cline, Windsurf, OpenCode, Codex, Continue.dev и любым клиентом, совместимым с MCP. Также поддерживает протокол Agent-to-Agent (A2A).

Демонстрация

Демонстрация продолжительностью 44 секунды: поиск товаров, подбор выгодных предложений, сравнение цен и поддержка нескольких регионов.

User:   "Find me wireless earbuds under $50 available in Singapore"
Agent:  [calls search_products → returns 5 matching products]

User:   "Compare the top 3"
Agent:  [calls compare_products → side-by-side with best-value pick]

Быстрый старт

Получите ключ за 3 секунды — без регистрации и электронной почты:

# 1. Регистрация (один запрос — ключ API возвращается сразу)
curl -X POST https://api.buywhere.ai/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"agent_name":"your-agent"}'
# → {"api_key":"bw_...","tier":"unverified","rate_limit":{"rpm":20,"daily":1000}}

# 2. Использование ключа
export BUYWHERE_API_KEY=bw_...
npx -y @buywhere/mcp-server

Регистрация по электронной почте для прежнего способа получения ключа (60 секунд, ручное подтверждение) → buywhere.ai/api-keys

Руководства

В блоге

Читайте инженерный блог BuyWhere — в нём подробно рассматриваются архитектура MCP, торговля с участием агентов и экосистема.

Подписывайтесь также на зеркало блога BuyWhere на Hashnode: там публикуются те же материалы об инженерных решениях.

Инструменты

ИнструментОписание
search_productsПоиск в каталоге по ключевым словам, категории, цене и стране
get_productПолная информация о товаре по ID: цены, характеристики и изображения
compare_productsСравнение от 2 до 10 товаров бок о бок
find_best_priceСамое дешёвое предложение с доставкой для товара среди продавцов
get_dealsТовары со значительным снижением цены
list_categoriesДоступная система категорий товаров
find_similarПоиск похожих товаров на основе векторного сходства
ingest_productsОтправка URL товаров для добавления в каталог (агентами или продавцами)
search_products_v2Поиск версии v2; требуется параметр deliver_to (страна в формате ISO)
get_product_v2Информация о товаре версии v2 по ID
compare_products_v2Сравнение версии v2; параметр deliver_to необязателен
get_deals_v2Выгодные предложения версии v2; требуется параметр deliver_to
find_best_price_v2Лучшая цена версии v2; требуется параметр deliver_to

Удалённый MCP: POST https://api.buywhere.ai/mcp (JSON-RPC 2.0, protocolVersion 2024-11-05, 13 инструментов). Страница в Glama: https://glama.ai/mcp/servers/BuyWhere/buywhere-mcp

Настройка MCP-клиента

Краткие инструкции для фреймворков:

Claude Desktop

Добавьте настройки в claude_desktop_config.json:

{
  "mcpServers": {
    "buywhere": {
      "command": "npx",
      "args": ["-y", "@buywhere/mcp-server"],
      "env": { "BUYWHERE_API_KEY": "bw_live_xxxx" }
    }
  }
}

Cursor / VS Code / Cline

Добавьте настройки в файл конфигурации MCP:

{
  "mcpServers": {
    "buywhere": {
      "command": "npx",
      "args": ["-y", "@buywhere/mcp-server"],
      "env": { "BUYWHERE_API_KEY": "bw_live_xxxx" }
    }
  }
}

Windsurf

Добавьте настройки в ~/.windsurf/mcp.json:

{
  "mcpServers": {
    "buywhere": {
      "command": "npx",
      "args": ["-y", "@buywhere/mcp-server"],
      "env": { "BUYWHERE_API_KEY": "bw_live_xxxx" }
    }
  }
}

OpenCode / Codex

Добавьте настройки в opencode.json:

{
  "mcpServers": {
    "buywhere": {
      "command": "npx",
      "args": ["-y", "@buywhere/mcp-server"],
      "env": { "BUYWHERE_API_KEY": "bw_live_xxxx" }
    }
  }
}

Continue.dev (VS Code / JetBrains)

Добавьте настройки в ~/.continue/config.json:

{
  "experimental": {
    "mcpServers": {
      "buywhere": {
        "command": "npx",
        "args": ["-y", "@buywhere/mcp-server"],
        "env": { "BUYWHERE_API_KEY": "bw_live_xxxx" }
      }
    }
  }
}

Mastra

Mastra — фреймворк для AI-агентов, ориентированный на TypeScript и изначально поддерживающий MCP.

npm install @mastra/core @mastra/mcp

import { Mastra } from '@mastra/core';
import { MastraMCPClient } from '@mastra/mcp';

const buywhere = new MastraMCPClient({
  name: 'buywhere',
  server: {
    url: new URL('https://api.buywhere.ai/mcp'),
    requestInit: {
      headers: { 'Authorization': `Bearer ${process.env.BUYWHERE_API_KEY}` },
    },
  },
});

const agent = new Mastra({
  agents: {
    shoppingAgent: {
      instructions: 'You are a shopping assistant. Use BuyWhere to find and compare products.',
      tools: await buywhere.tools(),
    },
  },
});

const result = await agent.agents.shoppingAgent.generate(
  'Find me the best deal on a Sony WH-1000XM5 in Singapore'
);

Полное руководство: интеграция BuyWhere и Mastra

LangChain

Используйте инструменты BuyWhere в агентах LangChain через адаптер MCP:

from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent
from langchain_anthropic import ChatAnthropic

async def main():
    async with MultiServerMCPClient({
        "buywhere": {
            "url": "https://api.buywhere.ai/mcp",
            "transport": "streamable_http",
            "headers": {"Authorization": f"Bearer {BUYWHERE_API_KEY}"},
        }
    }) as client:
        tools = await client.get_tools()
        agent = create_react_agent(ChatAnthropic(model="claude-sonnet-4-5"), tools)
        result = await agent.ainvoke({"messages": [("user", "Find the cheapest Sony headphones in Singapore")]})

LlamaIndex

Подключите BuyWhere с помощью MCP-клиента LlamaIndex:

from llama_index.tools.mcp import BasicMCPClient, McpToolSpec
from llama_index.agent.openai import OpenAIAgent

async def main():
    mcp_client = BasicMCPClient(
        command_or_url="https://api.buywhere.ai/mcp",
        headers={"Authorization": f"Bearer {BUYWHERE_API_KEY}"},
    )
    mcp_tool_spec = McpToolSpec(client=mcp_client)
    tools = mcp_tool_spec.to_tool_list()
    agent = OpenAIAgent.from_tools(tools)
    response = await agent.achat("Compare prices for iPhone 16 Pro across Singapore and US")

CrewAI

Используйте BuyWhere в агенте CrewAI с интеграцией MCP-инструментов:

from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter

buywhere_server = MCPServerAdapter(
    server_params={
        "url": "https://api.buywhere.ai/mcp",
        "headers": {"Authorization": f"Bearer {BUYWHERE_API_KEY}"},
        "transport": "streamable-http",
    }
)

shopping_agent = Agent(
    role="Shopping Research Analyst",
    goal="Find the best deals across Singapore and US markets",
    tools=[buywhere_server],
)

task = Task(
    description="Find the best price for Sony WH-1000XM5 headphones across all available markets",
    agent=shopping_agent,
    expected_output="Product comparison with prices and merchant links",
)

crew = Crew(agents=[shopping_agent], tasks=[task])
result = crew.kickoff()

Конфигурация

ПеременнаяЗначение по умолчаниюОписание
BUYWHERE_API_KEY(обязательный параметр)API-ключ (регистрация не требуется: POST /v1/auth/register {"agent_name":""}) — выдается мгновенно, подтверждение по электронной почте не требуется
BUYWHERE_API_URLhttps://api.buywhere.ai/mcpПользовательский базовый URL API

Установка

# Запуск напрямую (без установки)
npx -y @buywhere/mcp-server

# Глобальная установка
npm install -g @buywhere/mcp-server
buywhere-mcp

Варианты использования

  • Агенты для покупок — создавайте AI-агентов, которые ищут товары, сравнивают их и рекомендуют варианты на разных рынках

  • Сравнение цен — получайте цены на нескольких рынках в одном запросе для Lazada, Shopee, Amazon и местных продавцов

  • Поиск выгодных предложений — находите товары с оптимальным соотношением цены и качества, проверяя актуальные цены и наличие

  • Автоматизация электронной коммерции — добавляйте поиск товаров в любое приложение, совместимое с MCP

  • Международная торговля — сравнивайте цены в Сингапуре, США, Малайзии, Таиланде и Вьетнаме

  • Торговля между агентами — делегируйте задачи по покупкам между агентами с помощью протокола A2A

Архитектура

Developer's AI Agent (Claude, Cursor, etc.)
  │
  ├── MCP Protocol (stdio)
  │
  ├── @buywhere/mcp-server
  │     ├── search_products(q, category, min_price, max_price, country_code, deliver_to)
  │     ├── get_product(product_id)
  │     ├── compare_products(product_ids[])
  │     ├── find_best_price(product_name, country_code, deliver_to)
  │     ├── get_deals(country_code, deliver_to, category)
  │     ├── list_categories()
  │     ├── find_similar(product_id)
  │     └── ingest_products(urls[])
  │
  └── BuyWhere API (api.buywhere.ai)
        └── Product catalog across SG, US, MY, TH, and VN merchants

Разработка

git clone https://github.com/BuyWhere/buywhere-mcp.git
cd buywhere-mcp
npm install
npm run build
npm start

Почему BuyWhere?

BuyWhere — это API для поиска товаров, созданный для AI-агентов. Мы объединяем данные о товарах от продавцов из Сингапура, США, Малайзии, Таиланда и Вьетнама в одном интерфейсе, удобном для агентов. Управлять магазинами и настраивать интеграцию с Shopify не нужно — достаточно искать и сравнивать товары в реальном времени.

  • Один API — все рынки и продавцы

  • Создан для агентов — поддержка MCP заложена с самого начала

  • Актуальные данные — цены и наличие в реальном времени

  • Для разработчиков — SDK не требуется, достаточно добавить сервер

Совместимые инструменты

Эти дополнительные MCP-пакеты позволяют использовать BuyWhere в эффективных сценариях с несколькими инструментами:

  • @modelcontextprotocol/server-filesystem — сохраняйте результаты поиска и исследования товаров в локальной файловой системе. Используйте вместе с BuyWhere, чтобы экспортировать списки выгодных предложений, сравнения цен и характеристики товаров в виде структурированных файлов.

  • @supabase/mcp-server-supabase — храните в Supabase избранные товары, предпочтения пользователей и оповещения об изменении цен. Сохраняйте историю покупок между сеансами агента.

  • n8n-mcp — автоматизируйте отслеживание цен. Создавайте конвейеры без кода, которые следят за ценами BuyWhere и отправляют уведомления при их снижении.

  • tavily-mcp — изучайте товары перед покупкой. Используйте Tavily для поиска отзывов и сравнений, а затем BuyWhere — для проверки актуальных цен и ссылок на покупку.

  • @playwright/mcp — тестируйте взаимодействие с агентом для покупок от начала до конца. Проверяйте, что поиск товаров, сравнение цен и оформление заказа корректно работают в браузере с автоматизацией.

Протоколы

ПротоколПоддержка
MCP (Model Context Protocol)Полная поддержка — 10 инструментов, транспорт stdio
A2A (Agent-to-Agent)Делегирование задач между несколькими агентами — Карточка агента

Участие в разработке

Инструкции по сообщению об ошибках, отправке PR и предложению новых возможностей см. в CONTRIBUTING.md.

Статьи в блоге

Узнайте больше о MCP-серверах и экосистеме BuyWhere:

Поддержка

Если проект оказался полезен:

  • ⭐ Поставьте звезду репозиторию — это поможет другим найти BuyWhere

  • 🐛 Создайте issue, чтобы сообщить об ошибке или предложить новую функцию

  • 💬 Начните обсуждение, если у вас есть вопрос или идея

  • 📣 Расскажите о проекте другим разработчикам, создающим инструменты для AI-агентов

Лицензия

MIT