Skip to content

bright-kr/tcgplayer-price-tracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TCGplayer 가격 추적기

Bright Data TCGplayer Price Tracker Python

Bright Insights Price Tracker

실시간 TCGplayer 가격 추적 - 트레이딩 카드 게임을 위한 최대 규모의 마켓플레이스입니다. 시작하는 방법은 두 가지입니다: 완전 관리형 인텔리전스 플랫폼 또는 Bright Data의 AI Scraper Builder로 구축한 커스텀 scraper.


옵션 1: Bright Insights - AI 기반 가격 추적 (권장)

**Bright Insights**는 Bright Data의 완전 관리형 리테일 인텔리전스 플랫폼입니다. scraper를 구축할 필요도, 인프라를 유지할 필요도 없습니다. 구조화되고 분석 준비가 완료된 가격 데이터를 대시보드, 데이터 피드 또는 BI 도구로 바로 전달받을 수 있습니다.

팀이 Bright Insights를 선택하는 이유:

  • 🚀 설정 불필요 - 바로 사용할 수 있는 대시보드와 데이터 피드로 몇 분 안에 운영 시작
  • 🤖 AI 기반 추천 - 대화형 AI assistant가 수백만 개의 데이터 포인트를 즉시 실행 가능한 인사이트로 전환
  • 실시간 모니터링 - 시간 단위부터 일 단위까지의 refresh 주기와 즉시 알림(email, Slack, webhook)
  • 🌍 무제한 확장성 - 모든 웹사이트, 모든 지역, 모든 refresh 빈도 지원
  • 🔗 Plug-and-play 통합 - AWS, GCP, Databricks, Snowflake 등 지원
  • 🛡️ 완전 관리형 - Bright Data가 schema 변경, 사이트 업데이트, 데이터 품질을 자동으로 처리

주요 사용 사례:

  • ✅ TCGplayer의 디지털 게임 가격 변동 및 판매 추적
  • 기간 한정 특가 및 flash sale 모니터링
  • 지역별 가격 차이 자동 감지
  • ✅ MAP 정책 준수 모니터링 및 가격 위반 감지
  • ✅ 경쟁사 프로모션 및 프로모션 동향 추적
  • ✅ 정제되고 조화된 데이터를 동적 가격 책정 알고리즘 또는 AI 모델에 직접 공급

월 $250부터 - 맞춤 견적 받기 →


옵션 2: 직접 TCGplayer Scraper 구축하기

사전 구축된 TCGplayer scraper API가 없나요? 문제없습니다. Bright Data의 AI Scraper Builder는 몇 번의 클릭만으로 커스텀 TCGplayer scraper를 생성합니다 — 코딩이 필요 없습니다.

몇 분 만에 TCGplayer scraper 구축하기

TCGplayer AI Scraper Builder 열기 →

도메인을 선택하고, 필요한 데이터 요구사항을 설명하면, AI scraper builder가 자동으로 API를 생성합니다.

  1. 일반적인 영어로 데이터 요구사항 설명
  2. AI가 즉시 scraper API 생성
  3. 즉시 결과를 위해 API 요청 실행
  4. 필요한 경우 내장 IDE에서 코드 수정

구축이 완료되면 scraper에 Web Scraper ID (gd_xxxxxxxxxxxx)가 부여됩니다 — 아래 Setup 단계에서 사용할 수 있도록 복사해 두세요.

사전 요구사항

  • Python 3.9 이상
  • Bright Data account (무료 체험 제공)
  • Bright Data API token (발급 방법)
  • TCGplayer용 Web Scraper ID (위의 build 단계에서 생성)

Setup

  1. 이 repository 복제

    git clone https://github.com/bright-kr/tcgplayer-price-tracker.git
    cd tcgplayer-price-tracker
  2. 의존성 설치

    pip install -r requirements.txt
  3. 자격 증명 구성

    .env.example.env로 복사한 뒤 값을 입력하세요:

    cp .env.example .env
    BRIGHTDATA_API_TOKEN=your_api_token_here
    BRIGHTDATA_DATASET_ID=your_dataset_id_here

    Your Web Scraper ID AI Scraper Builder dashboard에서 Web Scraper ID를 복사해 BRIGHTDATA_DATASET_ID에 붙여 넣으세요 (형식: gd_xxxxxxxxxxxx).


사용법

TCGplayer scraper가 구축되고 Web Scraper ID가 .env에 구성되면, Python 인터페이스는 동일한 방식으로 동작합니다:

1. URL로 특정 상품 추적

구조화된 가격 데이터를 가져오기 위해 TCGplayer 상품 URL 목록을 전달하세요:

from price_tracker import track_prices

urls = [
    "https://www.tcgplayer.com/product/sample-item-123456",
    # Add more product URLs here
]

results = track_prices(urls)
for item in results:
    print(f"{item.get('title')} - {item.get('final_price', item.get('price'))} {item.get('currency', '')}")

또는 직접 실행:

python price_tracker.py

2. 키워드로 상품 검색

키워드 검색과 일치하는 상품을 찾습니다:

from price_tracker import discover_by_keyword

results = discover_by_keyword("laptop", limit=50)

3. 카테고리 URL로 상품 탐색

TCGplayer 카테고리 페이지의 모든 상품을 수집합니다:

from price_tracker import discover_by_category

results = discover_by_category(
    "https://tcgplayer.com/category/example",
    limit=100,
)

출력 필드

각 결과 레코드에는 다음 필드가 포함됩니다:

Field Description
url 상품 / listing URL
title 게임 / 상품 제목
initial_price 원래 가격
final_price 현재 가격
currency 통화 코드
discount 할인
platform 게임 플랫폼
release_date 출시일
rating 사용자 평점
in_stock 재고 여부
images 커버 이미지
description 상품 설명
timestamp 수집 타임스탬프

샘플 출력

[
  {
    "url": "https://www.tcgplayer.com/product/sample-item-123456",
    "title": "Example Product Name",
    "brand": "Example Brand",
    "initial_price": 59.99,
    "final_price": 44.99,
    "currency": "USD",
    "discount": "25%",
    "in_stock": true,
    "rating": 4.5,
    "reviews_count": 1234,
    "images": ["https://tcgplayer.com/images/product1.jpg"],
    "description": "Product description text...",
    "timestamp": "2025-01-15T10:30:00Z"
  }
]

고급 옵션

trigger_collection() 함수는 데이터 수집을 제어하기 위한 선택적 파라미터를 지원합니다:

Parameter Type Default Description
limit integer - 반환할 최대 레코드 수
include_errors boolean true 결과에 오류 보고서 포함
notify string (URL) - 스냅샷 준비 완료 시 호출할 webhook URL
format string json 출력 형식: json, csv 또는 ndjson

옵션 사용 예시:

from price_tracker import trigger_collection, get_results

inputs = [{"url": "https://www.tcgplayer.com/product/sample-item-123456"}]
snapshot_id = trigger_collection(inputs, limit=200, notify="https://your-webhook.com/hook")
results = get_results(snapshot_id)

리소스


Bright Data로 구축 - 업계를 선도하는 웹 데이터 플랫폼.

About

Tcgplayer의 가격을 추적하세요 - Bright Insights를 통한 AI 기반 또는 Bright Data의 Web Scraper API를 통한 셀프서비스

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages