{"skill":{"slug":"wow","displayName":"WoW Lookup","summary":"Look up World of Warcraft characters — M+ scores, best runs, raid progression, gear, and more. Uses Raider.io (free), with optional Blizzard API and Warcraft...","description":"---\nname: wow\ndescription: \"Look up World of Warcraft characters — M+ scores, best runs, raid progression, gear, and more. Uses Raider.io (free), with optional Blizzard API and Warcraft Logs integration for armory data and raid parses.\"\nmetadata:\n  openclaw:\n    emoji: \"⚔️\"\n    requires:\n      bins: [\"curl\", \"jq\"]\n      env_optional: [\"BLIZZARD_CLIENT_ID\", \"BLIZZARD_CLIENT_SECRET\", \"WCL_CLIENT_ID\", \"WCL_CLIENT_SECRET\"]\n    install:\n      - id: symlink\n        kind: shell\n        command: \"ln -sf $(pwd)/wow /usr/local/bin/wow\"\n        label: \"Install wow CLI (symlink)\"\n---\n\n# World of Warcraft\n\nLook up WoW characters, M+ scores, raid progression, and more.\n\n## Quick Start\n\n```bash\n# Full character profile — M+ score, best runs, raid progression\nwow lookup <name>-<realm>\nwow lookup azunazx-hyjal\n\n# Quick one-line summary\nwow search azunazx-hyjal\n\n# Current M+ affixes\nwow affixes\n\n# Top M+ runs this season\nwow top-runs\n```\n\n## Character Lookup\n\nThe primary command. Shows M+ score, best runs, raid progression, and gear.\n\n```bash\n# Default region is US\nwow lookup <name>-<realm>\n\n# EU character\nwow lookup <name>-<realm> -r eu\n\n# Include recent runs\nwow lookup <name>-<realm> --recent\n\n# Raw JSON output (for programmatic use)\nwow lookup <name>-<realm> --raw\n```\n\n**Output includes:**\n- Character info (name, class, spec, race, faction, realm)\n- Mythic+ score (overall + per-role breakdown)\n- Best M+ runs (dungeon, key level, time, score)\n- Raid progression (Normal/Heroic/Mythic kills per raid)\n- Equipped item level\n\n## Quick Search\n\nOne-line character summary for quick lookups:\n\n```bash\nwow search azunazx-hyjal\n# → Azunazx | Fire Mage | Hyjal [US] | Alliance | M+ Score: 4002.6\n```\n\n## M+ Affixes\n\n```bash\nwow affixes           # US affixes\nwow affixes -r eu     # EU affixes\n```\n\n## Top M+ Runs\n\n```bash\nwow top-runs              # Top runs in US\nwow top-runs -r eu        # Top runs in EU\nwow top-runs --page 1     # Page through results\n```\n\n## Raid Info\n\n```bash\nwow raids           # List current raids and boss counts\n```\n\n## API Sources\n\n### Raider.io (Active — No Auth Required)\n- ✅ Character profiles, M+ scores, best/recent runs\n- ✅ Raid progression summary\n- ✅ Current affixes\n- ✅ Top M+ runs / rankings\n- ✅ Gear / item level\n- Free, no rate limit issues for normal use\n\n### Blizzard API (Optional — OAuth2 Required)\n- Armory data: detailed gear, stats, achievements\n- M+ rating (Blizzard's own rating system)\n- Character media (renders)\n- Requires `BLIZZARD_CLIENT_ID` and `BLIZZARD_CLIENT_SECRET`\n- Register at: https://develop.battle.net/access/clients\n\n```bash\n# When configured:\nwow armory <name>-<realm>\n```\n\n### Warcraft Logs API v2 (Optional — OAuth2 Required)\n- Raid parses and percentiles\n- Damage/healing breakdowns per encounter\n- Character rankings across difficulties\n- GraphQL API\n- Requires `WCL_CLIENT_ID` and `WCL_CLIENT_SECRET`\n- Register at: https://www.warcraftlogs.com/api/clients\n\n```bash\n# When configured:\nwow parses <name>-<realm>\n```\n\n## Configuration\n\n```bash\n# Check what's configured\nwow config\n```\n\n### Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `WOW_REGION` | No | Default region: `us`, `eu`, `kr`, `tw` (default: `us`) |\n| `WOW_CONFIG` | No | Config file path (default: `~/.config/wow/config.env`) |\n| `BLIZZARD_CLIENT_ID` | No | Blizzard API client ID |\n| `BLIZZARD_CLIENT_SECRET` | No | Blizzard API client secret |\n| `WCL_CLIENT_ID` | No | Warcraft Logs client ID |\n| `WCL_CLIENT_SECRET` | No | Warcraft Logs client secret |\n\n### Config File\n\nCreate `~/.config/wow/config.env`:\n\n```bash\n# Defaults\nWOW_REGION=us\n\n# Blizzard API (https://develop.battle.net/access/clients)\nBLIZZARD_CLIENT_ID=your_id\nBLIZZARD_CLIENT_SECRET=your_secret\n\n# Warcraft Logs (https://www.warcraftlogs.com/api/clients)\nWCL_CLIENT_ID=your_id\nWCL_CLIENT_SECRET=your_secret\n```\n\n## Regions\n\n| Code | Region |\n|------|--------|\n| `us` | United States & Oceania |\n| `eu` | Europe |\n| `kr` | Korea |\n| `tw` | Taiwan |\n\n## Realm Names\n\nUse hyphenated, lowercase realm names:\n- `area-52` (not \"Area 52\")\n- `moon-guard` (not \"Moon Guard\")\n- `tichondrius` (single-word realms work as-is)\n\nThe CLI auto-converts spaces to hyphens and strips apostrophes.\n\n## Examples for the Agent\n\nWhen the user asks about a WoW character:\n\n```bash\n# \"What's my M+ score?\" (if you know their character)\nwow lookup charactername-realmname\n\n# \"Look up this character on EU\"\nwow lookup charactername-realmname -r eu\n\n# \"What are the affixes this week?\"\nwow affixes\n\n# \"What are the top keys right now?\"\nwow top-runs\n\n# Quick check\nwow search charactername-realmname\n\n# Get raw data for further processing\nwow lookup charactername-realmname --raw | jq '.mythic_plus_scores_by_season[0].scores.all'\n```\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":1034,"installsAllTime":39,"installsCurrent":2,"stars":1,"versions":1},"createdAt":1771341182549,"updatedAt":1778491563795},"latestVersion":{"version":"1.0.0","createdAt":1771341182549,"changelog":"Initial publish","license":null},"metadata":{"setup":[],"os":null,"systems":null},"owner":{"handle":"tag-assistant","userId":"s17bnqhgmzxahjkwfj9rs88zgd8847d4","displayName":"Tag","image":"https://avatars.githubusercontent.com/u/260167501?v=4"},"moderation":null}