jackwener--opencli/docs/adapters/browser/hltv.md

HLTV

Mode: 🌐 Browser · Domain: hltv.org

The HLTV adapter reads visible CS2/CS:GO stats pages through the Browser Bridge. HLTV does not expose a stable public JSON API for these views, so the commands parse search results, player stats, match mapstats, team stats, and series pages from the rendered DOM.

Commands

Command	Description
opencli hltv search <query>	Search players, teams, events, and articles
opencli hltv player-summary	Read a player's summary page and complete stats link
opencli hltv player-matches	Read a player's stats Matches tab
opencli hltv player-form	Aggregate recent player maps by summary, map, and opponent
opencli hltv player-map-pool	Aggregate a player's recent maps into map-pool buckets
opencli hltv player-vs-team <team>	Filter a player's maps against one team
opencli hltv player-teammate-impact <playerA> <playerB>	Compare shared and non-shared map samples for two teammates
opencli hltv player-duel <playerA> <playerB>	Compare two players on shared maps, including direct kills when available
opencli hltv match-map <match>	Read all player rows from one mapstats page
opencli hltv match-series <match>	Expand a BO1/BO3/BO5 into summary, map, and player rows
opencli hltv team-matches <team>	Read recent team map results
opencli hltv team-map-pool <team>	Read a team's visible map-pool stats
opencli hltv event-matches <event>	Read stats match rows for one event

Usage Examples

# Search and discover HLTV entity links
opencli hltv search niko --limit 5

# Read player pages and recent form
opencli hltv player-summary --player 3741/niko
opencli hltv player-matches --player 3741/niko --limit 10 -f json
opencli hltv player-form --player 19230/m0nesy --limit 30

# Compare two players
opencli hltv player-duel 3741/niko 21167/donk
opencli hltv player-duel 19230/m0nesy 3741/niko --mode history --limit 10

# Expand a series or inspect one mapstats URL
opencli hltv match-series https://www.hltv.org/stats/matches/126993/spirit-vs-falcons
opencli hltv match-map "https://www.hltv.org/stats/matches/mapstatsid/231594/falcons-vs-natus-vincere" -f json

# Team and event views
opencli hltv team-matches 6667/falcons --limit 10
opencli hltv team-map-pool 11283/falcons
opencli hltv event-matches 8301 --limit 10

Common Subjects

• Player refs accept id/slug, player URLs, and compatible stats player URLs.
• Team refs accept id/slug, team URLs, and compatible stats team URLs.
• Match refs accept normal match URLs, stats series URLs, and mapstats URLs where supported.
• Event refs accept event IDs, /events/:id/:slug URLs, and stats URLs with an event= query parameter.

Prerequisites

• Chrome running with the Browser Bridge extension installed
• HLTV accessible in the active browser session
• If HLTV shows a Cloudflare or human-verification page, complete it in Chrome before retrying the command

Notes

• The adapter is read-only and does not require HLTV login.
• Heavy match or duel commands may load multiple HLTV pages and can take longer than search or summary commands.
• Use --window foreground --keep-tab true when debugging HLTV page structure or Cloudflare interruptions.
• Primary subjects use positional arguments; filters such as --limit, --period, --ranking, --map, and --version remain named options.

Error Behaviour

Condition	Error
Invalid player, team, event, match, limit, offset, or filter argument	ArgumentError
Visible HLTV page contains no rows for the requested subject/filter	EmptyResultError
HLTV page structure changed or parser returns an unexpected shape	CommandExecutionError
Browser navigation or selector wait exceeds the command timeout	TimeoutError