xianyu-buyer-mcp

闲鱼(Goofish) 구매자 측 가격 문의 MCP Server. 상품 검색, 대량 문의 메시지 전송, 판매자 응답 자동 수집 기능을 지원합니다.

기능

Related MCP server: Goofish MCP Server

설치

사전 준비

• Python 3.11+

• 闲鱼/淘宝 앱 (QR 코드 로그인용)

• 闲鱼 웹 버전/淘宝 데스크톱 버전 (메시지 수신 및 응답용)

절차

# 1. 克隆项目
git clone https://github.com/<your-username>/xianyu-buyer-mcp.git
cd xianyu-buyer-mcp

# 2. 安装依赖
pip install -e .

# 3. 安装 Chromium 浏览器
playwright install chromium

선택 설정

환경 변수 템플릿을 복사하고 필요에 따라 수정하세요:

cp .env.example .env

MCP 클라이언트에서 사용

Claude Desktop / Cursor / QoderWork

MCP 구성 파일에 추가하세요:

{
  "mcpServers": {
    "xianyu-buyer": {
      "command": "python",
      "args": ["/path/to/xianyu-buyer-mcp/server.py"]
    }
  }
}

최초 사용

1. AI 어시스턴트에서 login 도구 호출

2. 브라우저 창에 闲鱼 로그인 페이지가 자동으로 열립니다.

3. 闲鱼 또는 淘宝 앱으로 QR 코드 로그인

4. 쿠키가 ~/.xianyu-buyer-mcp/cookies.json에 자동 저장됩니다.

5. 이후에는 QR 코드 로그인을 반복할 필요가 없습니다.

일반적인 절차

# 1. 登录
login()

# 2. 搜索商品
search("MacBook Pro M1 16G 512G", max_price=5000)

# 3. 批量询价
batch_send_inquiry(
  items='[{"itemId": "xxx", "sellerId": "yyy"}, ...]',
  message="你好，还在吗？"
)

# 4. 查看回复
get_conversations()

# 5. 查看某个对话详情
get_conversation_detail(item_id="xxx", seller_id="yyy")

기술 세부 사항

• 탐지 방지: playwright-stealth + 커스텀 UA + navigator 위장을 사용해 봇으로 식별되는 위험을 낮춥니다.

• CAPTCHA 우회: 판매자 정보 조회는 IM 페이지의 lib.mtop.request SDK를 통해 완료되므로 상품 상세 페이지에서 슬라이더 검증이 발생하지 않습니다.

• 호출 빈도 제어: 대량 메시지 전송 간격을 2초로 유지하여 플랫폼의 리스크 관리가 실행되지 않도록 합니다.

• 스레드 안전: 모든 브라우저 작업은 단일 스레드 실행기에서 직렬화되어 실행됩니다.

참고 사항

• 闲鱼에는 크롤링 방지 메커니즘이 있으므로 잦은 호출이나 대규모 데이터 수집에 사용하지 마세요.

• 쿠키의 유효 기간이 제한되어 있으므로 만료된 후에는 다시 QR 코드 로그인이 필요합니다.

• 이 프로젝트는 학습 및 연구 목적으로만 제공되며 闲鱼 플랫폼의 이용 약관을 준수하시기 바랍니다.

라이센스igital MIT