安装指南

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

什么是

Xbox Game Research 使用 Crawlora 搜索 Xbox 的公开目录、查看游戏详情并抽样查看评价，帮助你在不购买游戏或更改订阅的情况下，基于充分信息建立候选清单。它有助于比较地区价格和货币、兼容设备、无障碍属性、产品版本以及当前订阅收录证据。
作为 Openclaw Skills 之一，它注重研究的可追溯性：结果会保留来源 URL、产品标识符和采集时间。它会区分未知信息与不支持的功能，并将评价样本与综合评分分开。

应用场景

根据地区、平台、游戏类型或无障碍需求筛选 Xbox 或 PC 游戏。
比较选定游戏在不同地区的价格和购买优惠。
检查游戏是否有当前被订阅目录收录的证据，而不假设用户拥有订阅。
确认结果对应的是预期的基础游戏、捆绑包、附加内容、预购版本还是订阅产品。
推荐游戏前查看兼容设备和无障碍属性。
抽样查看选定产品的评价，并将样本与综合评分区分开来。

工作原理

确定用户所在地区、设备或平台、游戏类型偏好、无障碍需求，以及用户想要购买优惠还是订阅收录证据。
使用 xbox_search 或 xbox_browse 搜索或浏览 Xbox 公开目录，然后根据返回的 12 位字母数字产品 ID 识别候选项。
使用 xbox_game 获取所选候选项的详情；核实返回的标题和产品类型，不要将相同的 StoreId 格式视为记录代表同一版本的证明。
仅使用有文档说明的浏览筛选条件；多个值需重复使用数组查询键，并复用服务返回的不透明分页游标。仅使用有文档说明的精选合集 ID。
仅对选定产品抽样查看评价，保留可用的评价日期和评分，并将样本与综合评分分开标注。
提供候选清单，列出版本和产品 ID、兼容设备、价格和货币、订阅证据、无障碍属性、评价样本量、来源 URL 和采集时间。将缺失属性视为未知。

配置指南

在环境中设置必需的 Crawlora API 密钥。连接 Crawlora MCP 工具时，优先使用命名工具；否则使用捆绑的 scripts/crawlora.sh 包装脚本，该脚本会将密钥发送至 Crawlora API。
export CRAWLORA_API_KEY="your-crawlora-api-key"

搜索 Xbox 目录

scripts/crawlora.sh /xbox/search query="Forza" locale=en-US

浏览有文档说明的精选合集

scripts/crawlora.sh /xbox/collection id=XboxPlayAnywhere locale=en-US

使用搜索或浏览返回的产品 ID

scripts/crawlora.sh /xbox/game product_id="$PRODUCT_ID" locale=en-US
scripts/crawlora.sh /xbox/reviews product_id="$PRODUCT_ID"
请参阅 reference/endpoints.md，了解准确的工具名称、方法和参数。检查 HTTP 状态和应用程序 code；响应内容位于 data 中。遇到身份验证错误时停止；遇到 HTTP 429 时退避等待；上游暂时性故障时重试一次。将调用次数和页面数限制在请求范围和额度预算内。

数据架构

此技能处理通过 Crawlora 返回的 Xbox 目录和评价响应。若以下字段可用，请予以保留：
信息 处理方式
产品身份 记录返回的 12 位字母数字 product_id 或 StoreId、标题和产品类型。区分基础游戏、捆绑包、附加内容、预购版本和订阅。
地区和优惠 保留地区、价格、货币和价格依据；不要脱离地区背景比较价格。
兼容性 保留 available_on 设备或平台信息。商店显示可用并不保证能在用户的硬件上正常运行。
无障碍功能 记录返回的无障碍属性。缺少属性表示未知，而非不支持。
订阅证据 保留返回的 included_with_subscription_ids。将其视为当前目录证据，而非订阅所有权或所有地区、版本均包含该内容的证明。
评价 对选定产品，保留样本量及可用的评价日期和评分；将样本与综合评分区分开来。
来源信息 保留来源 URL、标识符和采集时间，以便追溯候选清单结果。
分页和合集 从响应中复制不透明分页游标，并仅使用有文档说明的精选合集 ID 和浏览筛选条件。
此技能未指定单独的生成文件格式或持久化数据存储。其交付成果是有来源依据、可供使用的候选清单；不要臆造缺失的产品属性或可下载媒体文件。

高级特性

在可用时支持命名 Crawlora MCP 工具，并提供捆绑的 shell 脚本作为备用方案。
使用有文档说明的 Xbox 搜索、浏览、合集、游戏详情和评价接口。
支持针对地区的目录研究，以及使用重复数组查询键实现的有文档说明的多值筛选。
保留不透明分页游标、产品标识符、来源 URL 和采集时间，以便追溯。
限制调用次数和页面数，关注额度预算，处理身份验证错误，对速率限制进行退避，并对上游暂时性故障重试一次。
谨慎处理订阅收录、兼容性、无障碍功能和评价样本，避免夸大目录证据所能证明的内容。
不会购买、安装、登录或更改订阅；仅链接至服务返回的可用媒体 URL。

name: xbox-research description: Research Xbox game listings, regional prices, compatibility, accessibility features, curated collections, subscription inclusion, and review samples through Crawlora. Use to shortlist Xbox or PC games or compare editions and Game Pass catalog evidence without purchases.

Xbox game research

Access and contract

Set CRAWLORA_API_KEY to your Crawlora key. Prefer the named 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 tool names, 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 pages and calls by the requested scope and credit budget. Preserve source URLs, identifiers, and collection times.

Build a game shortlist from Xbox's public catalog, detail, and review surfaces.

Match the requested platform and edition

Establish locale, device/platform, genre, accessibility needs, and whether the user wants purchase offers or subscription inclusion. Use xbox_search or xbox_browse, then resolve the returned 12-character alphanumeric product_id.
Fetch xbox_game for selected candidates. Keep base games, bundles, add-ons, preorder editions, and subscriptions separate. Xbox and Microsoft Store share StoreId format, but a shared format alone does not prove two records are the same edition; verify returned title and product kind.
Use only documented browse filters. Repeat array query keys for multiple values (for example genre=Shooter genre=Strategy), and copy opaque pagination cursors from responses. Curated xbox_collection IDs are a closed documented set, not arbitrary genres or guessed subscription identifiers.
Preserve available_on, accessibility evidence, currencies, locale, price basis, and included_with_subscription_ids when returned. An inclusion ID is evidence from the current catalog, not proof the user owns that subscription or that every edition is included in every region.
Sample reviews only for the chosen product. Preserve review date/rating where available and distinguish the sample from the aggregate rating.
scripts/crawlora.sh /xbox/search query="Forza" locale=en-US
scripts/crawlora.sh /xbox/collection id=XboxPlayAnywhere locale=en-US

# Use a returned StoreId, for example:
# scripts/crawlora.sh /xbox/game product_id="$PRODUCT_ID" locale=en-US
# scripts/crawlora.sh /xbox/reviews product_id="$PRODUCT_ID"

Deliver a usable shortlist

Show edition/product ID, compatible devices, price/currency, subscription inclusion evidence, accessibility attributes, review sample size, source URL, and collection time. Missing attributes are unknown rather than unsupported. A listed feature or store availability is not a guarantee of performance on the user's hardware. Trailers may be HLS manifests; link only usable returned media rather than inventing downloadable files. No purchase, installation, sign-in, or subscription change is part of this workflow.

连锁门店覆盖范围分析
电影票房比较