wehub-resource-sync
9b395f5cc3
E2E Headed Chrome / e2e-headed (macos-15) (push) Has been cancelled
E2E Headed Chrome / e2e-headed (ubuntu-latest) (push) Has been cancelled
E2E Headed Chrome / e2e-headed (windows-latest) (push) Has been cancelled
CI / build (macos-latest) (push) Has been cancelled
CI / build (ubuntu-latest) (push) Has been cancelled
CI / build (windows-latest) (push) Has been cancelled
CI / unit-test (push) Has been cancelled
CI / bun-test (push) Has been cancelled
CI / adapter-test (push) Has been cancelled
CI / smoke-test (macos-latest) (push) Has been cancelled
CI / smoke-test (ubuntu-latest) (push) Has been cancelled
Security Audit / audit (push) Has been cancelled
Build Chrome Extension / build (push) Has been cancelled
Trigger Website Rebuild (Docs Updated) / dispatch (push) Has been cancelled
88 lines
3.8 KiB
Markdown
88 lines
3.8 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
# 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](/guide/browser-bridge)
|
|
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` |
|