Skip to main content
Glama
Sign In
deenesjakoruzh
ec-mcp

ec-mcp

by uirooong
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

ec-mcp

Leichtgewichtiger Model Context Protocol-Server für japanische Marktplätze (Mercari und Yahoo! Flea Market). Jeder Anbieter kommuniziert ausschließlich mit strukturierten JSON-HTTP-APIs — kein HTML-Scraping.

Installieren / Ausführen

bun install

Related MCP server: mercari-jp-mcp

Ausführen

bun src/index.ts

Der MCP-Streamable-HTTP-Endpunkt ist http://localhost:3001/mcp. PORT ist konfigurierbar.

curl http://localhost:3001/health

Entwicklung

bun test
bun run typecheck
bun run smoke

Werkzeuge

Mercari

  • mercari_search: durchsucht Produkte mit Mercaris öffentlichen Suchfiltern (klassische sowie Mercari-Shops-/Beyond-Artikel).

  • mercari_get_item: akzeptiert eine Artikel-ID (m12345678901) oder eine vollständige Produkt-URL.

  • mercari_get_categories: filtert Mercaris Kategoriestamm nach Schlüsselwort, Parent-ID oder Root-Ebene.

Mercari verwendet die signierte interne REST-API (api.mercari.jp) mit einem anonymen DPoP-Token pro Anfrage. Es wird kein HTML abgerufen oder geparst.

Yahoo! Flea Market (Yahoo!フリマ)

  • yahoo_fleamarket_search: durchsucht Angebote. Filter: keyword, exclude_keyword, category_id, price_min/price_max, condition (new,used10..used60), status (on_sale/sold_out, Standard on_sale), seller_id, sort (price) + order, limit, offset.

  • yahoo_fleamarket_get_item: akzeptiert eine Artikel-ID oder Artikel-URL; gibt Beschreibung, Fotos, Kategoriepfad, Zustand, Liefermethode/-zeitplan, Versandherkunft, Verkäufer, Like-/PV-Anzahl und Erstellungszeitpunkt zurück.

  • yahoo_fleamarket_get_categories: listet Unterkategorien anhand von parent_id auf, Top-Genres über root_only, oder durchsucht alle Ebenen nach keyword.

  • yahoo_fleamarket_get_seller: gibt ein öffentliches Verkäuferprofil zurück (Nickname, Bewertung).

Yahoo verwendet die anonymen JSON-APIs unter paypayfleamarket.yahoo.co.jp/api (/v1/search, /item/v2/items/{id}, /v1/categories/{id}/children, /v1/users/{id}) — dieselben Endpunkte, die auch die API-Module des Web-Clients aufrufen. Es sind keine Cookies, Tokens oder speziellen Header erforderlich.

Umgebungsvariablen

  • PORT: HTTP-Port (Standard 3001).

  • MERCARI_DEBUG=true / YAHOO_FLEAMARKET_DEBUG=true: gibt geschwärzte Anfrage-/Antwort-Traces an stderr aus.

  • MERCARI_INTEGRATION_TEST=true / YAHOO_FLEAMARKET_INTEGRATION_TEST=true: aktiviert die Live-Integrationstests.

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

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.
    10 npm
    1
    MIT