Steam 社区库存技能

从 steamcommunity.com 检索并浏览 Steam 用户的库存。

配置

1. 获取您的 Steam ID（SteamID64）：

   • 访问您的 Steam 个人资料页面
   • 如果您的 URL 是 https://steamcommunity.com/profiles/76561198012345678，则您的 Steam ID 为 76561198012345678
   • 如果您的 URL 使用自定义名称（例如 https://steamcommunity.com/id/myname），请访问 steamid.io 并粘贴您的个人资料 URL，以获取对应的 SteamID64

2. 获取您的 Steam 会话 Cookie（用于在获取您自己的库存时绕过速率限制）：

   • 在浏览器中登录 steamcommunity.com
   • 打开开发者工具（F12）→「Application」标签页 →「Cookies」→ https://steamcommunity.com
   • 复制 steamLoginSecure Cookie 的值

3. 设置环境变量：

   export STEAM_ID="your-steamid64"
   export STEAM_COOKIES="steamLoginSecure=your-cookie-value"
   

使用方法

所有命令均使用 curl 调用 Steam 社区库存接口。所有标准游戏库存的上下文 ID 均为 2。

常见 App ID

获取某款游戏的库存

将 $APP_ID 替换为对应游戏的 App ID（参见上方表格）。所有标准游戏库存的上下文 ID 均为 2。

curl -s "https://steamcommunity.com/inventory/$STEAM_ID/$APP_ID/2?l=english&count=2000" 
  -H "Cookie: $STEAM_COOKIES" | jq '.'

获取 CS2 库存

curl -s "https://steamcommunity.com/inventory/$STEAM_ID/730/2?l=english&count=2000" 
  -H "Cookie: $STEAM_COOKIES" | jq '.'

获取物品摘要（名称与数量）

curl -s "https://steamcommunity.com/inventory/$STEAM_ID/730/2?l=english&count=2000" 
  -H "Cookie: $STEAM_COOKIES" | jq '[.descriptions[] | {market_hash_name, type}]'

获取物品详情（asset ID 映射至描述信息）

curl -s "https://steamcommunity.com/inventory/$STEAM_ID/730/2?l=english&count=2000" 
  -H "Cookie: $STEAM_COOKIES" | jq '{assets: [.assets[] | {assetid, classid, instanceid, amount}], total: .total_inventory_count}'

分页获取（适用于超过 2000 件物品的库存）

当存在更多物品时，API 将返回 last_assetid 字段。将其作为 start_assetid 参数传入，即可获取下一页数据：

curl -s "https://steamcommunity.com/inventory/$STEAM_ID/730/2?l=english&count=2000&start_assetid=$LAST_ASSET_ID" 
  -H "Cookie: $STEAM_COOKIES" | jq '.'

通过检查响应中的 more_items 字段判断是否还有更多页（若值为 1，表示尚有后续页面）。

响应格式

库存接口返回 JSON，包含以下关键字段：

物品（assets）通过 classid 与 instanceid 组合关联至其描述信息（descriptions）。

注意事项

• 速率限制：社区接口对 IP 实施严格的速率限制。使用您自己的 Cookie 可绕过该限制（仅限获取您本人的库存）。未提供 Cookie 时，数次请求后即可能触发 IP 封禁（冷却期约 6 小时）。
• 请求间隔：若需批量获取多个库存或分页数据，请确保两次请求之间至少间隔 4 秒。
• count 参数：最大允许值为 5000，但建议使用 2000 以避免异常。
• 上下文 ID（Context ID）：所有标准游戏库存均使用 2；Steam 社区物品（App ID 753）的部分类型则使用上下文 ID 6。
• 隐私设置：目标用户库存必须设为公开，或您必须以所有者身份完成认证。