ec-mcp

Servidor ligero del Model Context Protocol para marketplaces japoneses (Mercari y Yahoo! Flea Market). Cada proveedor se comunica únicamente con APIs HTTP JSON estructuradas — sin scraping de HTML.

Instalación / Ejecución

bun install

Related MCP server: mercari-jp-mcp

Ejecución

bun src/index.ts

El endpoint Streamable HTTP de MCP es http://localhost:3001/mcp. PORT es configurable.

curl http://localhost:3001/health

Desarrollo

bun test
bun run typecheck
bun run smoke

Herramientas

Mercari

• mercari_search: busca productos con los filtros de búsqueda públicos de Mercari (artículos clásicos y de Mercari Shops / beyond).

• mercari_get_item: acepta un ID de artículo (m12345678901) o una URL completa de producto.

• mercari_get_categories: filtra el maestro de categorías de Mercari por palabra clave, ID de categoría padre o nivel raíz.

Mercari utiliza la API REST interna firmada (api.mercari.jp) con un token DPoP anónimo por solicitud. No se obtiene ni se analiza HTML.

Yahoo! Flea Market (Yahoo!フリマ)

• yahoo_fleamarket_search: busca anuncios. Filtros: keyword, exclude_keyword, category_id, price_min/price_max, condition (new,used10..used60), status (on_sale/sold_out, por defecto on_sale), seller_id, sort (price) + order, limit, offset.

• yahoo_fleamarket_get_item: acepta un ID de artículo o una URL de artículo; devuelve la descripción, las fotos, la ruta de categoría, el estado, el método/plazo de entrega, el origen del envío, el vendedor, el número de me gusta/PV y la fecha de creación.

• yahoo_fleamarket_get_categories: lista las categorías hijas por parent_id, los géneros principales mediante root_only, o busca en todos los niveles por keyword.

• yahoo_fleamarket_get_seller: devuelve un perfil público de vendedor (apodo, valoración).

Yahoo utiliza las APIs JSON anónimas bajo paypayfleamarket.yahoo.co.jp/api (/v1/search, /item/v2/items/{id}, /v1/categories/{id}/children, /v1/users/{id}) — los mismos endpoints a los que llaman los módulos de API del cliente web. No se requieren cookies, tokens ni cabeceras especiales.

Variables de entorno

• PORT: puerto HTTP (por defecto 3001).

• MERCARI_DEBUG=true / YAHOO_FLEAMARKET_DEBUG=true: traza de solicitud/respuesta con datos omitidos en stderr.

• MERCARI_INTEGRATION_TEST=true / YAHOO_FLEAMARKET_INTEGRATION_TEST=true: habilita las pruebas de integración en vivo.