ec-mcp

日本のマーケットプレイス（MercariとYahoo! Flea Market）向けの軽量なModel Context Protocolサーバーです。すべてのプロバイダーは構造化された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 items）を使用して商品を検索します。

• mercari_get_item: 商品ID（m12345678901）または完全な商品URLを受け付けます。

• mercari_get_categories: キーワード、親ID、またはルートレベルでMercariのカテゴリマスターをフィルタリングします。

Mercariは、リクエストごとに匿名のDPoPトークンを使用する署名付き内部REST API（api.mercari.jp）を利用します。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を受け付けます。説明、写真、カテゴリパス、状態、配送方法/スケジュール、発送元、出品者、いいね/PV数、作成日時を返します。

• yahoo_fleamarket_get_categories: parent_idで子カテゴリを一覧表示し、root_onlyでトップジャンルを取得し、keywordで全レベルの検索を行います。

• yahoo_fleamarket_get_seller: 公開出品者プロフィール（ニックネーム、評価）を返します。

Yahooは、paypayfleamarket.yahoo.co.jp/api 配下の匿名JSON API（/v1/search、/item/v2/items/{id}、/v1/categories/{id}/children、/v1/users/{id}）を使用します。これはWebクライアントのAPIモジュールが呼び出すのと同じエンドポイントです。Cookie、トークン、特別なヘッダーは必要ありません。

環境変数

• PORT: HTTPポート（デフォルトは3001）。

• MERCARI_DEBUG=true / YAHOO_FLEAMARKET_DEBUG=true: リクエスト/レスポンスのトレースをマスクしてstderrに出力します。

• MERCARI_INTEGRATION_TEST=true / YAHOO_FLEAMARKET_INTEGRATION_TEST=true: ライブ統合テストを有効にします。