xbox-research
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_searchorxbox_browse, then resolve the returned 12-character alphanumericproduct_id. - Fetch
xbox_gamefor 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. Curatedxbox_collectionIDs are a closed documented set, not arbitrary genres or guessed subscription identifiers. - Preserve
available_on, accessibility evidence, currencies, locale, price basis, andincluded_with_subscription_idswhen 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.