benchmarks.affogata.net

{
  "name": "benchmarks_list_categories",
  "kind": "answer",
  "impl": "imperative",
  "description": "List every benchmark category with its industry, title count, average customer-voice score and current leader. Start here when you do not yet know which category a brand belongs to.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "industry": {
        "type": "string",
        "description": "Optional industry filter, e.g. 'Gaming', 'Fintech', 'Travel & Mobility'. Omit for every category."
      }
    }
  },
  "page": "/"
}

{
  "name": "benchmarks_list_titles",
  "kind": "answer",
  "impl": "imperative",
  "description": "List benchmarked games and apps with their current score, the change on their latest scored point (a release or a week, per the title cadence) and their week-over-week move. Filter by category, industry, free text or minimum score, sort by score, delta, momentum or volatility, and set the direction.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "category": {
        "type": "string",
        "description": "Category id or name, e.g. 'trading-apps' or 'Match-3 & Puzzle'."
      },
      "industry": {
        "type": "string",
        "description": "Industry name, e.g. 'Gaming' or 'Fintech'."
      },
      "search": {
        "type": "string",
        "description": "Free text over title name, publisher and topic clusters."
      },
      "min_score": {
        "type": "number",
        "minimum": 0,
        "maximum": 10,
        "description": "Only titles scoring at least this (0-10)."
      },
      "sort": {
        "type": "string",
        "enum": [
          "score",
          "delta",
          "momentum",
          "name",
          "category",
          "volatility"
        ],
        "default": "score",
        "description": "score = current impact, delta = change on the latest release or week, momentum = size of the weekly move, volatility = spread across the tracked window."
      },
      "order": {
        "type": "string",
        "enum": [
          "asc",
          "desc"
        ],
        "description": "asc = lowest first, which is how you ask for the worst scores. Defaults to highest first for every sort key except name and category."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "default": 20,
        "description": "Maximum rows to return."
      }
    }
  },
  "page": "/"
}

{
  "name": "benchmarks_get_title",
  "kind": "answer",
  "impl": "imperative",
  "description": "Full customer-voice profile for one game or app: current score, release history, the topic clusters pushing it up and down, the Affogata insight, movement against its category, and store-review volume where a live pull exists.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "title": {
        "type": "string",
        "description": "Title id or name, e.g. 'revolut' or 'Royal Match'."
      }
    },
    "required": [
      "title"
    ]
  },
  "page": "/"
}

{
  "name": "benchmarks_find_by_topic",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search the topic clusters across every benchmarked title to find who is being praised or punished for a given theme - 'paywall', 'support', 'ads', 'bugs', 'pay to win'. This is the cross-category view a per-brand lookup cannot give you.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "topic": {
        "type": "string",
        "description": "Theme to search for, e.g. 'support', 'paywall', 'ads', 'odds'."
      },
      "side": {
        "type": "string",
        "enum": [
          "gaining",
          "slipping",
          "both"
        ],
        "default": "both",
        "description": "gaining = praised for it, slipping = punished for it."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "default": 25,
        "description": "Maximum rows."
      }
    },
    "required": [
      "topic"
    ]
  },
  "page": "/"
}

{
  "name": "benchmarks_get_overview",
  "kind": "answer",
  "impl": "imperative",
  "description": "Headline state of the whole benchmark: how many titles are strong, mixed or critical this week, the happiest and unhappiest customer bases, the biggest weekly mover, and the topics rising and falling across the whole corpus.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/"
}

{
  "name": "benchmarks_get_category_analytics",
  "kind": "answer",
  "impl": "imperative",
  "description": "Deep read on one category: average and median score, spread, leader and laggard, the strong/mixed/critical split, this week's gainers and droppers, and the topic clusters most often lifting or dragging titles in that category.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "category": {
        "type": "string",
        "description": "Category id or name, e.g. 'dating-apps' or 'Social Casino'."
      }
    },
    "required": [
      "category"
    ]
  },
  "page": "/"
}

{
  "name": "benchmarks_get_movers",
  "kind": "answer",
  "impl": "imperative",
  "description": "Rank titles by week-over-week movement to find what changed since the last report - the fastest way to spot a release that just went wrong or a fix that landed.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "direction": {
        "type": "string",
        "enum": [
          "gainers",
          "droppers"
        ],
        "default": "droppers",
        "description": "gainers = improving, droppers = deteriorating."
      },
      "category": {
        "type": "string",
        "description": "Optional category id or name to scope the ranking."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 20,
        "default": 5,
        "description": "How many rows."
      }
    }
  },
  "page": "/"
}

{
  "name": "benchmarks_compare_titles",
  "kind": "act",
  "impl": "imperative",
  "description": "Compare 2 to 5 titles side by side across score, release delta, weekly movement, category position, store rating and volatility, plus the topic clusters they share and the ones unique to each. Works across categories.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "titles": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "minItems": 2,
        "maxItems": 5,
        "description": "Two to five title ids or names, e.g. ['tinder', 'hinge', 'bumble']."
      }
    },
    "required": [
      "titles"
    ]
  },
  "page": "/"
}

{
  "name": "benchmarks_export_dataset",
  "kind": "act",
  "impl": "imperative",
  "description": "Return the raw benchmark rows as structured JSON so you can run your own analysis - correlations, cohort comparisons, charts, or a written report. Filter by category or industry to keep the payload small.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "category": {
        "type": "string",
        "description": "Optional category id or name."
      },
      "industry": {
        "type": "string",
        "description": "Optional industry name."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "description": "Maximum rows. Omit for the whole corpus."
      },
      "include_history": {
        "type": "boolean",
        "default": true,
        "description": "Include the three-point release/week history for each title."
      }
    }
  },
  "page": "/"
}

{
  "name": "benchmarks_explain_methodology",
  "kind": "answer",
  "impl": "imperative",
  "description": "Explain what the score means, where the data comes from, what the score bands are, and what its limits are. Call this before presenting any number to a user so the framing is accurate.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/"
}

{
  "name": "benchmarks_get_current_view",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read what the page is showing right now: the route, the active filters, and the exact titles pinned in the comparison. The person at the keyboard drives the same page you do - they can remove a comparison chip, add a title or change a filter at any moment - so call this before answering any question about 'the current view', 'this comparison' or 'what is on screen' instead of trusting what an earlier call set up.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/"
}

{
  "name": "benchmarks_open_category",
  "kind": "act",
  "impl": "imperative",
  "description": "Switch the page to a benchmark category and show its titles. Use this whenever the user asks to see, open or switch to a category - the browser view follows along instead of the answer living only in chat.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "category": {
        "type": "string",
        "description": "Category id or name, e.g. 'travel-apps', 'Social Casino', 'Education'."
      }
    },
    "required": [
      "category"
    ]
  },
  "page": "/"
}

{
  "name": "benchmarks_open_title",
  "kind": "act",
  "impl": "imperative",
  "description": "Open the detail page for one game or app, showing its score history, topic clusters and movement. Use it to put a specific brand in front of the user after you have talked about it.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "title": {
        "type": "string",
        "description": "Title id or name, e.g. 'duolingo' or 'Genshin Impact'."
      }
    },
    "required": [
      "title"
    ]
  },
  "page": "/"
}

{
  "name": "benchmarks_set_view",
  "kind": "act",
  "impl": "imperative",
  "description": "Change what the browsing page shows: free-text search, a topic filter, an industry, a minimum score, the sort order, and grid or table layout. This is the agent equivalent of the on-page controls, so the user ends up looking at exactly the slice you are describing.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "search": {
        "type": "string",
        "description": "Free text over name, publisher and topic clusters. Pass '' to clear."
      },
      "topic": {
        "type": "string",
        "description": "Only titles whose clusters mention this topic, e.g. 'ads'. Pass '' to clear."
      },
      "industry": {
        "type": "string",
        "description": "Industry name, e.g. 'Gaming'. Pass '' to clear."
      },
      "min_score": {
        "type": "number",
        "minimum": 0,
        "maximum": 10,
        "description": "Hide titles scoring below this. Pass 0 to clear the threshold - no title scores below 0, so 0 and 'no threshold' are the same filter, and this is how you drop it without resetting everything else."
      },
      "sort": {
        "type": "string",
        "enum": [
          "score",
          "delta",
          "momentum",
          "name",
          "category",
          "volatility"
        ],
        "description": "Sort key for the list."
      },
      "order": {
        "type": "string",
        "enum": [
          "asc",
          "desc"
        ],
        "description": "Sort direction."
      },
      "mode": {
        "type": "string",
        "enum": [
          "grid",
          "table"
        ],
        "description": "Card grid or dense table."
      }
    }
  },
  "page": "/"
}

{
  "name": "benchmarks_compare_in_ui",
  "kind": "act",
  "impl": "imperative",
  "description": "Put titles side by side on the comparison page so the user can see the difference rather than read it. The default mode replaces the whole selection, which is right for 'compare X and Y' and wrong for 'add a competitor' - use mode 'add' to put titles alongside the ones already on screen, and mode 'remove' to drop titles and keep the rest. Pair this with benchmarks_compare_titles when you want both the numbers and the visual.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "titles": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "minItems": 1,
        "maxItems": 5,
        "description": "Title ids or names. At least two when replacing, since a comparison needs two; one is enough to add or remove."
      },
      "mode": {
        "type": "string",
        "enum": [
          "replace",
          "add",
          "remove"
        ],
        "default": "replace",
        "description": "replace (default): these titles become the whole comparison. add: keep what is on screen and add these. remove: drop these and keep the rest."
      }
    },
    "required": [
      "titles"
    ]
  },
  "page": "/"
}

{
  "name": "benchmarks_reset_view",
  "kind": "act",
  "impl": "imperative",
  "description": "Clear every filter, comparison and highlight and return the page to the full benchmark overview. Use it when the user says 'start over' or 'show everything again'.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/"
}