pp-steam-web

Original：🇺🇸 English

Translated

Steam player and game lookup via the Steam Web API. Look up player profiles, owned games, recent playtime, achievements, stats, badges, friend lists, VAC/game ban status, and game schemas. Use when the user asks about their Steam library, a friend's achievements, who's playing a game, compare two players' stats, a player's Steam level or badges, VAC status, or wants to resolve a vanity URL to a Steam ID.

3installs

Sourcemvanhorn/printing-press-library

Added on2026-05-08

NPX Install

npx skill4agent add mvanhorn/printing-press-library pp-steam-web

SKILL.md Content

View Translation Comparison →

Steam Web - Printing Press CLI

Prerequisites: Install the CLI

This skill drives the

steam-web-pp-cli

binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

Install via the Printing Press installer:

bash

npx -y @mvanhorn/printing-press install steam-web --cli-only

Verify:
```
steam-web-pp-cli --version
```
Ensure
```
$GOPATH/bin
```
(or
```
$HOME/go/bin
```
) is on
```
$PATH
```
.

If the

npx

install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.23+):

bash

go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/steam-web/cmd/steam-web-pp-cli@latest

If

--version

reports "command not found" after install, the install step did not put the binary on

$PATH

. Do not proceed with skill commands until verification succeeds.

When to Use This CLI

Reach for this when the user wants:

look up a player's profile, level, or badges (
```
profile
```
,
```
level
```
,
```
badges
```
)
list a player's owned games with playtime (
```
games
```
)
show recently-played games (
```
recent
```
)
pull a player's achievements or stats for a specific game (
```
achievements
```
,
```
stats
```
)
check a player's VAC or game ban status (
```
bans
```
)
list a player's friends (
```
friends
```
)
see how many players are currently in a game (
```
players
```
)
fetch a game's news feed (
```
news
```
)
resolve a vanity URL (steamcommunity.com/id/foo) to a SteamID (
```
resolve
```
)
dump a game's achievement + stat schema (
```
schema
```
)
hit any of the 170+ Steam Web API endpoints by interface name (
```
api
```
)

Skip it when the user wants to buy games, manage Steam Workshop mods, or interact with the Steam store beyond what the Web API exposes.

Argument Parsing

Parse

$ARGUMENTS

:

Empty,
help
, or
--help
-> show
```
steam-web-pp-cli --help
```
Starts with
install
-> ends with
```
mcp
```
-> MCP installation; otherwise -> CLI installation
Anything else -> Direct Use (map to the best command and run it)

MCP Server Installation

The CLI ships an MCP server at

steam-web-pp-mcp

:

bash

go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/steam-web/cmd/steam-web-pp-mcp@latest
claude mcp add -e STEAM_WEB_API_KEY=... steam-web-pp-mcp -- steam-web-pp-mcp

Direct Use

Check installed:
```
which steam-web-pp-cli
```
. If missing, offer CLI installation.
A SteamID (17-digit) or vanity URL is needed for player commands. If the user gives a vanity URL, run
```
resolve <vanity>
```
first to get the SteamID.

Discover commands:

steam-web-pp-cli --help

; drill into

steam-web-pp-cli <cmd> --help

.

Execute with

--agent

for structured output:

bash

steam-web-pp-cli <command> [args] --agent

Notable Commands

Command	What it does
`profile <steamid>`	Player profile summary (name, country, avatar, visibility)
`games <steamid>`	Owned games with total playtime
`recent <steamid>`	Recently played games (last 2 weeks)
`achievements <steamid> <appid>`	Player's achievements for a game
`stats <steamid> <appid>`	Player's stats for a game
`friends <steamid>`	Friend list with relationship timestamps
`level <steamid>`	Steam level
`badges <steamid>`	All badges earned
`bans <steamid>`	VAC and game-ban status
`players <appid>`	Current-player count for a game
`news <appid>`	News articles for a game
`schema <appid>`	Stat + achievement schema for a game
`resolve <vanity>`	Vanity URL -> SteamID
`api <interface> <method>`	Call any of 170+ Web API endpoints directly

Run any command with

--help

for full flag documentation.

Agent Mode

Add

--agent

to any command. Expands to:

--json --compact --no-input --no-color --yes

.

Pipeable — JSON on stdout, errors on stderr
Filterable —
```
--select
```
keeps a subset of fields, with dotted-path support (see below)
Previewable —
```
--dry-run
```
shows the request without sending
Cacheable — GET responses cached for 5 minutes, bypass with
```
--no-cache
```
Non-interactive — never prompts, every input is a flag

Filtering output

--select

accepts dotted paths to descend into nested responses; arrays traverse element-wise:

bash

steam-web-pp-cli <command> --agent --select id,name
steam-web-pp-cli <command> --agent --select items.id,items.owner.name

Use this to narrow huge payloads to the fields you actually need — critical for deeply nested API responses.

Response envelope

Data-layer commands wrap output in

{"meta": {...}, "results": <data>}

. Parse

.results

for data and

.meta.source

to know whether it's

live

or local. The

N results (live)

summary is printed to stderr only when stdout is a TTY; piped/agent consumers see pure JSON on stdout.

Exit Codes

Code	Meaning
0	Success
2	Usage error (wrong arguments)
3	Resource not found (player / game)
4	Authentication required (STEAM_WEB_API_KEY missing or invalid)
5	API error (Steam upstream; includes private-profile errors)
7	Rate limited

pp-steam-web

NPX Install

Tags

SKILL.md Content

Steam Web - Printing Press CLI

Prerequisites: Install the CLI

When to Use This CLI

Argument Parsing

MCP Server Installation

Direct Use

Notable Commands

Agent Mode

Filtering output

Response envelope

Exit Codes