Skip to main content
Glama
deenesjakoruzh
uirooong

ec-mcp

by uirooong
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

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: включает интеграционные тесты с реальными вызовами.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Mercari MCP Server

    purebaba
    F
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that enables users to search for products on the Mercari marketplace using keywords, categories, and specific filters like price and condition. It provides comprehensive tools for retrieving item details and browsing search results via standard or SSE protocols.
    -

  • mercari-jp-mcp

    rafayqazi
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables searching Mercari Japan products with keyword, price range, condition, and status filters, and supports bulk searches from files with automatic translation to English.
    MIT

  • mcp-ebay

    pipeworx-io
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables searching active eBay listings, retrieving full item details, and browsing eBay category taxonomies through MCP tools.
    291 npm
    1
    MIT