shopping-mcp

MCP 서버로, Claude(또는 모든 MCP 클라이언트)가 공식 Browse API를 통해 eBay 목록을 검색할 수 있게 해줍니다.

*"100달러 미만 기계식 키보드, 즉시 구매만, 무료 배송으로 찾아줘"*라고 물어보면 어시스턴트가 실제로 검색해 볼 수 있습니다.

eBay results for "mechanical keyboard" — showing 3 of about 41,208 matches

1. Keychron K8 Pro Wireless Mechanical Keyboard - Brown Switches — $79.99
   total $79.99 · free shipping · New · was $99.00 (19% off)
   seller keeb_supply · 99.6% positive (8421 ratings) · top rated, ships from US
   Item v1|335894120043|0 · https://www.ebay.com/itm/335894120043

2. Ducky One 3 TKL Mechanical Keyboard RGB Hot-Swappable — $84.50
   total $92.45 · $7.95 shipping · New
   seller pc_parts_direct · 98.9% positive (3310 ratings) · accepts offers
   Item v1|326770118254|0 · https://www.ebay.com/itm/326770118254

하는 일 — 그리고 의도적으로 하지 않는 일

모든 도구는 읽기 전용입니다. 이 서버는 목록을 검색하고 읽을 수만 있습니다. 입찰, 장바구니 추가, 주문, 결제는 할 수 없습니다. 구매를 원하면 목록 링크를 제공하고, 직접 결제를 진행해야 합니다.

공식 eBay Browse API를 기반으로 구축되었습니다. 스크래핑, 브라우저 자동화, 쿠키 재사용이 없습니다. 레이아웃 변경으로 깨지지 않으며, eBay 이용약관을 위반하지도 않습니다.

Related MCP server: ebay-mcp

도구

search_ebay에 대해 알아두면 좋은 두 가지가 있습니다. eBay에는 있지만 고정 가격 카탈로그에는 없는 기능입니다:

• buying_option은 auction, buy_it_now, accepts_offers로 필터링합니다.

• sort: "ending_soonest" — buying_option: "auction"과 함께 사용하면 곧 마감될 경매를 찾을 수 있습니다.

API 키 받기

1. developer.ebay.com/my/keys에 로그인합니다.

2. 애플리케이션을 만들고 Production 키 세트를 엽니다.

3. **App ID(Client ID)**와 **Cert ID(Client Secret)**를 복사합니다.

이것으로 끝입니다. 이 서버는 OAuth 클라이언트 자격 증명 흐름을 사용하므로 사용자 토큰, 리디렉션 URI 또는 "RuName"이 필요하지 않습니다.

새 개발자 계정은 키 페이지가 열리기 전에 eBay의 인증을 통과해야 할 수 있습니다. 일반적으로 영업일 기준 약 하루가 걸립니다.

설치

git clone https://github.com/Kirat5690/shopping-mcp.git

cd shopping-mcp && npm install && npm run build

클라이언트에 연결

Claude Code

claude mcp add shopping --env EBAY_CLIENT_ID=your-app-id --env EBAY_CLIENT_SECRET=your-cert-id -- node /absolute/path/to/shopping-mcp/dist/index.js

Claude Desktop

claude_desktop_config.json을 편집합니다:

• macOS — ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows — %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "shopping": {
      "command": "node",
      "args": ["C:\\path\\to\\shopping-mcp\\dist\\index.js"],
      "env": {
        "EBAY_CLIENT_ID": "your-app-id",
        "EBAY_CLIENT_SECRET": "your-cert-id",
        "EBAY_MARKETPLACE_ID": "EBAY_US"
      }
    }
  }
}

클라이언트를 다시 시작한 다음, 자격 증명이 작동하는지 확인하기 위해 check_ebay_connection을 실행하도록 요청하세요.

구성 참조

수치에 대한 참고 사항

• 최종 가격이 정렬 기준입니다. 가격 정렬은 상품 가격에 배송비를 더한 금액을 사용하므로, 배송비가 비싼 저렴한 상품이 기술적인 이유로 앞서지 않습니다. eBay 자체 가격 정렬은 항상 이렇게 하지 않습니다.

• 일부 목록에는 총액이 없습니다. eBay가 배송비를 결제 시 계산되는 것으로 표시하는 경우, 배송 주소를 알기 전까지는 최종 가격이 없으며, 목록은 추측하지 않고 그렇게 표시합니다.

• 통화 변환 없음. 가격은 eBay가 반환하는 그대로 마켓플레이스 자체 통화로 표시됩니다.

• 목록은 카탈로그 항목이 아닌 개별 판매입니다. 거의 동일한 제목의 두 결과도 상태, 번들 구성, 지역이 다를 수 있습니다. 동일한 상품으로 간주하기 전에 확인할 가치가 있습니다.

• find_deals는 광고된 할인만 볼 수 있습니다. eBay의 취소선 "was" 가격을 기준으로 필터링하므로, 할인을 표시하지 않은 진짜 저렴한 목록은 나타나지 않습니다.

개발

npm test

테스트 스위트는 eBay 자격 증명 없이 실행됩니다. 금액 및 최종 가격 로직, 출력 형식, 그리고 stdio를 통해 서버를 부팅하고 도구 등록, 스키마 검증, 자격 증명 미설정 경로를 테스트하는 종단 간 MCP 프로토콜 테스트를 포함합니다.

npm run watch      # recompile on change
npm run typecheck  # types only, no emit

구조:

src/
  index.ts     server entry point and stdio wiring
  tools.ts     MCP tool definitions
  ebay.ts      Browse API client and OAuth token cache
  config.ts    environment parsing and marketplace table
  money.ts     price parsing, landed totals, ranking
  format.ts    human-readable output
  http.ts      fetch with timeout and retry

범위에 대한 참고

이전 버전에서는 Product Advertising API를 통해 Amazon도 지원했습니다. 이 기능은 v0.2.0에서 제거되었습니다. PA-API는 승인된 Amazon Associates 계정이 필요하며, 자격을 갖춘 판매가 없으면 Amazon이 액세스를 취소합니다. 대부분의 사람이 서버를 실행하기에는 너무 높은 장벽입니다.

Amazon 클라이언트와 AWS SigV4 서명은 승인된 계정이 있고 복원을 원하는 경우 태그 v0.1.0-amazon의 git 기록에 보존되어 있습니다.

라이선스

MIT — LICENSE 참조.

eBay와 제휴, 보증, 후원 관계가 아닙니다. eBay API 사용은 eBay API License Agreement의 적용을 받습니다.