游戏价格历史研究

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install game-price-history-research
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 game-price-history-research。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

游戏价格历史研究使用 Crawlora 调查已观测到的 Steam 价格历史并比较当前游戏报价，包括 PlayStation 产品。它有助于制作带日期的折扣简报和价格区间分析，同时避免混淆不同版本、附加内容、组合包、订阅、货币或地区。
作为 Openclaw Skills 中用于游戏报价研究的工具，它着重说明可用数据的局限：存储的 Steam 观测记录不一定构成完整历史，缺失日期不代表价格为零，而 PlayStation 记录不提供历史 SKU 价格序列。因此，它能生成更可信的比较，并明确列出所依据的假设和数据覆盖范围。

应用场景

为某款游戏准备一份带日期的简报，介绍已观测到的 Steam 折扣和价格区间。
确认确切的游戏名称、版本、产品和地区后，比较当前 Steam 或 PlayStation 报价。
检查报价对应的是基础游戏、高级版、组合包、DLC、虚拟货币，还是需要订阅资格的产品。
在描述历史最低价或折扣之前，检查存储的 Steam 价格观测记录的覆盖范围和缺口。
在保留货币和价格尺度的前提下，比较兼容的早期与后期观测价格。
调查当前区域性 Steam 报价与存储历史记录之间的差异，不将两者视为同一种数据。

工作原理

确定请求涉及的商店、游戏名称或匹配版本、平台、地区、货币、观测时间范围，以及任务关注的是历史记录还是当前报价。
查找候选 Steam 游戏或 PlayStation 分面，然后确认准确的 Steam app ID 和 PlayStation 产品 SKU。将相同名称和概念 ID 视为分组线索，而不是权益完全相同的证明。
查询相关的 Crawlora 数据集或实时详情端点。检查应用程序代码和 HTTP 状态，并从 data 负载中读取结果。
按数据来源解读记录：Steam 历史记录以 app_id 为键，且没有国家筛选条件；PlayStation 行是抓取的产品 SKU 报价，不提供历史价格端点。
保留原始价格值，仅根据适用的货币刻度换算美分或其他最小货币单位。将标价、折后价、版本价、组合包价格和需要订阅资格的价格分别处理。
对兼容的正价格，使用较晚价格减去较早价格，并以较早的观测价格为基准计算百分比变化。报告实际覆盖日期、缺口、抓取日期、货币和假设。
在提供观测区间和带日期的报价时注明限制。除非有证据支持，否则不要声称这是历史最低价、已进行促销、收入、可用性、结账节省金额，或用户拥有所需订阅。

配置指南

在环境中设置 Crawlora API 密钥。可用时使用列出的 Crawlora MCP 工具；否则使用捆绑的 shell 脚本，该脚本会将密钥发送到 Crawlora API。确切方法和参数请参阅 reference/endpoints.md。
export CRAWLORA_API_KEY="your-crawlora-api-key"
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
确认返回的 Steam 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 429 响应时延迟重试，遇到临时上游故障时重试一次。Steam 历史端点不接受国家筛选条件；不要使用实时区域报价来追溯描述存储历史。

数据架构

Steam 游戏发现：搜索结果有助于识别候选游戏；请求价格历史或实时应用详情前，先确认准确的 app_id。
Steam 价格观测记录：每日应用／日期行包括 snapshot_date、crawled_at、货币、整数美分、初始美分、折扣百分比和免费标记。历史查询使用 app_id；实时 Steam 应用详情使用 appid，并可能接受 cc。
PlayStation 报价：存储的行代表抓取的产品 SKU，包括地区、最小货币单位价格字段以及订阅或附加内容标记。不提供历史 SKU 价格端点。
报价身份：区分基础游戏、高级版、组合包、DLC、虚拟货币和需要订阅资格的报价。相同标题或概念 ID 并不能证明权益相同。
价格解读：保留原始值及其货币和刻度。缺少观测记录表示未知，而不是零；零价格必须有来源证据或免费状态背景支持。包含订阅不代表用户拥有相应方案。
覆盖范围和来源信息：分别保留来源 ID、URL、来源日期以及观测或抓取时间。显示覆盖天数、缺口和 10,000 条结果的窗口限制。首条存储观测记录不一定是发售价格，存储的最低价也不一定是历史最低价。

高级特性

连接后使用 Crawlora MCP 工具，并提供捆绑的
scripts/crawlora.sh
作为备用方案。
区分数据集历史记录和实时 Steam 详情，并明确说明 Steam 历史端点没有国家筛选条件。
支持在确认准确的 app ID 或产品 SKU 前进行游戏名称和分面发现。
保留来源信息、观测日期、抓取时间、货币和价格刻度，确保比较结果可审计。
仅针对兼容的正价格计算绝对变化和百分比变化，并以较早的观测价格作为百分比基准。
使用有界分页和额度感知型请求，并明确定义身份验证错误、速率限制和临时上游故障的处理方式。
避免缺乏依据的跨平台历史比较、推断历史最低价，以及未经请求的购买、订阅、密钥兑换或价格提醒。

name: game-price-history-research description: Research observed Steam price history and compare current game editions or PlayStation offers using Crawlora. Use for a dated discount brief, observed price-range analysis, or game offer comparison with currency, SKU, subscription, and history coverage preserved.

Game price history research

Access and scope

Set CRAWLORA_API_KEY to your Crawlora key. Prefer the listed Crawlora MCP tools when connected; otherwise use the bundled scripts/crawlora.sh, which sends x-api-key to https://api.crawlora.net/api/v1. Read reference/endpoints.md for exact methods and parameters. Check application code as well as HTTP status; payloads are inside data. Stop on authentication errors, back off on 429, and retry a transient upstream failure once. Bound calls/pages by the requested scope and credit budget. Retain source IDs, URLs, source dates, and observation/crawl times separately.

Explain observed game prices and discounts for a title or matched edition set. Establish storefront, edition/base-game/add-on scope, desired platforms, currency, region, observation window, and whether the task is historical or a current offer check.

Resolve title, edition, and history scope
Discover Steam titles/tags or PlayStation category/region/classification facets, then resolve exact appid, product SKU, and concept/title grouping. A base game, bundle, DLC, virtual currency, and premium edition are different offers. Shared names or concept IDs are grouping leads, not identical entitlements.
Steam dataset histories use app_id; live Steam app detail uses appid and optional cc. The history endpoint has no country filter: do not pass cc or claim a live regional quote retroactively describes the stored series.
datasets_steam_prices_search stores daily app/day price observations for priced games, with snapshot_date, crawled_at, currency, integer cents, initial cents, discount percentage, and free flag. Dates with no row are unobserved, not zero price or proven unchanged. The first stored day is not necessarily the original launch price, and a stored minimum is not an all-time low.
PlayStation stored rows are current/crawled product SKUs with region, minor-unit price fields, and subscription/add-on flags. No historical SKU-price endpoint is provided here. Compare current PlayStation offers separately from Steam history rather than inventing a cross-platform daily time series.
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

# Use a verified returned app ID before its history/current detail:
# 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

Calculate and present comparable prices

Convert explicitly declared *_cents using their cents scale, preserving raw values; PlayStation minor-unit fields need the row's currency/scale. Never apply one assumed currency or conversion factor to unlike sources. Keep initial/list, discounted, per-edition, bundle, and subscription-qualified prices separate. An included-with-subscription label is not proof the user owns the necessary plan. A price of zero needs source/free/context evidence; a missing price is unknown.

For compatible positive prices compute later − earlier and the percentage change against the earlier observed price. A displayed markdown is relative to its displayed base price, not automatically relative to the historical maximum. Bound pages to the 10,000-result window and show actual covered days, gaps, currency, and crawl dates. Report observed range/minimum, dated discounts, current-versus-stored conflicts, and edition/region assumptions. Prices do not establish sales, revenue, availability, or savings until checkout; do not purchase, subscribe, redeem keys, or schedule price alerts unless requested.

NFT 收藏流动性研究
商业投诉模式分析