Secondhand MCP

Model Context Protocol(MCP) 서버로, AI 어시스턴트가 중고 마켓플레이스를 검색할 수 있게 해줍니다. Facebook Marketplace, eBay, Depop, Poshmark에서 중고 아이템을 검색하고 — 가격, 카테고리, 상태, 사이즈, 색상으로 필터링한 후 사진, 설명, 판매자 정보가 포함된 전체 목록 세부 정보를 확인하세요.

Claude Desktop, Claude Code, Cursor 및 모든 MCP 호환 클라이언트에서 작동합니다.

[!TIP] 설정을 건너뛰고 싶으신가요? Secondhand MCP Cloud를 사용해 보세요 — 30초 만에 Claude.ai 및 ChatGPT에 연결되는 호스팅 버전입니다. 설치나 Chrome이 필요 없습니다. 무료 티어 포함.

지원되는 마켓플레이스

Related MCP server: BopMarket MCP Server

설정

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "secondhand": {
      "command": "npx",
      "args": ["-y", "secondhand-mcp"],
      "env": {
        "EBAY_CLIENT_ID": "your-ebay-client-id",
        "EBAY_CLIENT_SECRET": "your-ebay-client-secret",
        "EBAY_MARKETPLACE_ID": "EBAY_US"
      }
    }
  }
}

Claude Code

~/.claude/.mcp.json에 추가:

{
  "mcpServers": {
    "secondhand": {
      "command": "npx",
      "args": ["-y", "secondhand-mcp"],
      "env": {
        "EBAY_CLIENT_ID": "your-ebay-client-id",
        "EBAY_CLIENT_SECRET": "your-ebay-client-secret",
        "EBAY_MARKETPLACE_ID": "EBAY_US"
      }
    }
  }
}

eBay, Depop, Poshmark는 모두 선택 사항입니다 — eBay API 키가 없거나 Chrome이 설치되지 않은 경우 해당 마켓플레이스는 자동으로 비활성화되고 나머지는 계속 작동합니다.

Depop 및 Poshmark / Chrome 요구 사항

Depop과 Poshmark는 헤드리스 브라우저가 필요합니다. 시스템에 Google Chrome 또는 Chromium이 설치되어 있으면 둘 다 자동으로 활성화되며 설정이 필요 없습니다. Chrome이 없으면 자동으로 건너뜁니다.

macOS에서 Depop이나 Poshmark를 처음 검색할 때 Node.js가 Chrome을 제어하도록 허용하라는 시스템 프롬프트가 나타날 수 있습니다. 이는 정상적인 현상입니다 — puppeteer가 Chrome을 헤드리스 모드로 실행해야 하기 때문입니다. 한 번 허용하면 다시 묻지 않습니다.

브라우저는 백그라운드에서 보이지 않게 실행되며 Depop이나 Poshmark를 실제로 검색할 때만 실행됩니다.

구성

마켓플레이스 선택

기본적으로 모든 마켓플레이스가 활성화됩니다. 활성화할 마켓플레이스를 제한하려면 MARKETPLACES 환경 변수를 설정하세요(쉼표로 구분):

{
  "env": {
    "MARKETPLACES": "facebook,ebay"
  }
}

유효한 값: facebook, ebay, depop, poshmark

eBay API 키

eBay는 공식 Browse API를 사용합니다. 무료 eBay 개발자 계정이 필요합니다:

1. developer.ebay.com에서 계정 생성

2. 애플리케이션을 만들어 Client ID와 Client Secret 받기

3. MCP 구성에 EBAY_CLIENT_ID 및 EBAY_CLIENT_SECRET으로 추가

eBay 마켓플레이스 / 지역

기본적으로 서버는 미국 eBay 사이트를 대상으로 합니다. 다른 지역 마켓플레이스를 검색하려면 EBAY_MARKETPLACE_ID 환경 변수를 설정하세요:

{
  "env": {
    "EBAY_MARKETPLACE_ID": "EBAY_DE"
  }
}

일반적인 값:

전체 목록은 eBay API 문서에서 확인할 수 있습니다.

도구

search_marketplace

마켓플레이스에서 아이템을 검색합니다.

마켓플레이스별 반환 데이터:

get_listing_details

검색 결과의 ID를 사용하여 특정 목록의 전체 세부 정보를 가져옵니다.

마켓플레이스별 반환 데이터:

list_marketplaces

활성화된 모든 마켓플레이스와 그 상태를 나열합니다.

search / fetch (심층 연구)

ChatGPT Deep Research tool contract를 따르는 편의 쌍 — 정확한 이름, 각각 단일 문자열 인수:

• search(query) — 활성화된 모든 마켓플레이스를 한 번에 검색하고 { results: [{ id, title, text, url }] }를 반환합니다. 여기서 id는 marketplace:listingId입니다.

• fetch(id) — search 결과 ID에 대한 전체 목록 세부 정보를 { id, title, text, url, metadata }로 반환합니다.

이러한 표준 도구 이름을 기대하는 연구 스타일 클라이언트에 유용합니다. 필터링된 검색에는 search_marketplace를 사용하세요.

작동 방식

Facebook Marketplace — 위치, 가격, 검색어로 목록을 검색합니다. 도시 이름을 좌표로 변환합니다. 로그인이나 브라우저가 필요 없습니다.

eBay — OAuth 2.0 클라이언트 자격 증명으로 공식 eBay Browse API를 사용합니다. 토큰은 캐시되고 자동으로 갱신됩니다. 대상 지역 마켓플레이스는 EBAY_MARKETPLACE_ID로 제어됩니다(기본값: EBAY_US).

Depop — 헤드리스 브라우저를 사용하여 카테고리, 상태, 사이즈, 색상 필터를 지원하는 목록을 검색합니다. 브라우저 인스턴스는 요청 간에 공유됩니다.

Poshmark — 헤드리스 브라우저를 사용하여 상태, 사이즈, 색상, 정렬, 가격 필터를 지원하는 목록을 검색합니다. Poshmark는 위치 기반이 아닙니다 — 모든 아이템은 전국으로 배송됩니다.

개발

git clone https://github.com/jlsookiki/secondhand-mcp.git
cd secondhand-mcp
npm install
npm run build

마켓플레이스 추가

1. src/marketplaces/에 새 파일 생성

2. BaseMarketplace를 확장하고 search() 및 선택적으로 getListingDetails() 구현

3. src/marketplaces/index.ts의 allMarketplaces에 생성자 추가

제한 사항

• Facebook: Facebook이 프론트엔드를 변경하면 작동이 중단될 수 있음

• eBay: 개발자 API 키 필요 (무료 티어 사용 가능)

• Depop: Chrome/Chromium 설치 필요; Facebook/eBay보다 느림 (검색당 약 5초)

• Poshmark: Chrome/Chromium 설치 필요; 공식 API가 없어 페이지 스크래핑에 의존

• 속도 제한: 너무 많은 요청을 너무 빠르게 보내지 마세요

License

MIT