World of Warcraft

Look up WoW characters, M+ scores, raid progression, and more.

Quick Start

# Full character profile — M+ score, best runs, raid progression
wow lookup <name>-<realm>
wow lookup azunazx-hyjal

# Quick one-line summary
wow search azunazx-hyjal

# Current M+ affixes
wow affixes

# Top M+ runs this season
wow top-runs

Character Lookup

The primary command. Shows M+ score, best runs, raid progression, and gear.

# Default region is US
wow lookup <name>-<realm>

# EU character
wow lookup <name>-<realm> -r eu

# Include recent runs
wow lookup <name>-<realm> --recent

# Raw JSON output (for programmatic use)
wow lookup <name>-<realm> --raw

Output includes:

• Character info (name, class, spec, race, faction, realm)
• Mythic+ score (overall + per-role breakdown)
• Best M+ runs (dungeon, key level, time, score)
• Raid progression (Normal/Heroic/Mythic kills per raid)
• Equipped item level

Quick Search

One-line character summary for quick lookups:

wow search azunazx-hyjal
# → Azunazx | Fire Mage | Hyjal [US] | Alliance | M+ Score: 4002.6

M+ Affixes

wow affixes           # US affixes
wow affixes -r eu     # EU affixes

Top M+ Runs

wow top-runs              # Top runs in US
wow top-runs -r eu        # Top runs in EU
wow top-runs --page 1     # Page through results

Raid Info

wow raids           # List current raids and boss counts

API Sources

Raider.io (Active — No Auth Required)

• ✅ Character profiles, M+ scores, best/recent runs
• ✅ Raid progression summary
• ✅ Current affixes
• ✅ Top M+ runs / rankings
• ✅ Gear / item level
• Free, no rate limit issues for normal use

Blizzard API (Optional — OAuth2 Required)

• Armory data: detailed gear, stats, achievements
• M+ rating (Blizzard's own rating system)
• Character media (renders)
• Requires BLIZZARD_CLIENT_ID and BLIZZARD_CLIENT_SECRET
• Register at: https://develop.battle.net/access/clients

# When configured:
wow armory <name>-<realm>

Warcraft Logs API v2 (Optional — OAuth2 Required)

• Raid parses and percentiles
• Damage/healing breakdowns per encounter
• Character rankings across difficulties
• GraphQL API
• Requires WCL_CLIENT_ID and WCL_CLIENT_SECRET
• Register at: https://www.warcraftlogs.com/api/clients

# When configured:
wow parses <name>-<realm>

Configuration

# Check what's configured
wow config

Environment Variables

Variable	Required	Description
WOW_REGION	No	Default region: us, eu, kr, tw (default: us)
WOW_CONFIG	No	Config file path (default: ~/.config/wow/config.env)
BLIZZARD_CLIENT_ID	No	Blizzard API client ID
BLIZZARD_CLIENT_SECRET	No	Blizzard API client secret
WCL_CLIENT_ID	No	Warcraft Logs client ID
WCL_CLIENT_SECRET	No	Warcraft Logs client secret

Config File

Create ~/.config/wow/config.env:

# Defaults
WOW_REGION=us

# Blizzard API (https://develop.battle.net/access/clients)
BLIZZARD_CLIENT_ID=your_id
BLIZZARD_CLIENT_SECRET=your_secret

# Warcraft Logs (https://www.warcraftlogs.com/api/clients)
WCL_CLIENT_ID=your_id
WCL_CLIENT_SECRET=your_secret

Regions

Code	Region
us	United States & Oceania
eu	Europe
kr	Korea
tw	Taiwan

Realm Names

Use hyphenated, lowercase realm names:

• area-52 (not "Area 52")
• moon-guard (not "Moon Guard")
• tichondrius (single-word realms work as-is)

The CLI auto-converts spaces to hyphens and strips apostrophes.

Examples for the Agent

When the user asks about a WoW character:

# "What's my M+ score?" (if you know their character)
wow lookup charactername-realmname

# "Look up this character on EU"
wow lookup charactername-realmname -r eu

# "What are the affixes this week?"
wow affixes

# "What are the top keys right now?"
wow top-runs

# Quick check
wow search charactername-realmname

# Get raw data for further processing
wow lookup charactername-realmname --raw | jq '.mythic_plus_scores_by_season[0].scores.all'