Product Info Extractor Server

🇰🇷 한국어 | 🇺🇸 English

이커머스 웹사이트에서 상품 정보(가격, 재고, 이미지, 색상별 사이즈 등)를 자동으로 추출하는 MCP 서버입니다.

⚠️ 중요: DataDome 같은 고급 봇 차단 시스템은 자동 접근을 차단할 수 있습니다. 성공률은 대상 사이트와 네트워크 환경에 따라 다릅니다.

🚀 빠른 시작 (30초)

Docker로 실행 (권장)

# 저장소 클론
git clone https://github.com/elon-jang/product-info-extractor-mcp.git
cd product-info-extractor-mcp

# 서버 시작
docker compose up -d

# 테스트
npm install
node test-mcp-http.js "https://www.ugg.com/women-slippers/cozy-slipper/1117659.html"

로컬 개발 모드

npm install
npx playwright install chromium
npm run start:http

---

📋 주요 기능

• ⚡ 초고속: 8-10초 응답 (DataDome 우회 로직 제거로 6배 성능 향상)
• 🚀 고성능: 브라우저 인스턴스 재사용으로 후속 요청 즉시 처리
• 🥷 스텔스 모드: playwright-extra + puppeteer-extra-plugin-stealth로 기본 봇 탐지 우회
• 🔌 MCP 프로토콜: Claude Desktop과 바로 연동 가능
• 📦 멀티 플랫폼: AMD64 + ARM64 (Apple Silicon & 클라우드 VM) 지원

---

🐳 Docker 배포 가이드

1. Docker 설치

# Ubuntu/Debian
sudo apt-get update
sudo apt-get install -y docker.io docker-compose-plugin

# RHEL/CentOS/Rocky Linux
sudo dnf install -y yum-utils
sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo dnf install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
sudo systemctl start docker && sudo systemctl enable docker

2. 서버 실행

# Docker Compose로 실행 (권장)
docker compose up -d

# 또는 docker run으로 실행
docker run -d -p 8080:3000 \
  -e PORT=3000 -e HOST=0.0.0.0 \
  --name product-info-extractor \
  joomanba/product-info-extractor-mcp:latest

3. 상태 확인

# 컨테이너 로그 확인
docker logs -f product-info-extractor

# Health check
curl http://localhost:8080/health

---

🧪 테스트

Node.js 테스트 클라이언트

npm install
node test-mcp-http.js "https://www.ugg.com/women-slippers/cozy-slipper/1117659.html"

Shell 스크립트 (간단한 연결 테스트)

./test-server.sh http://localhost:8080

---

🔧 Claude Desktop 연동

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "product-info-extractor": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:8080/sse"]
    }
  }
}

---

⚠️ 제한 사항

봇 차단 시스템

다음 시스템들은 자동 접근을 차단할 수 있습니다:

• DataDome (UGG.com 사용): 성공률이 환경에 따라 변동
• Cloudflare Advanced: 추가 우회 기법 필요
• PerimeterX: 우회 매우 어려움

권장 사항

✅ 프로덕션 전 충분한 테스트 ✅ 가능하면 공식 API 사용 ✅ 재시도 로직 및 에러 처리 구현 ✅ 성공률 모니터링

---

📚 고급 가이드

Podman 환경 (RHEL/CentOS)

# Podman 설치
sudo dnf install -y podman

# 실행
podman run -d -p 8080:3000 \
  -e PORT=3000 -e HOST=0.0.0.0 \
  --name product-info-extractor \
  docker.io/joomanba/product-info-extractor-mcp:latest

수동 설치 (Docker 없이)

# Node.js v18+ 설치
curl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash -
sudo dnf install -y nodejs

# Playwright 의존성
sudo npx playwright install-deps

# 프로젝트 설정
npm install
npx playwright install chromium

# 서버 시작
npm run start:http

이미지 빌드 (개발자용)

docker buildx build --platform linux/amd64,linux/arm64 \
  -t joomanba/product-info-extractor-mcp:latest --push .

---

📄 라이선스

MIT License