ec-mcp
ec-mcp
轻量级 Model Context Protocol 服务器,用于日本电商平台(Mercari 和 Yahoo! Flea Market)。每个提供方仅与结构化的 JSON HTTP API 通信——不进行 HTML 抓取。
安装 / 运行
bun installRelated MCP server: mercari-jp-mcp
运行
bun src/index.tsMCP 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:启用实时集成测试。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Pay-per-use tool marketplace for AI agents. Search, price-check, and call APIs via MCP.
Hosted MCP server for 3Dsellers, the multichannel selling platform. Connect Claude, ChatGPT, Cursor, VS Code or any MCP client and manage your eBay, Amazon, Walmart, Etsy, Shopify, WooCommerce and TikTok Shop stores in plain language: search and update products, publish listings, sync inventory, tag and track orders, run bulk actions and CSV imports, and reply to customer messages. 120+ tools. Sign in with OAuth or a personal token. No eBay developer account and nothing to install. Setup guides and config examples for every client: https://github.com/3dsellers/ebay-mcp-server
Unofficial SerpApi MCP — wraps SerpApi (serpapi.com) search engines
SuperCatch connects your AI assistant to a trading-card and collectibles marketplace and your own SuperCatch account or approved stores. Search public cards and collectibles, inspect current offers and seller storefronts, and find cited setup and help documentation without signing in. Connect through SuperCatch OAuth to read your purchases, watchlist membership, saved searches, recorded collection items and support cases. Approved sellers can inspect their listings, stock, low-stock items, orders, sales activity, imports and integration health, subject to current permissions. For supported changes, request the exact action you intend. Depending on consent, permissions and native readiness, tools can manage account watchlist membership and saved searches or prepare supported pricing, inventory, stock-receipt, photo-draft, listing-submission, marketplace-publication, first-shipment, tracking-correction, import-resume and support workflows. Preparation does not execute a change. Actions requiring native approval provide a SuperCatch review link and execute only the approved frozen scope. Price changes require exact confirmation or bound native approval according to the selected tool. A shipment or tracking action does not authorize a label purchase, payment or refund. Private results stay within the connected account and approved-store access. A tool appearing in discovery does not grant permission to call it. After an uncertain response, inspect the original operation and reuse its original idempotency key where documented; do not create a replacement intent to bypass recovery. Preview tools do not activate recurring automation. Connect using Streamable HTTP at https://supercatch.com/api/mcp. Setup: https://supercatch.com/ai. Help: https://supercatch.com/help. Support: support@supercatch.com. Review or revoke OAuth access in SuperCatch Account Settings > Connected Apps. Prices and availability can change; inspect the linked source before acting. Official connector repository: https://github.com/empline/supercatch-mcp.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAn 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.-
- AlicenseNot gradedqualityCmaintenanceEnables searching Mercari Japan products with keyword, price range, condition, and status filters, and supports bulk searches from files with automatic translation to English.MIT
- AlicenseNot gradedqualityBmaintenanceEnables searching active eBay listings, retrieving full item details, and browsing eBay category taxonomies through MCP tools.95 npm1MIT
- AlicenseNot gradedqualityCmaintenanceEnables searching and browsing Facebook Marketplace listings, retrieving item details, nearby items, categories, and parsing listing URLs through MCP tools.1MIT