Steam Profile Search Tool

A Go-based tool for searching Steam profiles very fast with Wayback Machine integration and avatar downloads.

Features

• Search Steam profiles by username
• Export results in JSON, CSV, or text format
• Download profile avatars
• Check Wayback Machine for profile snapshots
• Concurrent processing for faster results
• Automatic steam session ID retrieval
• Performance metrics tracking

Requirements

• Go 1.24 or later

Supported Platforms

Platform	Architecture	Status	Notes
Linux	amd64	✅ Tested	Works as expected
Linux	arm64	❌ Untested
Linux	armv6	❌ Untested	Raspberry Pi Zero compatible
Windows	amd64	❌ Untested
macOS	amd64	❌ Untested

Usage

go install github.com/Sudo-Ivan/steam-search@latest

or get binary for your platform from releases page: https://github.com/Sudo-Ivan/steam-search/releases

# Basic usage with automatic session ID
steam-search "username" -auto-session

# Manual session ID
steam-search "username" -session="your_session_id"

# Show performance metrics
steam-search "username" -auto-session -p
# or
steam-search "username" -auto-session --performance

# Specify output format (json, csv, or text)
steam-search "search_term" -auto-session -format="json"

# Specify output directory
steam-search "search_term" -auto-session -output="my_results"

# Disable avatar downloads
steam-search "search_term" -auto-session -avatars=false
# or
steam-search "search_term" -auto-session -skip-avatars

# Disable Wayback Machine checks
steam-search "search_term" -auto-session -wayback=false
# or
steam-search "search_term" -auto-session -skip-wayback

# Limit number of profiles
steam-search "search_term" -auto-session -limit=100

Docker

mkdir -p steam-search-results
chown -R 1000:1000 steam-search-results
docker run -u 1000:1000 -v ./steam-search-results:/steam-search-results ghcr.io/sudo-ivan/steam-search:latest "username" -auto-session

Output

The tool creates the following structure in the output directory:

steam-search-results/
├── steam-search-results.json (or .csv/.txt)
├── steam-search-wayback.json (if wayback enabled)
└── avatars/
    ├── username1_avatar.jpg
    ├── username2_avatar.jpg
    └── ...

Command Line Options

• -session: Steam session ID (required if not using -auto-session)
• -auto-session: Automatically get session ID
• -output: Output directory (default: "steam-search-results")
• -format: Output format (json, csv, or text, default: json)
• -avatars: Enable/disable avatar downloads (default: true)
• -wayback: Enable/disable Wayback Machine checks (default: true)
• -skip-avatars: Skip avatar downloads (overrides -avatars)
• -skip-wayback: Skip Wayback Machine checks (overrides -wayback)
• -limit: Limit number of profiles to fetch (default: 0, no limit)
• -p, --performance: Show performance metrics

Session ID

You have two options for providing a session ID:

1. Automatic (recommended):

   • Use the -auto-session flag
   • The tool will automatically fetch a valid session ID

2. Manual:

   • Log into Steam Community in your browser
   • Open browser developer tools (F12)
   • Go to the Application/Storage tab
   • Look for the sessionid cookie value
   • Use the -session flag with the value

Building from source

git clone https://github.com/Sudo-Ivan/steam-search.git
cd steam-search
go build -o steam-search main.go

Docker

docker build -t steam-search .
docker run -u 1000:1000 -v ./steam-search-results:/steam-search-results steam-search:latest "username" -auto-session

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

License

MIT License