k31337/steam-lookup
GitHub: k31337/steam-lookup
基于 Steam Web API 的 Python CLI 工具，用于一键查询玩家的个人资料、等级徽章、封禁状态及好友封禁情况。
Stars: 0 | Forks: 0
# steam-lookup
一个 Python CLI 工具，通过查询 [Steam Web API](https://steamcommunity.com/dev) 来显示玩家的个人资料、Steam 等级和徽章、VAC/游戏/社区封禁状态，以及好友列表和每个好友的封禁状态。
## 环境要求
- Python 3.10+
- 一个 Steam Web API 密钥
## 设置说明
1. 克隆仓库并安装依赖：
pip install -r requirements.txt
2. 从 [steamcommunity.com/dev/apikey](https://steamcommunity.com/dev/apikey) 获取 Steam Web API 密钥（注册密钥需要提供一个域名；本地使用时 `localhost` 即可）。
3. 复制示例环境变量文件并添加你的密钥：
cp .env.example .env
编辑 `.env`：
STEAM_API_KEY=your_api_key_here
## 用法
```
python main.py
```
接受以下任何一种标识符格式：
- 17 位数字的 SteamID64，例如 `76561197960287930`
- 自定义名称，例如 `gabelogannewell`
- 完整的个人资料 URL，例如 `https://steamcommunity.com/id/gabelogannewell/`
### 示例
```
python main.py gabelogannewell
```
## 显示内容
| 模块 | 数据 | 来源端点 |
|------------------|----------------------------------------------------------------------------------------|-----------------------------------------------|
| Profile | 姓名、SteamID64、个人资料 URL、在线状态、账号创建日期、国家/地区 | `ISteamUser/GetPlayerSummaries` |
| Level & Badges | Steam 等级、徽章总数、等级最高的 5 个徽章 | `IPlayerService/GetSteamLevel`, `GetBadges` |
| Bans | VAC 封禁、游戏封禁、社区封禁、经济封禁、距离上次封禁的天数 | `ISteamUser/GetPlayerBans` |
| Friends | 好友总数；每个好友的姓名及封禁状态（VAC/游戏/社区封禁或“正常”） | `ISteamUser/GetFriendList`, `GetPlayerBans` |
好友列表及好友的封禁状态需要目标个人资料的好友列表公开；否则此模块将被跳过并显示提示。
## 项目结构
```
.
├── main.py # CLI entry point and output formatting
├── steam_api.py # Steam Web API client
├── requirements.txt # Python dependencies
├── .env.example # Template for required environment variables
└── README.md
```
## 注意事项
- 本项目使用官方 Steam Web API，但不隶属于 Valve，也未获得其认可或赞助。
- API 密钥属于个人隐私并与你的 Steam 账号绑定——请勿分享或提交到版本库。
## 许可证
基于 [MIT 许可证](LICENSE) 条款分发。
标签：Python, Steam, 信息查询, 无后门, 玩家资料, 逆向工具