用途:依托 Crawlora 解释某款游戏或匹配版本组合的已观察价格与折扣,可做历史价格核查或当前报价对比。适用前需明确商店平台、版本/本体/附加内容范围、平台、货币、区域、观察窗口,以及任务是历史查询还是当前报价检查。
主要能力:发现 Steam 标题/标签或 PlayStation 分类、区域、分级维度,解析具体 appid、产品 SKU 和概念/标题分组;Steam 历史数据集按 app_id 存储每日价格观察,含快照日期、抓取时间、货币、整数分、初始分、折扣百分比与免费标记;PlayStation 存储行为当前/已抓取的产品 SKU,含区域、最小单位价格字段及订阅/附加内容标记,此处不提供历史 SKU 价格端点。
使用方式:设置 CRAWLORA_API_KEY;已连接时优先使用 Crawlora MCP 工具,否则用捆绑脚本 scripts/crawlora.sh,向 https://api.crawlora.net/api/v1 发送 x-api-key。参考 reference/endpoints.md 获取方法与参数。示例命令:scripts/crawlora.sh /datasets/steam-games/search q="The Witcher 3" type=game page=1 page_size=5;scripts/crawlora.sh /datasets/playstation-games/facets facet=region。使用已验证返回的 app ID 再查历史或当前详情,例如 scripts/crawlora.sh /datasets/steam-prices/search app_id="$APP_ID" sort=date_asc page=1 page_size=100 与 scripts/crawlora.sh /steam/app appid="$APP_ID" cc=us。检查应用代码与 HTTP 状态,数据在 data 内;认证错误即停,429 退避,上游瞬时失败重试一次;按请求范围和积分预算限制调用/分页,分别保留来源 ID、URL、来源日期与观察/抓取时间。
限制:Steam 历史端点无国家筛选,不要传 cc,也不要把实时区域报价追溯为已存序列;无行日期表示未观察,不等于零价或已证不变;首个存储日不一定是原始发售价格,存储最低价不等于历史最低价;PlayStation 无历史 SKU 价格端点,应分别对比,不要虚构跨平台每日时间序列。需按声明的分单位换算并保留原值,PlayStation 最小单位字段需该行货币/量级;不得对异质来源套用同一货币或换算系数,初始/标价、折扣价、每版本、捆绑、订阅限定价格须分开。含订阅标签不证明用户拥有所需计划;零价需来源/免费/上下文证据,缺失价格即未知。仅在兼容正价格间计算 later − earlier 与相对早先观察价的百分比变化,展示的降价是相对其展示基准价,不自动等于相对历史最高价。分页限制在 10,000 条结果窗口内,展示实际覆盖天数、缺口、货币与抓取日期,报告观察区间/最小值、带日期折扣、当前与存储冲突、版本/区域假设。价格不能证明销量、收入、可获得性或结账前优惠;除非被要求,不要购买、订阅、兑换密钥或安排价格提醒。