✓ Verified 💻 Development ✓ Enhanced Data

Wow

Look up World of Warcraft characters — M+ scores, best runs, raid progression, gear.

Rating: 4.3 (265 reviews)
Downloads: 4,162 downloads
Version: 1.0.0

Overview

Look up World of Warcraft characters — M+ scores, best runs, raid progression, gear.

Complete Documentation

View Source →

World of Warcraft

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

Quick Start

bash

# 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.

bash

# 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:

bash

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

M+ Affixes

bash

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

Top M+ Runs

bash

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

bash

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

bash

# 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

bash

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

Configuration

bash

# 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:

bash

# 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:

bash

# "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'

Installation

Terminal bash


openclaw install wow

Copied!

💻Code Examples

wow top-runs

wow-top-runs.txt

## Character Lookup

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

wow lookup <name>-<realm> --raw

wow-lookup-name-realm---raw.txt

**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 raids # List current raids and boss counts

wow-raids--list-current-raids-and-boss-counts.txt

## 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

wow armory <name>-<realm>

wow-armory-name-realm.txt

### 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

wow config

wow-config.txt

### 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`:

WCL_CLIENT_SECRET=your_secret

wclclientsecretyoursecret.txt

## 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:

example.sh

# 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

example.sh

# 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

example.sh

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

example.sh

# 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