wow-site

wow-site는 https://wow.batserver.au에서 제공되는 개인 월드 오브 워크래프트 팬 사이트입니다. 프레임워크나 빌드 단계 없이 직접 작성한 HTML, CSS 및 JavaScript를 사용하며, 블리자드 캐릭터 장비 API를 위한 작은 의존성 없는 Node 서버가 포함되어 있습니다.

내용

• site/index.html — 랜딩 페이지 및 도구 색인

• site/gear-advisor.html — 장비 조언 도구

• site/styles.css — 공유 사이트 테마

• site/gear-advisor.css / site/gear-advisor.js — 장비 조언 전용

• site/season-data.js — 공유 시즌 트랙 및 블리자드 보너스 ID 매핑

• site/assets/ — 파비콘 및 이미지

• server.mjs — 정적 전송, 블리자드 API 어댑터 및 인메모리 캐시

• mcp_server.py — 동일한 캐릭터 API를 기반으로 하는 공식 SDK v2 MCP 표면

• Dockerfile.mcp / requirements-mcp.txt — 격리된 MCP 사이드카 이미지

• test/ — Node 내장 테스트 스위트

Related MCP server: wow-mcp

도구

장비 조언

시즌의 장비 업그레이드 트랙을 아이템 레벨과 비교합니다. 슬라이더를 움직이면 각 등급이 업그레이드, 사이드그레이드 또는 다운그레이드로 색상이 변경되며, 각 트랙은 당신을 능가하는 첫 번째 등급과 그에 필요한 문장 비용을 보고합니다.

시즌 번호와 블리자드 업그레이드 보너스 ID는 패치별로 다르며 한 곳인 site/season-data.js에 있습니다.

캐릭터 조회는 블리자드의 서버 간 클라이언트 자격 증명 흐름을 사용합니다. 캐릭터 장비는 5분 동안 메모리에 캐시됩니다. 동일한 캐릭터에 대한 동시 요청은 병합되며, 지금 새로고침은 1분 쿨다운 후 일반 캐시를 우회할 수 있습니다. 블리자드 미디어 응답 및 OAuth 토큰은 자체적으로 더 긴 수명의 캐시를 가집니다. 지역별 서버 드롭다운은 블리자드의 서버 색인 API에서 가져오며 1일 동안 캐시됩니다. 선택기는 안전한 플레이스홀더와 짧은 유용한 옵션 목록으로 시작하여 브라우저 유휴 시간에 채워지며, 가져온 목록과 방문자의 마지막 지역 선택을 브라우저 저장소에 보관하여 즉시 재방문 시 사용할 수 있습니다.

현재 시즌 2 트랙은 블리자드의 아이템 bonus_list에서 확인되며, 아이템 레벨에서 추론되지 않습니다. 알려진 현재 시즌 보너스가 없는 아이템은 레거시/알 수 없음으로 표시되며, 특수 승천 아이템은 명시적인 특수 상태를 얻습니다. 이 출처와 별개로, 모든 장착 슬롯은 아이템 레벨을 각 시즌 2 트랙과 비교하여 해당 트랙에서 엄격한 아이템 레벨 업그레이드가 되는 첫 번째 등급을 보여줍니다. 이 상세 비교는 각 아이템 카드에서 독립적으로 접혀 있어 현재 경로 요약이 기본 보기로 유지됩니다.

MCP v2

/mcp의 공개 Streamable HTTP 엔드포인트는 공식 Python SDK v2를 사용하며 5개의 읽기 전용 구조화된 도구를 제공합니다:

• get_character_equipment는 사이트에서 사용하는 동일한 캐릭터, 아이템, 현재 경로, 교체 임계값, 가져오기 시간 및 캐시 데이터를 반환합니다.

• get_character_talents는 활성 전문화, 영웅 트리, 현재 클래스/전문화/영웅 특성 선택 및 게임 내 가져오기 코드를 반환합니다.

• get_character_profile는 아이템 레벨, 업적 점수, 현재 시즌 신화+ 평점 및 최고 기록을 포함한 간결한 신원 및 진행 상황 컨텍스트를 반환합니다.

• get_character_achievements는 완료 총계, 점수 및 최대 25개의 최근 업적을 반환하며 수천 개 항목의 전체 기록을 내보내지 않습니다.

• list_realms는 에이전트가 조회 입력을 검증할 수 있도록 지역에 대한 블리자드 서버 ID, 표시 이름 및 슬러그를 반환합니다.

모든 도구는 기존 내부 JSON API를 호출하므로 분당 60개 요청 호출자 제한, 5분 캐릭터 캐시, 1일 서버 캐시, 요청 병합 및 강제 새로고침 쿨다운을 공유합니다. 검증, 업스트림 및 속도 제한 오류를 포함한 모든 도구 호출은 구조화된 JSON으로 컨테이너 로그 및 /data/queries.jsonl에 기록됩니다. 감사 기록에는 쿼리, 결과, 기간, 캐시 상태, 프로토콜/클라이언트 메타데이터 및 호출자 주소가 포함되며, 블리자드 자격 증명이나 액세스 토큰은 절대 포함되지 않습니다. 영구 파일은 0750 상태 디렉토리 내에 0640 모드로 생성됩니다.

로컬 실행

npm test
docker build -t wow-site .
docker run --rm --env-file /path/to/wow-site.env -p 8080:80 wow-site

그런 다음 http://localhost:8080을 엽니다.

배포

프로덕션은 인프라 리포지토리의 표준 Compose 파일인 /mnt/docker/infra/config/dockerconfigs/docker-compose.yml에 wow-site 및 wow-site-mcp 서비스로 정의됩니다. 둘 다 이 디렉토리에서 빌드되므로 전체 배포는 다음과 같습니다:

docker compose -p config -f /mnt/docker/infra/config/dockerconfigs/docker-compose.yml \
  up -d --build wow-site wow-site-mcp

Traefik은 wow.${DOMAIN_PRIMARY}를 포트 80의 사이트로 라우팅하고 경로별 /mcp 경로를 포트 8767의 MCP 사이드카에 제공합니다.

프로덕션은 ${MOUNT_STATE}/secrets/wow-site.env를 로드하며, 여기에는 다음이 포함됩니다:

BLIZZARD_CLIENT_ID=...
BLIZZARD_CLIENT_SECRET=...

선택적 조정 변수는 CHARACTER_CACHE_TTL_SECONDS (기본값 300), REFRESH_COOLDOWN_SECONDS (기본값 60), MEDIA_CACHE_TTL_SECONDS (기본값 86400), REALM_CACHE_TTL_SECONDS (기본값 86400) 및 BLIZZARD_TIMEOUT_MS (기본값 10000)입니다.

참고 사항

• 사이트는 현재 공개 상태입니다 — 인증이 없습니다. *.batserver.au는 WAN 주소로 확인되므로 여기에서 제공되는 모든 것은 인터넷에서 접근 가능합니다.

• 공개 조회는 개인 캐릭터를 저장하거나 사전 설정하지 않습니다. 영구적인 개인 캐릭터 상태는 예약된 /my/ URL 접두사 아래에 속하며, 현재는 비어 있고 나중에 인증 뒤에 배치할 수 있습니다.

• robots.txt는 크롤링을 금지합니다.