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 상품)로 상품을 검색합니다.

• mercari_get_item: 상품 ID(m12345678901) 또는 전체 상품 URL을 받습니다.

• mercari_get_categories: 키워드, 부모 ID 또는 루트 레벨로 Mercari의 카테고리 마스터를 필터링합니다.

Mercari는 서명된 내부 REST API(api.mercari.jp)를 요청별 익명 DPoP 토큰과 함께 사용합니다. 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})를 사용합니다 — 웹 클라이언트의 API 모듈이 호출하는 것과 동일한 엔드포인트입니다. 쿠키, 토큰 또는 특별한 헤더가 필요하지 않습니다.

환경 변수

• PORT: HTTP 포트(기본값 3001).

• MERCARI_DEBUG=true / YAHOO_FLEAMARKET_DEBUG=true: 민감 정보가 제거된 요청/응답 추적을 stderr로 출력합니다.

• MERCARI_INTEGRATION_TEST=true / YAHOO_FLEAMARKET_INTEGRATION_TEST=true: 라이브 통합 테스트를 활성화합니다.