Dota 2 Stats Query Skill#

This skill uses a Python script to query Dota 2 data via the OpenDota API, focused on common player, match, hero, team, league and pro-scene workflows.

Execution#

Use the script from the installed skill directory. Do not assume the current working directory is the skill root unless it has been verified.

Claude Code#

bash

python ~/.claude/skills/dota2-stats-skill/scripts/dota2_query.py <command> [args]

OpenClaw#

bash

python ~/.openclaw/plugin-skills/dota2-stats-skill/scripts/dota2_query.py <command> [args]

When already inside this skill directory, the shorter form is also valid:

bash

python scripts/dota2_query.py <command> [args]

The script uses only the Python standard library, so no pip install is required. It needs network access to https://api.opendota.com/api and uses browser-like HTTP headers to reduce 403 risk.

Command Selection#

• Player name / 玩家名: use search <name> first, then player <account_id> and usually recent <account_id>.
• Steam64 ID / Dota 2 account ID / 玩家ID: pass it directly to player commands. The script auto-converts Steam64 IDs to 32-bit account IDs.
• Match ID / 比赛ID / 比赛详情: use match <match_id>.
• Recent matches / 最近比赛 / 近期战绩: use recent <account_id> for a quick view, or matches <account_id> --limit N for a filtered list.
• Win rate / 胜率 / 排位胜率: use wl <account_id> with filters such as --days N, --hero_id N, or ranked lobby --lobby_type 7.
• Hero usage / 常用英雄 / 英雄池: use heroes <account_id>.
• Hero counters / hero matchup / 英雄克制 / 对抗胜率: use hero_matchups <hero_id>.
• Top players for a hero / 绝活玩家 / 英雄排行榜: use hero_rankings <hero_id>.
• Pro scene / 职业比赛 / 职业选手 / 战队 / 联赛: use pro_matches, pro_players, teams, team <team_id>, or leagues.
• Live games / 实时比赛 / 正在进行: use live.
• Game constants / 常量 / 物品 / 模式 / 大厅 / 地区 / 版本: use constants <resource>.

Commands (27 total)#

Player Commands#

bash

python scripts/dota2_query.py search <name>              # Search for a player (SLOW: 1-2 min)
python scripts/dota2_query.py player <account_id>         # Player info/rank/winrate
python scripts/dota2_query.py wl <id> [--days/--hero_id/--lobby_type]  # Win/loss stats
python scripts/dota2_query.py recent <id>                 # Recent ~20 matches
python scripts/dota2_query.py matches <id> [--limit/--hero_id/--days]  # Full match history
python scripts/dota2_query.py heroes <id> [--limit N]     # Hero usage stats
python scripts/dota2_query.py peers <id> [--limit N]      # Frequent teammates
python scripts/dota2_query.py totals <id> [filters]       # Career totals (kills/assists etc)
python scripts/dota2_query.py counts <id>                 # Categorized stats
python scripts/dota2_query.py rankings <id>               # Player hero rankings
python scripts/dota2_query.py ratings <id>                # Rank history
python scripts/dota2_query.py refresh <id>                # Refresh player data

Match Commands#

bash

python scripts/dota2_query.py match <match_id>            # Single match details (10 players)

Hero Commands#

bash

python scripts/dota2_query.py hero_list                   # All heroes list
python scripts/dota2_query.py hero_stats                  # Global hero stats
python scripts/dota2_query.py hero_matchups <hero_id>     # Hero matchup winrates
python scripts/dota2_query.py hero_rankings <hero_id>     # Hero leaderboard (Top players)
python scripts/dota2_query.py benchmarks <hero_id>        # Hero performance benchmarks

Global / Pro Commands#

bash

python scripts/dota2_query.py pro_players                 # Pro players list
python scripts/dota2_query.py pro_matches [--limit N]     # Pro matches
python scripts/dota2_query.py public_matches [--min_rank] # Public matches
python scripts/dota2_query.py live                        # Live matches
python scripts/dota2_query.py teams [--limit N]           # Teams list
python scripts/dota2_query.py team <team_id>              # Team details+roster+matches
python scripts/dota2_query.py leagues                     # Leagues list
python scripts/dota2_query.py constants <resource>        # Game constants (heroes/items etc)
python scripts/dota2_query.py find_matches --teamA 1,2 --teamB 3,4  # Search by hero lineup

Common Filters#

• --days N — Last N days
• --hero_id N — Specific hero ID
• --lobby_type N — Lobby type (7=Ranked)
• --game_mode N — Game mode
• --limit N — Limit results
• --lang zh|en — Output language (default Chinese)

Usage Flow#

When user provides a player name:#

1. search <name> → Get account_id
2. player <id> → View basic info
3. recent <id> → View recent matches

Steam ID:#

The tool automatically converts 64-bit Steam IDs to 32-bit Account IDs. You can pass either format.

Rank Tier#

TierEnglish中文1Herald先锋2Guardian卫士3Crusader中军4Archon统帅5Legend传奇6Ancient万古流芳7Divine超凡入圣8Immortal冠绝一世

Notes#

1. Uses only Python standard library - no pip install required
2. Requires network access to the OpenDota API
3. Players need to have "Public Match Data" enabled
4. Built-in Chinese names for 127 heroes
5. Select the output language based on the language used in the user's question, use --lang en for English, --lang zh for Chinese
6. search command can be slow because the OpenDota search endpoint may take a while. When invoking this command, remind the user that it may take some time. If the user already knows the player's Dota 2 account ID, suggest using player <account_id> directly for faster results