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：按关键词、父级 ID 或根级别筛选 Mercari 的分类主数据。

Mercari 使用带签名的内部 REST API（api.mercari.jp），并附带每个请求的匿名 DPoP token。不会获取或解析 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、token 或特殊请求头。

环境变量

• PORT：HTTP 端口（默认 3001）。

• MERCARI_DEBUG=true / YAHOO_FLEAMARKET_DEBUG=true：将脱敏的请求/响应跟踪输出到 stderr。

• MERCARI_INTEGRATION_TEST=true / YAHOO_FLEAMARKET_INTEGRATION_TEST=true：启用实时集成测试。