ec-mcp

Легковесный сервер Model Context Protocol для японских маркетплейсов (Mercari и Yahoo! Flea Market). Каждый провайдер работает только со структурированными JSON HTTP API — без HTML-скрапинга.

Установка / Запуск

bun install

Related MCP server: mercari-jp-mcp

Запуск

bun src/index.ts

Эндпоинт MCP Streamable HTTP доступен по адресу http://localhost:3001/mcp. Переменная PORT настраивается.

curl http://localhost:3001/health

Разработка

bun test
bun run typecheck
bun run smoke

Инструменты

Mercari

• mercari_search: ищет товары с помощью публичных фильтров поиска Mercari (классические товары и товары Mercari Shops / beyond).

• mercari_get_item: принимает ID товара (m12345678901) или полный URL товара.

• mercari_get_categories: фильтрует справочник категорий Mercari по ключевому слову, ID родительской категории или корневому уровню.

Mercari использует подписанный внутренний REST API (api.mercari.jp) с анонимным DPoP-токеном для каждого запроса. HTML не загружается и не парсится.

Yahoo! Flea Market (Yahoo!フリマ)

• yahoo_fleamarket_search: ищет объявления. Фильтры: keyword, exclude_keyword, category_id, price_min/price_max, condition (new,used10..used60), status (on_sale/sold_out, по умолчанию on_sale), seller_id, sort (price) + order, limit, offset.

• yahoo_fleamarket_get_item: принимает ID товара или URL товара; возвращает описание, фотографии, путь категории, состояние, способ/срок доставки, регион отправки, продавца, счётчики like/PV, время создания.

• yahoo_fleamarket_get_categories: выводит дочерние категории по parent_id, жанры верхнего уровня через root_only или ищет по всем уровням с помощью keyword.

• yahoo_fleamarket_get_seller: возвращает публичный профиль продавца (никнейм, рейтинг).

Yahoo использует анонимные JSON API по адресу paypayfleamarket.yahoo.co.jp/api (/v1/search, /item/v2/items/{id}, /v1/categories/{id}/children, /v1/users/{id}) — те же эндпоинты, которые вызывают API-модули веб-клиента. Никаких cookie, токенов или специальных заголовков не требуется.

Переменные окружения

• PORT: HTTP-порт (по умолчанию 3001).

• MERCARI_DEBUG=true / YAHOO_FLEAMARKET_DEBUG=true: трассировка запросов/ответов с редактированием конфиденциальных данных в stderr.

• MERCARI_INTEGRATION_TEST=true / YAHOO_FLEAMARKET_INTEGRATION_TEST=true: включает интеграционные тесты с реальными вызовами.