TOOL / ANALYTICS
Royale API
Clash Royaleの対戦履歴を自動収集し、使用デッキ別の勝率や対戦相手アーキタイプとの相性を分析するWebアプリです。プレイヤータグを検索すると、その場から戦績の蓄積が始まります。
- 取得間隔5分ごと（Cron）
- 保存件数無料プランは直近1,000戦
- 構成Cloudflare Workers + D1
どんなツールか
プレイヤータグを検索すると初回検索時刻から戦績の蓄積が始まり、以後5分おきのCronが公式APIのバトルログを取得してD1に保存します。蓄積されたログから「デッキ別勝率」「対戦相手アーキタイプ別勝率」「デッキ×相手の相性」を集計してWeb UIに表示します。
作りかた
Cloudflare Workers（Hono）とD1（SQLite）上で完結する構成です。公式APIはIPホワイトリスト制限があるため、RoyaleAPIが提供する許諾プロキシを経由してアクセスしています。
使い方
- 検索欄にプレイヤータグ（例: #2PP0LYQ）を入力します。
- 初めて検索したタグは、その時点から戦績の記録が始まります（過去分までは遡れません）。
- プレイヤー情報、保存枠、対戦履歴を期間・モードで絞り込んだサマリーが表示されます。
制限事項
無料プランは直近1,000戦までの保存で、上限に達すると新規分の取り込みが止まります（Proプランは無制限）。最終検索から30日間アクセスがないタグは自動的に取得が停止し、再検索すると復帰します。公式APIのバトルログは常に直近25件までしか返らないため、対戦頻度が非常に高いプレイヤーは一部の対戦を取りこぼす可能性があります。
データの扱い
保存されるのは検索されたプレイヤータグと、そのタグの公開対戦履歴・集計値のみです。氏名やメールアドレスなどの個人情報は扱いません。