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'

wow

Safety Notice

Copy this and send it to your AI assistant to learn