wow-site

wow-site は、https://wow.batserver.au で公開されている個人用 World of Warcraft ファンサイトです。フレームワークやビルドステップを使わず、手書きの HTML、CSS、JavaScript に加え、Blizzard のキャラクター装備 API 用の依存関係のない小さな Node サーバーを使用しています。

目次

• site/index.html — ランディングページとツールインデックス

• site/gear-advisor.html — 装備アドバイザーツール

• site/styles.css — 共有サイトテーマ

• site/gear-advisor.css / site/gear-advisor.js — 装備アドバイザーのみ

• site/season-data.js — 共有シーズントラックと Blizzard ボーナス ID マッピング

• site/assets/ — ファビコンと画像

• server.mjs — 静的配信、Blizzard API アダプター、インメモリキャッシュ

• mcp_server.py — 同じキャラクター API をバックエンドとする公式 SDK v2 MCP サーフェス

• Dockerfile.mcp / requirements-mcp.txt — 分離された MCP サイドカーイメージ

• test/ — Node の組み込みテストスイート

Related MCP server: wow-mcp

ツール

装備アドバイザー

シーズンの装備アップグレードトラックとあなたのアイテムレベルを比較します。スライダーを動かすと、各ランクがアップグレード、横並び、またはダウングレードとして色分けされます。各トラックは、あなたを上回る最初のランクと、それに必要な紋章のコストを報告します。

シーズン番号と Blizzard のアップグレードボーナス ID はパッチ固有であり、site/season-data.js の一箇所にまとめられています。

キャラクター検索は、Blizzard のサーバー間クライアント認証フローを使用します。キャラクター装備はメモリに5分間キャッシュされます。同じキャラクターへの同時リクエストは統合され、今すぐ更新 は1分間のクールダウン後に通常のキャッシュをバイパスできます。Blizzard のメディアレスポンスと OAuth トークンには、それぞれより長い有効期限のキャッシュがあります。地域固有のレルムドロップダウンは Blizzard の Realm Index API から取得され、1日間キャッシュされます。セレクターは安全なプレースホルダーと短い便利なオプションリストで始まり、ブラウザのアイドル時間中にデータを入力し、取得したリストと訪問者の最後の地域選択をブラウザストレージに保持して、次回のアクセス時にすぐに利用できるようにします。

現在のシーズン2トラックは、アイテムレベルから推測するのではなく、Blizzard のアイテム bonus_list から解決されます。既知の現在シーズンボーナスがないアイテムは、レガシー/不明として表示され、特別なアセンダントアイテムは明示的な特別状態になります。その由来とは関係なく、装備されている各スロットは、そのアイテムレベルを各シーズン2トラックと比較し、そのトラックで厳密なアイテムレベルアップグレードとなる最初のランクを表示します。この詳細な比較は各アイテムカードで個別に折りたたまれ、現在のパスの概要が主要なビューとして残ります。

MCP v2

/mcp にある公開 Streamable HTTP エンドポイントは、公式 Python SDK v2 を使用し、5つの読み取り専用の構造化ツールを公開します。

• get_character_equipment は、サイトで使用されるものと同じキャラクター、アイテム、現在のパス、置き換えしきい値、取得時間、キャッシュデータを返します。

• get_character_talents は、アクティブなスペシャライゼーション、ヒーローツリー、現在のクラス/スペック/ヒーロータレントの選択、およびゲーム内インポートコードを返します。

• get_character_profile は、アイテムレベル、実績ポイント、現在のシーズンの Mythic+ レーティング、ベストランなど、コンパクトなアイデンティティと進行状況のコンテキストを返します。

• get_character_achievements は、完了数、ポイント、および最大25件の最近の実績を返します。数千件のエントリからなる完全な履歴は送信しません。

• list_realms は、エージェントが検索入力を検証できるように、地域の Blizzard レルム ID、表示名、スラッグを返します。

すべてのツールは既存の内部 JSON API を呼び出すため、その1分あたり60リクエストの呼び出し元制限、5分間のキャラクターキャッシュ、1日間のレルムキャッシュ、リクエスト統合、および強制更新クールダウンを共有します。検証、アップストリーム、レート制限エラーを含むすべてのツール呼び出しは、構造化 JSON としてコンテナログと /data/queries.jsonl に書き込まれます。監査レコードには、クエリ、結果、期間、キャッシュステータス、プロトコル/クライアントメタデータ、および呼び出し元アドレスが含まれます。Blizzard の認証情報やアクセストークンが含まれることはありません。永続ファイルは、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 はクロールを禁止しています。