Skip to main content

Steam Store

@aaddrick/steam-storev2026.11.03.1· MIT· 18d agoBEHAVIORSWORKFLOWSREPORTSACCEPTED WARNINGS
01README

Read-only toolkit over the Steam storefront Web API: catalog query/scan, items, tags, categories, players, appdetails, CDN images, and a generic CEL selector.

02Behaviors8
@aaddrick/steam-store/catalogv2026.11.03.1steam-store/catalog.ts

Global Arguments

ArgumentTypeDescription
language?stringSteam language name; controls names and descriptions
countryCode?stringISO country code; controls prices and visibility
fn query()
Fetch one page of a catalog query and store the response as returned
fn scan()
Sweep every page of a catalog query into per-page resources (resumable)

Resources

query(infinite)— One Query response as returned (`metadata`, `ids`, `store_items`)
page(infinite)— One scan page: raw page metadata plus deduped `store_items` and drop counts
scanMeta(infinite)— Scan marker: parameters, hash, progress and completeness

Files

scanLog(text/plain)— Scan progress, one line per page
@aaddrick/steam-store/taglistv2026.11.03.1steam-store/taglist.ts

Global Arguments

ArgumentTypeDescription
language?stringSteam language name for tag names
fn sync()
Fetch the tag list, or keep the cached one when Steam reports it unchanged

Resources

taglist(infinite)— Tag table: `byId` maps tagid (string) → name, plus `versionHash` and `language`
@aaddrick/steam-store/itemsv2026.11.03.1steam-store/items.ts

Global Arguments

ArgumentTypeDescription
language?stringSteam language name
countryCode?stringISO country code; sets currency and region
fn get()
Fetch store items for a list of IDs (chunked at 100 per request)

Resources

items(infinite)— Requested IDs, the data_request used, and `store_items` in request order
@aaddrick/steam-store/mediav2026.11.03.1steam-store/media.ts

Global Arguments

ArgumentTypeDescription
language?stringSteam language name (some assets are localised)
countryCode?stringISO country code
cdnBase?urlAsset CDN prefix
fn download()
Resolve asset filenames via GetItems and download them from the CDN

Resources

downloads(infinite)— What was downloaded, from where, and which requested assets the item does not have

Files

asset(application/octet-stream)— One downloaded image
@aaddrick/steam-store/categoriesv2026.11.03.1steam-store/categories.ts

Global Arguments

ArgumentTypeDescription
language?stringSteam language name for category names
fn sync()
Fetch every store category in the configured language

Resources

categories(infinite)— `byId` maps categoryid (string) → {name, type, internal_name}
@aaddrick/steam-store/playersv2026.11.03.1steam-store/players.ts
fn get()
Fetch the current player count; a nonexistent app is an error, not 0

Resources

players(infinite)— Player count for one app at `fetchedAt`
@aaddrick/steam-store/detailsv2026.11.03.1steam-store/details.ts

Global Arguments

ArgumentTypeDescription
cc?stringCountry code for prices; without it currency follows the caller's IP
l?stringLanguage name
baseUrl?urlOverride the store host (test seam / proxy)
fn get()
Fetch appdetails for one app; `success: false` is an error

Resources

details(infinite)— The raw `data` block for one app (`[]` when a filter matched nothing; captured 2026-11-03)
@aaddrick/steam-store/selectv2026.11.03.1steam-store/select.ts

Global Arguments

ArgumentTypeDescription
catalogstringName of the catalog or items behavior whose stored items to read
taglist?stringName of the taglist behavior used for tag names
fn select()
Select rows from stored catalog/items data and write them as a resource and a CSV

Resources

rows(infinite)— Selected rows (flattened store items) and how they were selected

Files

csv(text/csv)— Selected rows as RFC 4180 CSV (CRLF; fields with commas, quotes or newlines are quoted; text cells starting with = + - @ tab or CR get a leading ')
03Workflows2
@aaddrick/steam-store/find-op-gamesa458ed54-b3d7-46dd-8a6d-53b88a870325

Example use case built on the steam-store toolkit: every released game Steam rates "Overwhelmingly Positive" (review_score 9) with fewer than maxReviews reviews, excluding sexual content, as a CSV in the steamstats column layout. All criteria live in this file as data (a CEL selector and tag-ID groups).

fetchTag names and the full released-games catalog, in parallel
1.taglist— Tag ID → name table (cached by version hash)
2.scan— Sweep every released game (~136 pages of 1000)
selectApply the criteria, then gate on the result
1.select— Overwhelmingly Positive, under maxReviews, no sexual content
2.gate— Re-check the output instead of trusting the select step's status: rows exist, the count matches, and every row meets the criteria.
@aaddrick/steam-store/live-smoke5b544c30-12f9-4e38-bf82-ab12107bc331

Opt-in end-to-end smoke test against the LIVE Steam API, through swamp itself: every steam-store behavior method runs once with tiny arguments (9 requests in total), then an assert gate re-checks every output. Behavior instances are all named smoke-* and live in .swamp/. Run it after installing to check the extension against the live API. In the source repository it is not part of `deno task test`; see docs/testing-methodology.md there, "Live tests".

fetchOne call per request-making behavior method, tiny arguments
1.catalog-query— One 5-item page of released games
2.catalog-scan— A complete scan of a small filter (hardware, ~17 items: one page), so the scan finishes in one request
3.taglist— Tag ID → name table
4.items— All five ID kinds plus a nonexistent appid
5.media— Hades header image; a tag has no assets and is reported missing
6.categories— Store category table
7.players— Current players for Dota 2
8.details— appdetails for Hades
verifySelect over the scanned data, then gate on every output
1.select— Every scanned item with a name, tag names from the synced taglist
2.gate— Re-check every output instead of trusting the steps' status: each behavior stored what the live API is documented to return.
04Reports1
@aaddrick/steam-store/rows-summarymodel
rows-summary.ts

Row count and histograms over the categorical fields of a select run's rows

summary
05Stats
A
100 / 100
Downloads
4
Archive size
63.1 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Docs keep secrets in a vault1/1earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License2/2earned
  • Verified public repository2/2earned

07Platforms