plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "fanatical",
  "version": "1.0.2",
  "description": "Read-only access to the Fanatical catalogue of PC games, DLC and bundles.",
  "author": {
    "name": "Fanatical",
    "email": "dev@fanatical.com",
    "url": "https://www.fanatical.com"
  },
  "homepage": "https://www.fanatical.com/for-ai",
  "keywords": [
    "gaming",
    "pc-games",
    "catalogue",
    "steam",
    "bundles",
    "discounts",
    "sales"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Fanatical",
        "shortDescription": "Browse the PC game catalogue",
        "longDescription": "Fanatical is a licensed digital retailer of PC games, DLC and bundles. This plugin is a read-only window on the Fanatical catalogue. Use it to find games that match a genre, franchise, publisher, developer, price or discount; to check the current price of a named game; to see which sales are active; and to see which bundles are available. Prices use the local currency of the user's region, and results show only the products that are available in that region.\n\nThe plugin does not sell anything. It cannot buy a product, take a payment, read an account or order history, or deliver a game key. It needs no sign-in and collects no personal data. Each result includes a link to the public product page on fanatical.com, where the user can read more.\n\nData comes from the same source as the Fanatical website and refreshes every ten minutes. The catalogue contains more than one hundred thousand products. Supported currencies are USD, GBP, EUR, CAD, AUD and JPY.",
        "developerName": "Fandom",
        "category": "Entertainment",
        "capabilities": [
          "Search PC games, DLC and bundles by genre, franchise, publisher, developer, price and discount",
          "Look up a product by name or Steam ID, with its editions and DLC",
          "List the sales that are active now",
          "Browse the genres, franchises, publishers and developers in the catalogue"
        ],
        "websiteURL": "https://www.fanatical.com",
        "supportURL": "https://support.fanatical.com",
        "privacyPolicyURL": "https://www.fandom.com/privacy-policy",
        "termsOfServiceURL": "https://support.fanatical.com/hc/en-us/articles/115005056629-Terms-and-Conditions",
        "defaultPrompt": [
          "What sales are running on Fanatical right now?",
          "Find family-friendly PC games under $10 on Fanatical.",
          "Is The Jackbox Party Pack 2 in a bundle on Fanatical?"
        ],
        "brandColor": "#FF9C00",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Filtered search. The model gets a tag slug from the taxonomy, then searches with the tag and a price limit.",
              "prompt": "Find family-friendly PC games under $10 on Fanatical.",
              "tools_triggered": "list_facets, search_products",
              "expected_behavior": "list_facets with facet \"tags\" returns the \"family-friendly\" slug. search_products is called with tag \"family-friendly\" and max_price 10. The answer lists games at or below $10 in USD, for example Sonic Mania, Journey or Cities: Skylines, each with a link to its fanatical.com product page."
            },
            {
              "description": "Named product lookup in a different region and currency.",
              "prompt": "How much is Two Point Museum on Fanatical in Canada?",
              "tools_triggered": "search_products, get_product",
              "expected_behavior": "get_product is called with slug \"two-point-museum\" and region \"CA\" (the model can call search_products first to find the slug). The answer gives the price in CAD and a link to the product page."
            },
            {
              "description": "Batch lookup. Five named games resolve in one call, not five.",
              "prompt": "Check the Fanatical prices of Two Point Hospital, Planet Coaster 2, LEGO Star Wars: The Skywalker Saga, Sonic Frontiers and Microsoft Flight Simulator 2024.",
              "tools_triggered": "get_products",
              "expected_behavior": "One get_products call with five slugs. The answer gives a USD price for each game. Any game that is not found is listed in not_found, and the model says so. It does not invent a price."
            },
            {
              "description": "Sale discovery.",
              "prompt": "What sales are running on Fanatical right now?",
              "tools_triggered": "list_sales",
              "expected_behavior": "list_sales returns the active sales, each with a name, product count, discount range and end time. The answer summarises them. If the list is empty, the model says that no sale is running."
            },
            {
              "description": "Bundle membership. The model finds the bundle that contains a named game and quotes the bundle offer as the catalogue states it.",
              "prompt": "Is The Jackbox Party Pack 2 in a bundle on Fanatical?",
              "tools_triggered": "search_products, get_product",
              "expected_behavior": "get_product for \"the-jackbox-party-pack-2\" returns in_bundle: The Jackbox Party Trilogy. The answer names the bundle, quotes its bundle_price_messages text as written (for example \"Get 3 games for $23.98\"), and can list the three games from get_product on the bundle slug."
            }
          ],
          "negative": [
            {
              "description": "Purchase request. No tool can buy a product or take a payment. Every tool is read-only.",
              "prompt": "Buy Two Point Museum for me on Fanatical and pay with my saved card.",
              "expected_behavior": "The model says that it cannot buy products or take payments with this plugin. It can give the price and the product page link so the user can decide on fanatical.com."
            },
            {
              "description": "Account data request. The plugin has no sign-in and cannot read accounts, orders or keys.",
              "prompt": "Show my Fanatical order history and my unredeemed game keys.",
              "expected_behavior": "No tool is called. The model says that the plugin reads only the public catalogue and has no access to accounts, orders or keys."
            },
            {
              "description": "Request for a free game key. The plugin returns catalogue data only and never returns game keys.",
              "prompt": "Give me a free Steam key for Microsoft Flight Simulator 2024 from Fanatical.",
              "expected_behavior": "The model says that the plugin cannot give game keys. It can give the current price and any active discount from the catalogue."
            }
          ]
        },
        "demo_recording_url": "https://drive.google.com/file/d/1DBAGBSn5sLQMMUCCxZeza0lLPIRf36FD/view?usp=sharing",
        "commerce": false,
        "commerce_description": "The plugin is a read-only product catalogue. No tool sells a product, takes a payment, changes a basket or reads an account. Results include links to public pages on fanatical.com. Any purchase happens on fanatical.com, outside ChatGPT."
      },
      "publication": {
        "release_notes": "Initial release. Read-only access to the Fanatical catalogue: product search, product lookup by slug or Steam ID, bundle membership, active sales, and taxonomy browsing. No sign-in is needed. Response reference: https://www.fanatical.com/for-ai/tools"
      },
      "apps": "./.app.json"
    }
  }
}