> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appeeky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ASO Intent Clusters

> Group keyword opportunities into semantic intent themes — optional add-on to ASO Brief

**Intent clusters** are an optional layer on top of the [ASO Decision Brief](/docs/aso-brief): opportunity keywords are grouped by **meaning** so you can prioritize **themes** (“relaxation / sleep” vs “brain games”) instead of a flat list.

***

## When to use it

* You have **many** keyword opportunities and want **fewer, strategy-sized buckets**.
* You need a **single “start here” group** (`prioritizeClusterId` in the API response).
* You are aligning copy, screenshots, and keyword field around **consistent user intents**.

***

## How it works (short)

1. The brief loads [keyword opportunities](/docs/aso-opportunities) for the app.
2. With `intentClusters=1`, those keywords are analyzed and split into a small number of **intent groups**.
3. Each group gets a **label** (typically the strongest opportunity keyword in that group) and **avgOpportunityScore**.
4. The brief adds an **`intentClusters`** object and usually a **prioritized action** like “Prioritize this intent group: …”.

***

## API

Use the same endpoint as the brief:

```
GET /v1/aso/brief/:appId?intentClusters=1&country=us
```

* **`intentClusters=1`** or **`true`** — enable clustering (+2 credits on top of the brief base cost × country multiplier).
* **`countries=us,gb,de`** — multi-country brief; clustering runs **per country** (each storefront can have different opportunity mixes).

See full parameters and response fields in [ASO Decision Brief](/docs/aso-brief).

***

## MCP

Tool: **`aso_brief`**

| Argument          | Description                                                                  |
| ----------------- | ---------------------------------------------------------------------------- |
| `intent_clusters` | `true` to enable semantic intent clustering (maps to `intentClusters` query) |
| `countries`       | Optional comma-separated ISO codes for multi-country briefs                  |

Auth: same as [MCP Server](/docs/mcp) (`Authorization: Bearer <api-key>`).

***

## See also

* [ASO Decision Brief](/docs/aso-brief) — main orchestration endpoint
* [Keyword opportunities](/docs/aso-opportunities) — source keywords for clustering
* [MCP Server](/docs/mcp) — `aso_brief` tool reference