steam-trading-card-helper

Steam Trading Card Helper는 Steam 커뮤니티를 위한 Tampermonkey 사용자 스크립트입니다. Steam 카드 가격 스캔, 배지 비용 추정, 구매 지원, 장기 주문 관리, 대량 배지 합성, 잉여 커뮤니티 아이템 처리에 사용됩니다. 이 스크립트는 Valve나 Steam의 공식 제품이 아니며, 사용자는 자신의 위험을 감수해야 합니다. 설치 후, 사용자는 자신의 Steam 배지 페이지에서 스크립트를 열 수 있습니다. 인터페이스에는 가격 스캔, 주문 카드, 주문서, 가격 추세, 배지 합성, 블랙리스트, 잉여 아이템, 아이템 수집, 설정 등의 페이지가 포함되어 있습니다. 가격 스캔은 일반 또는 반짝이는 카드 배지, 남은 드롭, 보유 수량, 카드 가격, 한 세트 및 최대 레벨 비용을 스캔할 수 있습니다. 스캔 결과는 주문 카드에 저장하거나, AppID를 수동으로 추가하고 재계산할 수 있습니다. 주문서 페이지에서는 기존 주문, 남은 수량, 점유 금액, 최저 판매 가격을 확인하고, 대량 취소를 지원합니다. 가격 데이터는 우선적으로 Steam Market listing 상품 페이지에서 읽어와 현재 주문 책과 최근 거래 기록을 한 번에 가져옵니다. 필요한 필드가 누락된 경우에만 priceoverview로 되돌아갑니다. 모든 priceoverview 요청은 분당 20회 제한을 공유합니다. 가격 방식에는 판매 최저가, 평균 가격, 구매 최고가가 있습니다. 가격이 누락된 경우 0원으로 계산하지 않고, 통화가 일치하지 않거나 응답이 손상되거나 요청이 실패하면 가격이 누락된 상태로 유지됩니다. 비용 추정은 스캔 시 이미 가져온 데이터만 사용하며, 가격 방식 전환이나 결과 체크박스 선택으로 인해 추가 요청이 전송되지 않습니다. 추정 항목에는 보충 총가, 풀 세트 총가, 최대 레벨 총가가 포함됩니다. 상단 총가는 선택된 항목만 합산하며, 선택된 게임 중 하나라도 가격이 누락된 경우 합계는 "-"로 표시됩니다. 수동 모드에서는 추정에 구매 가격 조정이 추가되며, 현재 통화의 시장 최저가보다 낮지 않도록 보장합니다. 스마트 가격 책정 모드는 선택된 전략의 무벽 조정 값을 사용합니다. 구매 수량 논리는 한 세트 보충, 5레벨까지 보충, 한 세트 구매, 5세트 구매를 지원합니다. 장기 주문서는 기준점으로 판매 최저가, 평균 가격, 구매 최고가를 선택하고, 구매 가격 조정을 적용할 수 있습니다. 스마트 가격 책정은 장기 주문서에만 사용되며, 전체 구매 주문 깊이를 읽어 상단 고립 고가와 최근 주문 벽을 식별한 후, 보수적, 균형, 급구매 전략에 따라 가격을 선택합니다. 최종 가격은 시장 최저가보다 낮지 않으며, 최저 판매 가격이 있는 경우 최저 판매 가격에서 0.01을 뺀 값보다 높지 않습니다. 스캔 및 필터링은 일반 카드와 반짝이는 카드, 최대 배지 페이지 수, 여전히 드롭이 있는 게임 포함 여부를 지원합니다. 한 세트 가격이 상한을 초과하면 건너뜁니다. 사전 예측은 소수의 유효 샘플이 이미 명확하게 상한을 초과한 경우 후속 요청을 줄입니다. 스캔 결과는 주문 카드에 캐시할 수 있으며, 자동 블랙리스트는 완전한 가격 조회 또는 사전 예측 결과를 기록합니다. 고정 블랙리스트는 만료되어도 삭제되지 않습니다. 최대 레벨 추정 색상은 최근 거래량 상황을 구분하는 데 사용됩니다. 배지 합성은 이미 모은 카드 세트를 스캔하여 블랙리스트 게임을 제외하고, 단계별 업그레이드 또는 한 번에 최대 레벨까지 업그레이드를 지원합니다. 또한, 항목별로 횟수를 입력하거나 모두 1, 최대, 0으로 설정할 수 있으며, 제출 전에 확인이 필요합니다. 잉여 아이템 기능은 목표 배지 레벨에 따라 여전히 필요한 세트 수를 예약한 후, 실제로 잉여인 수량을 나열합니다. 배경과 이모티콘은 기본 보유 수량을 설정하고, 포인트 상점 아이템을 포함할지 여부를 선택할 수 있습니다. 추천은 시장 판매 후 세금 금액과 보석으로 분해한 후의 세금 후 가치를 비교하며, 실제 판매와 분해는 항상 확인 후 직렬로 제출됩니다. 아이템 수집은 특정 아이템을 보호하여 판매 또는 분해 후보에 포함되지 않도록 합니다. 동시성 설정에서 HTML 클래스 요청 동시성은 기본적으로 꺼져 있고, 동시성 수는 4입니다. 다른 요청 동시성은 기본적으로 켜져 있고, 동시성 수는 8입니다. 동시성 수는 1~20으로 설정할 수 있습니다. 페이지 읽기와 주문, 취소, 판매, 분해, 합성 등의 쓰기 작업은 병렬로 수행되지 않습니다. 보석 가방 가격은 플러그인을 열 때마다 자동으로 한 번 읽어오며, 사용자가 새로 고침을 클릭하면 강제로 다시 읽어옵니다. 개인화는 상단 탭의 순서를 드래그하여 조정하고, 각 탭에 6자리 HEX 라벨 색상을 설정하며, 로그 영역 높이를 조정하고, JSON 데이터를 익스포트 또는 임포트할 수 있습니다. 임포트 실패 시 원본 데이터를 복구하려고 시도합니다. 백업에는 Steam 로그인 상태가 포함되지 않습니다. 사용 시 주의 사항으로는 시장 가격, 주문 깊이, 재고가 언제든지 변할 수 있으며, 추정치는 최종 거래 금액과 같지 않다는 점입니다. 연속적인 요청 실패나 429 오류가 발생하면 동시성 수를 줄이거나 일시 중지한 후 다시 시도해야 합니다. 주문, 취소, 판매, 분해, 합성 전에 확인 창을 검사해야 하며, 분해는 되돌릴 수 없고, 판매는 Steam 모바일 확인이 필요할 수 있습니다. 개발 측면에서 npm test는 자동화된 테스트를 실행하고, npm run build는 사용자 스크립트를 생성하며, npm run check는 테스트를 실행하고 다시 빌드합니다. 프로젝트는 MIT 라이선스를 따릅니다.