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

# Keyword Tracking

> Movers, your tracked keyword list, and rank history.

The agent watches keywords from two sources:

## 1. Movers (algorithmic)

Pulled from `/v1/keywords/movers` per run. Filtered to **±5 rank delta** to cut noise — small daily wiggles don't hit the briefing.

What surfaces:

* **Gainers** — keywords whose rank improved by 5+ in the last 7 days
* **Losers** — keywords whose rank dropped by 5+
* **New entries** — keywords that started ranking
* **Dropped out** — keywords that fell off the chart

Each entry includes the rank delta, current rank, and search volume.

## 2. Tracked keywords (user-curated)

The keywords you explicitly added to your tracking list in the web app, fetched from `user_tracked_keywords` (web Supabase). For each one the agent enriches with:

* **Volume score** (0-100) from `app_store_keyword_stats`
* **Difficulty score** (0-100)
* **Current rank** in the country
* **Last 7 days of rank history** (deduped to one rank per day, best position kept)

Surfaced like:

```
## User-Tracked Keywords
"screenshot search" #19 ↓3 | vol:55 diff:46
"photo stitching" #42 ↑8 | vol:71 diff:62
"instagram screenshots" unranked | vol:39 diff:31
```

Up arrows mean rank improved over the 7-day window, down arrows mean it worsened.

## How the LLM uses it

* Movers are wired into the `keywordMovers` field of the report
* Tracked keywords drive `prioritizedActions` like *"Defend rank #19 for 'screenshot search'"* or *"Push 'photo stitching' from #42 → top 30"*
* Combined with the ASO opportunity list, they feed metadata change suggestions