Name	Name	Last commit message	Last commit date
parent directory ..
.manuscripts/20260508-073948	.manuscripts/20260508-073948
cmd	cmd
internal	internal
.golangci.yml	.golangci.yml
.goreleaser.yaml	.goreleaser.yaml
.printing-press-release.json	.printing-press-release.json
.printing-press-tools-polish.json	.printing-press-tools-polish.json
.printing-press.json	.printing-press.json
AGENTS.md	AGENTS.md
CHANGELOG.md	CHANGELOG.md
LICENSE	LICENSE
Makefile	Makefile
NOTICE	NOTICE
README.md	README.md
SKILL.md	SKILL.md
dogfood-results.json	dogfood-results.json
go.mod	go.mod
go.sum	go.sum
manifest.json	manifest.json
research.json	research.json
spec.json	spec.json
tools-manifest.json	tools-manifest.json
workflow-verify-report.json	workflow-verify-report.json

Steam Web CLI

Every Steam Web API endpoint, plus a local SQLite store that turns friend playtimes, achievement progress, and library backlogs into single SQL queries no other tool can answer.

Mirrors all 169 documented Steam Web API endpoints (and the undocumented store endpoints every wrapper picks one of) with rate-limit-aware throttling for the post-2025 25 req/s budget. Adds a local SQLite layer with FTS5 over apps, news, and achievements so cross-library queries — next-achievement, friends compare, library audit, achievement-leaderboard — run as one command instead of an N+1 fanout app rewrite. Ships an MCP server with both stdio and HTTP streamable transport plus a code-orchestration pair (steam_web_search + steam_web_execute) so the full surface is reachable without flooding your agent's tool catalog.

Learn more at Steam Web.

Created by @tmchow (Trevin Chow).

Install

The recommended path installs both the steam-web-pp-cli binary and the pp-steam-web agent skill (Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, and other agents supported by the upstream skills CLI) in one shot:

npx -y @mvanhorn/printing-press-library install steam-web

For CLI only (no skill):

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

For skill only — installs the skill into the same agents as the default command above, but skips the CLI binary (use this to update or reinstall just the skill):

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

To constrain the skill install to one or more specific agents (repeatable — agent names match the skills CLI):

npx -y @mvanhorn/printing-press-library install steam-web --agent claude-code
npx -y @mvanhorn/printing-press-library install steam-web --agent claude-code --agent codex

Without Node (Go fallback)

If npx isn't available (no Node, offline), install the CLI directly via Go (requires Go 1.26.3 or newer):

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

This installs the CLI only — no skill.

Pre-built binary

Download a pre-built binary for your platform from the latest release. On macOS, clear the Gatekeeper quarantine: xattr -d com.apple.quarantine <binary>. On Unix, mark it executable: chmod +x <binary>.

Install for Hermes

Install the CLI binary first. The installer writes binaries to a per-user managed bin directory by default: $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows.

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

Then install the focused Hermes skill.

From the Hermes CLI:

hermes skills install mvanhorn/printing-press-library/cli-skills/pp-steam-web --force

Inside a Hermes chat session:

/skills install mvanhorn/printing-press-library/cli-skills/pp-steam-web --force

Restart the Hermes session or gateway if the newly installed skill is not visible immediately.

Install for OpenClaw

Install both the CLI binary and the focused OpenClaw skill. The installer defaults binaries to a per-user bin directory ($HOME/.local/bin on macOS/Linux, %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows):

npx -y @mvanhorn/printing-press-library install steam-web --agent openclaw

Restart the OpenClaw session or gateway if the newly installed skill is not visible immediately.

Use with Claude Desktop

This CLI ships an MCPB bundle — Claude Desktop's standard format for one-click MCP extension installs (no JSON config required).

To install:

Download the .mcpb for your platform from the latest release.
Double-click the .mcpb file. Claude Desktop opens and walks you through the install.
Fill in STEAM_WEB_API_KEY when Claude Desktop prompts you.

Requires Claude Desktop 1.0.0 or later. Pre-built bundles ship for macOS Apple Silicon (darwin-arm64) and Windows (amd64, arm64); for other platforms, use the manual config below.

Manual JSON config (advanced)

If you can't use the MCPB bundle (older Claude Desktop, unsupported platform), install the MCP binary and configure it manually.

go install github.com/mvanhorn/printing-press-library/library/other/steam-web/cmd/steam-web-pp-mcp@latest

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "steam-web": {
      "command": "steam-web-pp-mcp",
      "env": {
        "STEAM_WEB_API_KEY": "<your-key>"
      }
    }
  }
}

Authentication

Standard Steam Web API key auth: get one at https://steamcommunity.com/dev/apikey and set STEAM_WEB_API_KEY in your environment. The key is sent as a ?key= query parameter on every request. Some endpoints (server time, app list, news) require no auth at all and work without a key. The IAuthenticationService endpoints in the spec are NOT for Web API auth — they implement Steam's interactive QR-code login flow. They remain reachable via the CLI subcommand and the MCP code-orchestration pair for completeness but should not be used as part of normal Web API workflows.

Quick Start

# Reports whether STEAM_WEB_API_KEY is set in your env. Steam keys are env-var only; export it from your shell rather than running auth set-token.
steam-web-pp-cli auth status

# Probes /ISteamWebAPIUtil/GetServerInfo and a key-gated read to confirm both reachability and your key's validity.
steam-web-pp-cli doctor

# Pulls profile, owned games, friend list, and recent achievements into the local SQLite store; the cross-library novel features all read from this store.
steam-web-pp-cli sync

# Once sync completes, this is the achievement-hunter's daily ritual — five lowest-effort unlocks across your whole library.
steam-web-pp-cli next-achievement --steamid 76561197960287930 --limit 5

# Throttled fan-out across your friend list to rank everyone by hours in app 1245620 (Elden Ring); each call also caches per-friend GetOwnedGames responses to local SQLite for next time.
steam-web-pp-cli friends compare 1245620 --my-steamid 76561197960287930

Unique Features

These capabilities aren't available in any other tool for this API.

Local state that compounds

library audit — Surface never-launched games, paid titles you bounced off in under 2 hours, and where your hours actually went by genre.

Use this when an agent is asked to plan what to play next, justify a refund, or summarize the user's gaming spend.
```
steam-web-pp-cli library audit 76561197960287930 --bounce --json
```
review-velocity — Reviews per day and voted-up share over a rolling window for one app — date-bucket aggregation over the cursor-paginated appreviews stream.

Use this when an agent is asked to track sentiment shifts after a patch, sale, or controversy.
```
steam-web-pp-cli review-velocity 1245620 --window 30d --json
```
news search — FTS5 search across the title and contents of every news post you've synced, optionally scoped by appid or date range.

Use this when an agent is asked to dig up patch notes, devlog mentions, or news around a specific topic across the user's library.
```
steam-web-pp-cli news search 'patch notes' --since 2026-04-01 --json
```
play-trend — Show concurrent-player count over time for one app as a sparkline plus min/max/last over a rolling window — value scales with how often you sample.

Use this when an agent needs to see whether a game's playerbase is growing, falling, or has spiked around an event — sample the count every few hours via cron and the window query becomes meaningful within a week.
```
steam-web-pp-cli play-trend 1245620 --window 7d --json
```

Friend-graph intelligence

friends compare — Rank everyone in your friend list by hours spent in a specific game, with throttled fan-out so you don't trip Steam's 25 req/s budget.

Use this when an agent is asked 'who in my friends has the most hours in ' or 'who owns this and never played'.
```
steam-web-pp-cli friends compare 1245620 --my-steamid 76561197960287930 --agent --select results.persona_name,results.playtime_hours
```
library compare — Set operations across two libraries — what's mine-only, what's theirs-only, what's shared with playtime delta.

Use this when an agent is asked 'what games do my friend and I both own' or to plan a co-op session.
```
steam-web-pp-cli library compare 76561197960287930 --my-steamid 76561197960287930 --shared --json
```
currently-playing — Show which friends are in-game right now and what they're playing — one batched API call across the friend list, no fanout.

Use this when an agent is asked 'who is online and playing what' or to power a status panel.
```
steam-web-pp-cli currently-playing --my-steamid 76561197960287930 --json
```
achievement-leaderboard — Rank your friends by achievement completion percentage for one app, throttled fan-out via the same limiter that powers friends compare.

Use this when an agent is asked 'who in my friends is closest to 100% in ' or to seed a competitive completion challenge.
```
steam-web-pp-cli achievement-leaderboard 1245620 --my-steamid 76561197960287930 --json
```

Achievement intelligence

next-achievement — Across your entire library, surface the achievement with the highest global unlock percentage that you still don't have.

Use this when an agent is asked 'what should I go unlock next' or to recommend low-effort achievement progress for completionists.
```
steam-web-pp-cli next-achievement --steamid 76561197960287930 --limit 10 --json
```
achievement-hunt — Render the full achievement schema for one app side-by-side with your unlock state and the global rarity of each achievement in one table.

Use this when an agent needs the full unlock landscape for one game to plan a completion run.
```
steam-web-pp-cli achievement-hunt 1245620 --steamid 76561197960287930 --locked --json
```
rare-achievements — Surface your rarest achievement unlocks across all owned games — the inverse of the next-achievement query, sorted by ascending global percentage.

Use this when an agent is asked to summarize what the user is proud of, or to power a profile-flex panel.
```
steam-web-pp-cli rare-achievements --steamid 76561197960287930 --limit 10 --json
```

Usage

Run steam-web-pp-cli --help for the full command reference and flag list.

Commands

iauthentication-service

Manage iauthentication service

steam-web-pp-cli iauthentication-service begin-auth-session-via-credentials - BeginAuthSessionViaCredentials operation of IAuthenticationService
steam-web-pp-cli iauthentication-service begin-auth-session-via-qr - BeginAuthSessionViaQR operation of IAuthenticationService
steam-web-pp-cli iauthentication-service get-auth-session-info - GetAuthSessionInfo operation of IAuthenticationService
steam-web-pp-cli iauthentication-service get-auth-session-risk-info - GetAuthSessionRiskInfo operation of IAuthenticationService
steam-web-pp-cli iauthentication-service get-password-rsapublic-key - GetPasswordRSAPublicKey operation of IAuthenticationService
steam-web-pp-cli iauthentication-service notify-risk-quiz-results - NotifyRiskQuizResults operation of IAuthenticationService
steam-web-pp-cli iauthentication-service poll-auth-session-status - PollAuthSessionStatus operation of IAuthenticationService
steam-web-pp-cli iauthentication-service update-auth-session-with-mobile-confirmation - UpdateAuthSessionWithMobileConfirmation operation of IAuthenticationService
steam-web-pp-cli iauthentication-service update-auth-session-with-steam-guard-code - UpdateAuthSessionWithSteamGuardCode operation of IAuthenticationService

ibroadcast-service

Manage ibroadcast service

steam-web-pp-cli ibroadcast-service post-game-data-frame-rtmp - PostGameDataFrameRTMP operation of IBroadcastService

icheat-reporting-service

Manage icheat reporting service

steam-web-pp-cli icheat-reporting-service report-cheat-data - ReportCheatData operation of ICheatReportingService

iclient-stats-1046930

Manage iclient stats 1046930

steam-web-pp-cli iclient-stats-1046930 report-event - ReportEvent operation of IClientStats_1046930

icontent-server-config-service

Manage icontent server config service

steam-web-pp-cli icontent-server-config-service get-steam-cache-node-params - GetSteamCacheNodeParams operation of IContentServerConfigService
steam-web-pp-cli icontent-server-config-service set-steam-cache-client-filters - SetSteamCacheClientFilters operation of IContentServerConfigService
steam-web-pp-cli icontent-server-config-service set-steam-cache-performance-stats - SetSteamCachePerformanceStats operation of IContentServerConfigService

icontent-server-directory-service

Manage icontent server directory service

steam-web-pp-cli icontent-server-directory-service get-cdnfor-video - GetCDNForVideo operation of IContentServerDirectoryService
steam-web-pp-cli icontent-server-directory-service get-client-update-hosts - GetClientUpdateHosts operation of IContentServerDirectoryService
steam-web-pp-cli icontent-server-directory-service get-depot-patch-info - GetDepotPatchInfo operation of IContentServerDirectoryService
steam-web-pp-cli icontent-server-directory-service get-servers-for-steam-pipe - GetServersForSteamPipe operation of IContentServerDirectoryService
steam-web-pp-cli icontent-server-directory-service pick-single-content-server - PickSingleContentServer operation of IContentServerDirectoryService

icsgoplayers-730

Manage icsgoplayers 730

steam-web-pp-cli icsgoplayers-730 get-next-match-sharing-code - GetNextMatchSharingCode operation of ICSGOPlayers_730

icsgoservers-730

Manage icsgoservers 730

steam-web-pp-cli icsgoservers-730 get-game-maps-playtime - GetGameMapsPlaytime operation of ICSGOServers_730
steam-web-pp-cli icsgoservers-730 get-game-servers-status - GetGameServersStatus operation of ICSGOServers_730

icsgotournaments-730

Manage icsgotournaments 730

steam-web-pp-cli icsgotournaments-730 get-tournament-fantasy-lineup - GetTournamentFantasyLineup operation of ICSGOTournaments_730
steam-web-pp-cli icsgotournaments-730 get-tournament-items - GetTournamentItems operation of ICSGOTournaments_730
steam-web-pp-cli icsgotournaments-730 get-tournament-layout - GetTournamentLayout operation of ICSGOTournaments_730
steam-web-pp-cli icsgotournaments-730 get-tournament-predictions - GetTournamentPredictions operation of ICSGOTournaments_730
steam-web-pp-cli icsgotournaments-730 upload-tournament-fantasy-lineup - UploadTournamentFantasyLineup operation of ICSGOTournaments_730
steam-web-pp-cli icsgotournaments-730 upload-tournament-predictions - UploadTournamentPredictions operation of ICSGOTournaments_730

idota2-match-570

Manage idota2 match 570

steam-web-pp-cli idota2-match-570 get-live-league-games - GetLiveLeagueGames operation of IDOTA2Match_570
steam-web-pp-cli idota2-match-570 get-match-details - GetMatchDetails operation of IDOTA2Match_570
steam-web-pp-cli idota2-match-570 get-match-history - GetMatchHistory operation of IDOTA2Match_570
steam-web-pp-cli idota2-match-570 get-match-history-by-sequence-num - GetMatchHistoryBySequenceNum operation of IDOTA2Match_570
steam-web-pp-cli idota2-match-570 get-team-info-by-team-id - GetTeamInfoByTeamID operation of IDOTA2Match_570
steam-web-pp-cli idota2-match-570 get-top-live-event-game - GetTopLiveEventGame operation of IDOTA2Match_570
steam-web-pp-cli idota2-match-570 get-top-live-game - GetTopLiveGame operation of IDOTA2Match_570
steam-web-pp-cli idota2-match-570 get-top-weekend-tourney-games - GetTopWeekendTourneyGames operation of IDOTA2Match_570
steam-web-pp-cli idota2-match-570 get-tournament-player-stats - GetTournamentPlayerStats operation of IDOTA2Match_570
steam-web-pp-cli idota2-match-570 get-tournament-player-stats-idota2match570 - GetTournamentPlayerStats operation of IDOTA2Match_570

idota2-match-stats-570

Manage idota2 match stats 570

steam-web-pp-cli idota2-match-stats-570 get-realtime-stats - GetRealtimeStats operation of IDOTA2MatchStats_570

idota2-stream-system-570

Manage idota2 stream system 570

steam-web-pp-cli idota2-stream-system-570 get-broadcaster-info - GetBroadcasterInfo operation of IDOTA2StreamSystem_570

idota2-ticket-570

Manage idota2 ticket 570

steam-web-pp-cli idota2-ticket-570 get-steam-idfor-badge-id - GetSteamIDForBadgeID operation of IDOTA2Ticket_570
steam-web-pp-cli idota2-ticket-570 set-steam-account-purchased - SetSteamAccountPurchased operation of IDOTA2Ticket_570
steam-web-pp-cli idota2-ticket-570 steam-account-valid-for-badge-type - SteamAccountValidForBadgeType operation of IDOTA2Ticket_570

iecon-dota2-570

Manage iecon dota2 570

steam-web-pp-cli iecon-dota2-570 get-event-stats-for-account - GetEventStatsForAccount operation of IEconDOTA2_570
steam-web-pp-cli iecon-dota2-570 get-heroes - GetHeroes operation of IEconDOTA2_570
steam-web-pp-cli iecon-dota2-570 get-item-creators - GetItemCreators operation of IEconDOTA2_570
steam-web-pp-cli iecon-dota2-570 get-item-workshop-published-file-ids - GetItemWorkshopPublishedFileIDs operation of IEconDOTA2_570
steam-web-pp-cli iecon-dota2-570 get-rarities - GetRarities operation of IEconDOTA2_570
steam-web-pp-cli iecon-dota2-570 get-tournament-prize-pool - GetTournamentPrizePool operation of IEconDOTA2_570

iecon-items-1046930

Manage iecon items 1046930

steam-web-pp-cli iecon-items-1046930 get-player-items - GetPlayerItems operation of IEconItems_1046930

iecon-items-1269260

Manage iecon items 1269260

steam-web-pp-cli iecon-items-1269260 get-equipped-player-items - GetEquippedPlayerItems operation of IEconItems_1269260

iecon-items-440

Manage iecon items 440

steam-web-pp-cli iecon-items-440 get-player-items - GetPlayerItems operation of IEconItems_440
steam-web-pp-cli iecon-items-440 get-schema - GetSchema operation of IEconItems_440
steam-web-pp-cli iecon-items-440 get-schema-items - GetSchemaItems operation of IEconItems_440
steam-web-pp-cli iecon-items-440 get-schema-overview - GetSchemaOverview operation of IEconItems_440
steam-web-pp-cli iecon-items-440 get-schema-url - GetSchemaURL operation of IEconItems_440
steam-web-pp-cli iecon-items-440 get-store-meta-data - GetStoreMetaData operation of IEconItems_440
steam-web-pp-cli iecon-items-440 get-store-status - GetStoreStatus operation of IEconItems_440

iecon-items-570

Manage iecon items 570

steam-web-pp-cli iecon-items-570 get-player-items - GetPlayerItems operation of IEconItems_570
steam-web-pp-cli iecon-items-570 get-store-meta-data - GetStoreMetaData operation of IEconItems_570

iecon-items-583950

Manage iecon items 583950

steam-web-pp-cli iecon-items-583950 get-equipped-player-items - GetEquippedPlayerItems operation of IEconItems_583950

iecon-items-620

Manage iecon items 620

steam-web-pp-cli iecon-items-620 get-player-items - GetPlayerItems operation of IEconItems_620
steam-web-pp-cli iecon-items-620 get-schema - GetSchema operation of IEconItems_620

iecon-items-730

Manage iecon items 730

steam-web-pp-cli iecon-items-730 get-player-items - GetPlayerItems operation of IEconItems_730
steam-web-pp-cli iecon-items-730 get-schema - GetSchema operation of IEconItems_730
steam-web-pp-cli iecon-items-730 get-schema-url - GetSchemaURL operation of IEconItems_730
steam-web-pp-cli iecon-items-730 get-store-meta-data - GetStoreMetaData operation of IEconItems_730

iecon-service

Manage iecon service

steam-web-pp-cli iecon-service get-trade-history - GetTradeHistory operation of IEconService
steam-web-pp-cli iecon-service get-trade-hold-durations - GetTradeHoldDurations operation of IEconService
steam-web-pp-cli iecon-service get-trade-offer - GetTradeOffer operation of IEconService
steam-web-pp-cli iecon-service get-trade-offers - GetTradeOffers operation of IEconService
steam-web-pp-cli iecon-service get-trade-offers-summary - GetTradeOffersSummary operation of IEconService
steam-web-pp-cli iecon-service get-trade-status - GetTradeStatus operation of IEconService

igame-notifications-service

Manage igame notifications service

steam-web-pp-cli igame-notifications-service user-create-session - UserCreateSession operation of IGameNotificationsService
steam-web-pp-cli igame-notifications-service user-delete-session - UserDeleteSession operation of IGameNotificationsService
steam-web-pp-cli igame-notifications-service user-update-session - UserUpdateSession operation of IGameNotificationsService

igame-servers-service

Manage igame servers service

steam-web-pp-cli igame-servers-service create-account - CreateAccount operation of IGameServersService
steam-web-pp-cli igame-servers-service delete-account - DeleteAccount operation of IGameServersService
steam-web-pp-cli igame-servers-service get-account-list - GetAccountList operation of IGameServersService
steam-web-pp-cli igame-servers-service get-account-public-info - GetAccountPublicInfo operation of IGameServersService
steam-web-pp-cli igame-servers-service get-server-ips-by-steam-id - GetServerIPsBySteamID operation of IGameServersService
steam-web-pp-cli igame-servers-service get-server-steam-ids-by-ip - GetServerSteamIDsByIP operation of IGameServersService
steam-web-pp-cli igame-servers-service query-by-fake-ip - QueryByFakeIP operation of IGameServersService
steam-web-pp-cli igame-servers-service query-login-token - QueryLoginToken operation of IGameServersService
steam-web-pp-cli igame-servers-service reset-login-token - ResetLoginToken operation of IGameServersService
steam-web-pp-cli igame-servers-service set-memo - SetMemo operation of IGameServersService

igcversion-1046930

Manage igcversion 1046930

steam-web-pp-cli igcversion-1046930 get-client-version - GetClientVersion operation of IGCVersion_1046930
steam-web-pp-cli igcversion-1046930 get-server-version - GetServerVersion operation of IGCVersion_1046930

igcversion-1269260

Manage igcversion 1269260

steam-web-pp-cli igcversion-1269260 get-client-version - GetClientVersion operation of IGCVersion_1269260
steam-web-pp-cli igcversion-1269260 get-server-version - GetServerVersion operation of IGCVersion_1269260

igcversion-1422450

Manage igcversion 1422450

steam-web-pp-cli igcversion-1422450 get-client-version - GetClientVersion operation of IGCVersion_1422450
steam-web-pp-cli igcversion-1422450 get-server-version - GetServerVersion operation of IGCVersion_1422450

igcversion-440

Manage igcversion 440

steam-web-pp-cli igcversion-440 get-client-version - GetClientVersion operation of IGCVersion_440
steam-web-pp-cli igcversion-440 get-server-version - GetServerVersion operation of IGCVersion_440

igcversion-570

Manage igcversion 570

steam-web-pp-cli igcversion-570 get-client-version - GetClientVersion operation of IGCVersion_570
steam-web-pp-cli igcversion-570 get-server-version - GetServerVersion operation of IGCVersion_570

igcversion-583950

Manage igcversion 583950

steam-web-pp-cli igcversion-583950 get-client-version - GetClientVersion operation of IGCVersion_583950
steam-web-pp-cli igcversion-583950 get-server-version - GetServerVersion operation of IGCVersion_583950

igcversion-730

Manage igcversion 730

steam-web-pp-cli igcversion-730 get-server-version - GetServerVersion operation of IGCVersion_730

ihelp-request-logs-service

Manage ihelp request logs service

steam-web-pp-cli ihelp-request-logs-service get-application-log-demand - GetApplicationLogDemand operation of IHelpRequestLogsService
steam-web-pp-cli ihelp-request-logs-service upload-user-application-log - UploadUserApplicationLog operation of IHelpRequestLogsService

iinventory-service

Manage iinventory service

steam-web-pp-cli iinventory-service combine-item-stacks - CombineItemStacks operation of IInventoryService
steam-web-pp-cli iinventory-service get-price-sheet - GetPriceSheet operation of IInventoryService
steam-web-pp-cli iinventory-service split-item-stack - SplitItemStack operation of IInventoryService

iplayer-service

Manage iplayer service

steam-web-pp-cli iplayer-service get-badges - GetBadges operation of IPlayerService
steam-web-pp-cli iplayer-service get-community-badge-progress - GetCommunityBadgeProgress operation of IPlayerService
steam-web-pp-cli iplayer-service get-owned-games - GetOwnedGames operation of IPlayerService
steam-web-pp-cli iplayer-service get-recently-played-games - GetRecentlyPlayedGames operation of IPlayerService
steam-web-pp-cli iplayer-service get-steam-level - GetSteamLevel operation of IPlayerService
steam-web-pp-cli iplayer-service is-playing-shared-game - IsPlayingSharedGame operation of IPlayerService
steam-web-pp-cli iplayer-service record-offline-playtime - RecordOfflinePlaytime operation of IPlayerService

iportal2-leaderboards-620

Manage iportal2 leaderboards 620

steam-web-pp-cli iportal2-leaderboards-620 get-bucketized-data - GetBucketizedData operation of IPortal2Leaderboards_620

ipublished-file-service

Manage ipublished file service

steam-web-pp-cli ipublished-file-service get-details - GetDetails operation of IPublishedFileService
steam-web-pp-cli ipublished-file-service get-sub-section-data - GetSubSectionData operation of IPublishedFileService
steam-web-pp-cli ipublished-file-service get-user-file-count - GetUserFileCount operation of IPublishedFileService
steam-web-pp-cli ipublished-file-service get-user-files - GetUserFiles operation of IPublishedFileService
steam-web-pp-cli ipublished-file-service get-user-vote-summary - GetUserVoteSummary operation of IPublishedFileService
steam-web-pp-cli ipublished-file-service query-files - QueryFiles operation of IPublishedFileService

isteam-apps

Manage isteam apps

steam-web-pp-cli isteam-apps get-sdrconfig - GetSDRConfig operation of ISteamApps
steam-web-pp-cli isteam-apps get-servers-at-address - GetServersAtAddress operation of ISteamApps
steam-web-pp-cli isteam-apps up-to-date-check - UpToDateCheck operation of ISteamApps

isteam-broadcast

Manage isteam broadcast

steam-web-pp-cli isteam-broadcast player-stats - PlayerStats operation of ISteamBroadcast
steam-web-pp-cli isteam-broadcast viewer-heartbeat - ViewerHeartbeat operation of ISteamBroadcast

isteam-cdn

Manage isteam cdn

steam-web-pp-cli isteam-cdn set-client-filters - SetClientFilters operation of ISteamCDN
steam-web-pp-cli isteam-cdn set-performance-stats - SetPerformanceStats operation of ISteamCDN

isteam-directory

Manage isteam directory

steam-web-pp-cli isteam-directory get-cmlist - GetCMList operation of ISteamDirectory
steam-web-pp-cli isteam-directory get-cmlist-for-connect - GetCMListForConnect operation of ISteamDirectory
steam-web-pp-cli isteam-directory get-steam-pipe-domains - GetSteamPipeDomains operation of ISteamDirectory

isteam-economy

Manage isteam economy

steam-web-pp-cli isteam-economy get-asset-class-info - GetAssetClassInfo operation of ISteamEconomy
steam-web-pp-cli isteam-economy get-asset-prices - GetAssetPrices operation of ISteamEconomy

isteam-news

Manage isteam news

steam-web-pp-cli isteam-news get-news-for-app - GetNewsForApp operation of ISteamNews
steam-web-pp-cli isteam-news get-news-for-app-isteamnews - GetNewsForApp operation of ISteamNews

isteam-remote-storage

Manage isteam remote storage

steam-web-pp-cli isteam-remote-storage get-collection-details - GetCollectionDetails operation of ISteamRemoteStorage
steam-web-pp-cli isteam-remote-storage get-published-file-details - GetPublishedFileDetails operation of ISteamRemoteStorage
steam-web-pp-cli isteam-remote-storage get-ugcfile-details - GetUGCFileDetails operation of ISteamRemoteStorage

isteam-user

Manage isteam user

steam-web-pp-cli isteam-user get-friend-list - GetFriendList operation of ISteamUser
steam-web-pp-cli isteam-user get-player-bans - GetPlayerBans operation of ISteamUser
steam-web-pp-cli isteam-user get-player-summaries - GetPlayerSummaries operation of ISteamUser
steam-web-pp-cli isteam-user get-player-summaries-isteamuser - GetPlayerSummaries operation of ISteamUser
steam-web-pp-cli isteam-user get-user-group-list - GetUserGroupList operation of ISteamUser
steam-web-pp-cli isteam-user resolve-vanity-url - ResolveVanityURL operation of ISteamUser

isteam-user-auth

Manage isteam user auth

steam-web-pp-cli isteam-user-auth authenticate-user-ticket - AuthenticateUserTicket operation of ISteamUserAuth

isteam-user-oauth

Manage isteam user oauth

steam-web-pp-cli isteam-user-oauth get-token-details - GetTokenDetails operation of ISteamUserOAuth

isteam-user-stats

Manage isteam user stats

steam-web-pp-cli isteam-user-stats get-global-achievement-percentages-for-app - GetGlobalAchievementPercentagesForApp operation of ISteamUserStats
steam-web-pp-cli isteam-user-stats get-global-achievement-percentages-for-app-isteamuserstats - GetGlobalAchievementPercentagesForApp operation of ISteamUserStats
steam-web-pp-cli isteam-user-stats get-global-stats-for-game - GetGlobalStatsForGame operation of ISteamUserStats
steam-web-pp-cli isteam-user-stats get-number-of-current-players - GetNumberOfCurrentPlayers operation of ISteamUserStats
steam-web-pp-cli isteam-user-stats get-player-achievements - GetPlayerAchievements operation of ISteamUserStats
steam-web-pp-cli isteam-user-stats get-schema-for-game - GetSchemaForGame operation of ISteamUserStats
steam-web-pp-cli isteam-user-stats get-schema-for-game-isteamuserstats - GetSchemaForGame operation of ISteamUserStats
steam-web-pp-cli isteam-user-stats get-user-stats-for-game - GetUserStatsForGame operation of ISteamUserStats
steam-web-pp-cli isteam-user-stats get-user-stats-for-game-isteamuserstats - GetUserStatsForGame operation of ISteamUserStats

isteam-web-apiutil

Manage isteam web apiutil

steam-web-pp-cli isteam-web-apiutil get-server-info - GetServerInfo operation of ISteamWebAPIUtil
steam-web-pp-cli isteam-web-apiutil get-supported-apilist - GetSupportedAPIList operation of ISteamWebAPIUtil

istore-service

Manage istore service

steam-web-pp-cli istore-service get-app-list - Gets a list of all apps available on the Steam Store
steam-web-pp-cli istore-service get-games-followed - GetGamesFollowed operation of IStoreService
steam-web-pp-cli istore-service get-games-followed-count - GetGamesFollowedCount operation of IStoreService
steam-web-pp-cli istore-service get-recommended-tags-for-user - GetRecommendedTagsForUser operation of IStoreService

itfitems-440

Manage itfitems 440

steam-web-pp-cli itfitems-440 get-golden-wrenches - GetGoldenWrenches operation of ITFItems_440
steam-web-pp-cli itfitems-440 get-golden-wrenches-itfitems440 - GetGoldenWrenches operation of ITFItems_440

itfpromos-440

Manage itfpromos 440

steam-web-pp-cli itfpromos-440 get-item-id - GetItemID operation of ITFPromos_440
steam-web-pp-cli itfpromos-440 grant-item - GrantItem operation of ITFPromos_440

itfpromos-620

Manage itfpromos 620

steam-web-pp-cli itfpromos-620 get-item-id - GetItemID operation of ITFPromos_620
steam-web-pp-cli itfpromos-620 grant-item - GrantItem operation of ITFPromos_620

itfsystem-440

Manage itfsystem 440

steam-web-pp-cli itfsystem-440 get-world-status - GetWorldStatus operation of ITFSystem_440

iwishlist-service

Manage iwishlist service

steam-web-pp-cli iwishlist-service get-wishlist - GetWishlist operation of IWishlistService
steam-web-pp-cli iwishlist-service get-wishlist-item-count - GetWishlistItemCount operation of IWishlistService
steam-web-pp-cli iwishlist-service get-wishlist-sorted-filtered - GetWishlistSortedFiltered operation of IWishlistService

Output Formats

# Human-readable table (default in terminal, JSON when piped)
steam-web-pp-cli iauthentication-service begin-auth-session-via-credentials --account-name example-resource

# JSON for scripting and agents
steam-web-pp-cli iauthentication-service begin-auth-session-via-credentials --account-name example-resource --json

# Filter to specific fields
steam-web-pp-cli iauthentication-service begin-auth-session-via-credentials --account-name example-resource --json --select id,name,status

# Dry run — show the request without sending
steam-web-pp-cli iauthentication-service begin-auth-session-via-credentials --account-name example-resource --dry-run

# Agent mode — JSON + compact + no prompts in one flag
steam-web-pp-cli iauthentication-service begin-auth-session-via-credentials --account-name example-resource --agent

Agent Usage

This CLI is designed for AI agent consumption:

Non-interactive - never prompts, every input is a flag
Pipeable - --json output to stdout, errors to stderr
Filterable - --select id,name returns only fields you need
Previewable - --dry-run shows the request without sending
Explicit retries - add --idempotent to create retries when a no-op success is acceptable
Confirmable - --yes for explicit confirmation of destructive actions
Piped input - write commands can accept structured input when their help lists --stdin
Offline-friendly - sync/search commands can use the local SQLite store when available
Agent-safe by default - no colors or formatting unless --human-friendly is set

Exit codes: 0 success, 2 usage error, 3 not found, 4 auth error, 5 API error, 7 rate limited, 10 config error.

Health Check

steam-web-pp-cli doctor

Verifies configuration, credentials, and connectivity to the API.

Configuration

Config file: ~/.config/steam-web-pp-cli/config.toml

Environment variables:

Name	Kind	Required	Description
`STEAM_WEB_API_KEY`	per_call	Yes	Set to your API credential.

Troubleshooting

Authentication errors (exit code 4)

Run steam-web-pp-cli doctor to check credentials
Verify the environment variable is set: echo $STEAM_WEB_API_KEY Not found errors (exit code 3)
Check the resource ID is correct
Run the list command to see available items

API-specific

GetOwnedGames returns an empty array even though you own games — Your Steam profile (or game library) is set to private. Visit https://steamcommunity.com/my/edit/settings, set both 'My profile' and 'Game details' to Public, wait 30s, then retry. Steam returns 200 + empty payload for private profiles instead of a clear error.
HTTP 429 with x-eresult: 25 or x-eresult: 84 — Steam tightened rate limits to ~25 req/s in mid-2025. The CLI throttles automatically via cliutil.AdaptiveLimiter, but if you're scripting outside the CLI, slow down. Wait the value of Retry-After (or 60s if absent), then retry.
store appdetails returns null for an appid — Some appids (films, hardware, region-locked) have no store entry. Confirm the appid via steam-web-pp-cli apps search '<name>' and try again with the canonical appid.
GetUserStatsForGame returns empty for a game you just played — Steam takes hours-to-days to populate per-user stats for newly-purchased games. Try GetPlayerAchievements instead (achievements populate faster than stats), or wait 24h.
vanity URL doesn't resolve — ResolveVanityURL only finds custom URLs (like /id/foo). For numeric profile URLs (/profiles/76561...), the SteamID is already in the URL — no resolve needed. Use steam-web-pp-cli ISteamUser ResolveVanityURL --vanityurl foo.

Sources & Inspiration

This CLI was built by studying these projects and resources:

Generated by CLI Printing Press

FilesExpand file tree

steam-web

Directory actions

More options