shopping-mcp

Сервер MCP, который позволяет Claude (или любому MCP-клиенту) искать объявления eBay через официальный Browse API.

Спросите «найди мне механическую клавиатуру дешевле 100 долларов, только „Купить сейчас“, бесплатная доставка» — и ассистент действительно сможет пойти и поискать.

eBay results for "mechanical keyboard" — showing 3 of about 41,208 matches

1. Keychron K8 Pro Wireless Mechanical Keyboard - Brown Switches — $79.99
   total $79.99 · free shipping · New · was $99.00 (19% off)
   seller keeb_supply · 99.6% positive (8421 ratings) · top rated, ships from US
   Item v1|335894120043|0 · https://www.ebay.com/itm/335894120043

2. Ducky One 3 TKL Mechanical Keyboard RGB Hot-Swappable — $84.50
   total $92.45 · $7.95 shipping · New
   seller pc_parts_direct · 98.9% positive (3310 ratings) · accepts offers
   Item v1|326770118254|0 · https://www.ebay.com/itm/326770118254

Что он делает — и чего осознанно не делает

Каждый инструмент доступен только для чтения. Этот сервер ищет и читает объявления. Он не может сделать ставку, добавить товар в корзину, оформить заказ или потратить деньги. Когда вы захотите купить, он выдаст вам ссылку на объявление, а оформление заказа вы возьмёте на себя.

Он построен на официальном eBay Browse API — никакого скрейпинга, автоматизации браузера или повтора cookie. Он не сломается при изменении макета и не нарушит условия использования eBay.

Related MCP server: ebay-mcp

Инструменты

Две вещи, которые стоит знать о search_ebay, потому что именно так устроен eBay, а не фиксированный каталог:

• buying_option фильтрует по auction, buy_it_now или accepts_offers.

• sort: "ending_soonest" — в сочетании с buying_option: "auction" так можно найти аукционы, которые вот-вот завершатся.

Получение ключей API

1. Войдите на developer.ebay.com/my/keys.

2. Создайте приложение и откройте набор ключей Production.

3. Скопируйте App ID (Client ID) и Cert ID (Client Secret).

Вот и всё. Этот сервер использует поток учётных данных клиента OAuth, поэтому вам не нужен пользовательский токен, URI перенаправления или «RuName».

Новым аккаунтам разработчиков, возможно, придётся пройти проверку eBay, прежде чем откроется страница ключей, — обычно это занимает около рабочего дня.

Установка

git clone https://github.com/Kirat5690/shopping-mcp.git

cd shopping-mcp && npm install && npm run build

Подключение к клиенту

Claude Code

claude mcp add shopping --env EBAY_CLIENT_ID=your-app-id --env EBAY_CLIENT_SECRET=your-cert-id -- node /absolute/path/to/shopping-mcp/dist/index.js

Claude Desktop

Отредактируйте claude_desktop_config.json:

• macOS — ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows — %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "shopping": {
      "command": "node",
      "args": ["C:\\path\\to\\shopping-mcp\\dist\\index.js"],
      "env": {
        "EBAY_CLIENT_ID": "your-app-id",
        "EBAY_CLIENT_SECRET": "your-cert-id",
        "EBAY_MARKETPLACE_ID": "EBAY_US"
      }
    }
  }
}

Перезапустите клиент, затем попросите его выполнить check_ebay_connection, чтобы убедиться, что учётные данные работают.

Справочник по конфигурации

Примечания о цифрах

• Учитывается итоговая цена. При сортировке по цене учитывается цена товара плюс доставка, так что дешёвый товар с дорогой пересылкой не выигрывает по случайности. Собственная сортировка eBay по цене не всегда так делает.

• У некоторых объявлений нет итоговой суммы. Если eBay указывает доставку как рассчитываемую при оформлении заказа, итоговая цена неизвестна до указания адреса доставки, и в объявлении об этом сказано, а не угадывается.

• Без конвертации валют. Цены указаны в валюте торговой площадки ровно так, как их возвращает eBay.

• Объявления — это отдельные продажи, а не позиции каталога. Два результата с почти одинаковыми названиями могут отличаться по состоянию, комплекту поставки или региону. Прежде чем считать их одним и тем же товаром, стоит проверить.

• find_deals видит только заявленные скидки. Он фильтрует по зачёркнутой «старой» цене eBay, поэтому действительно дешёвое объявление без заявленной скидки в нём не появится.

Разработка

npm test

Набор тестов запускается без каких-либо учётных данных eBay. Он охватывает логику денежных расчётов и итоговой цены, форматирование вывода, а также сквозной тест протокола MCP, который запускает сервер через stdio и проверяет регистрацию инструментов, валидацию схемы и пути с не настроенными учётными данными.

npm run watch      # recompile on change
npm run typecheck  # types only, no emit

Структура:

src/
  index.ts     server entry point and stdio wiring
  tools.ts     MCP tool definitions
  ebay.ts      Browse API client and OAuth token cache
  config.ts    environment parsing and marketplace table
  money.ts     price parsing, landed totals, ranking
  format.ts    human-readable output
  http.ts      fetch with timeout and retry

Примечание о границах

В более ранних версиях также поддерживалась Amazon через Product Advertising API. Это было удалено в v0.2.0: PA-API требует одобренную учётную запись Amazon Associates, а Amazon отзывает доступ, если аккаунт не совершает соответствующих продаж, — слишком высокий порог для большинства, кто хочет просто запустить сервер.

Клиент Amazon и его подпись AWS SigV4 сохранены в истории git в теге v0.1.0-amazon, если у вас есть одобренный аккаунт и вы хотите их вернуть.

Лицензия

MIT — см. LICENSE.

Не аффилирован с eBay, не одобрен и не спонсируется eBay. Ваше использование eBay API регулируется Лицензионным соглашением eBay API.