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
55 lines
2.0 KiB
Markdown
55 lines
2.0 KiB
Markdown
# Steam
|
|
|
|
**Mode**: 🌐 Public · **Domain**: `store.steampowered.com`
|
|
|
|
## Commands
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `opencli steam top-sellers` | Top selling games on Steam |
|
|
| `opencli steam search <query>` | Search the Steam storefront by name keyword |
|
|
| `opencli steam app <id>` | Storefront detail for a single app id (game / DLC / package) |
|
|
|
|
## Usage Examples
|
|
|
|
```bash
|
|
# Top sellers
|
|
opencli steam top-sellers --limit 10
|
|
|
|
# Free-text search
|
|
opencli steam search "portal" --limit 5
|
|
opencli steam search "stardew" --limit 5
|
|
|
|
# App detail (round-trip from search.id)
|
|
opencli steam app 620 # Portal 2
|
|
opencli steam app 413150 # Stardew Valley
|
|
|
|
# Different storefront / currency
|
|
opencli steam search "portal" --currency cn
|
|
opencli steam app 620 --currency jp
|
|
|
|
# JSON output
|
|
opencli steam app 620 -f json
|
|
```
|
|
|
|
## Output Columns
|
|
|
|
| Command | Columns |
|
|
|---------|---------|
|
|
| `top-sellers` | (see existing top-sellers row schema) |
|
|
| `search` | `rank, id, name, price, currency, metascore, platforms, url` |
|
|
| `app` | `id, name, type, isFree, releaseDate, developers, publishers, price, currency, metacritic, recommendations, genres, categories, shortDescription, website, url` |
|
|
|
|
The `id` column on `search` round-trips into `app` — it's Steam's numeric app id (also visible in the storefront URL `store.steampowered.com/app/<id>/`).
|
|
|
|
## Notes
|
|
|
|
- `price` is the storefront's localized final price expressed as a decimal (e.g. `9.99`), not cents. The accompanying `currency` column gives the ISO code.
|
|
- `--currency` is a Steam country code (`us`, `cn`, `jp`, `de`, ...). It controls both pricing and regional availability — some apps return `success: false` outside their licensed regions; the adapter raises `EmptyResultError` with a hint when that happens.
|
|
- `metascore` / `metacritic` are returned only when Steam has a Metacritic mapping; otherwise they are `null`.
|
|
- HTML entities in `name` and `shortDescription` are decoded (e.g. `"` → `"`).
|
|
|
|
## Prerequisites
|
|
|
|
- No login required (public APIs `/api/storesearch/` and `/api/appdetails`).
|