> For the complete documentation index, see [llms.txt](https://help.seoutils.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.seoutils.app/guide/google-search-console/gsc-rank-tracker/ai.md).

# AI: Explanations, Summary and Topics

Three optional AI helpers write about your tracker's own numbers. **Why did it move?** explains one keyword, the **weekly summary** writes up the week, and **Group with AI** sorts your keywords into topics. They use your own AI key or a local model, so the cost is whatever your AI provider charges, and nothing for a local model.

{% hint style="info" %}
The AI only gets facts the tracker already holds, such as positions, confirmed moves, page changes, Google updates, your notes and click-through rate. Every answer says it was written by AI, with the provider and model.
{% endhint %}

## Choose the AI model

All three helpers use one model. Open **Settings > Services**, go to **AI & NLP > Rank Tracker AI model** and pick a model in **GSC Rank Tracker AI**, then click **Save**.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-2e677e16b8571764a720222f8ac599014e770d73%2Fgsc-rankings-ai-settings-card.png?alt=media" alt="The GSC Rank Tracker AI card with the AI model field and the Save button"><figcaption><p>One model for Why did it move?, the weekly summary and Group with AI</p></figcaption></figure>

* The list shows the providers whose API key you added in **AI Settings**, plus the models of a local Ollama. See [Choose the AI model](https://help.seoutils.app/guide/bulk-seo-metadata-optimizer.md#choose-the-ai-model) to add a key or set up Ollama.
* Some models also offer a **reasoning effort**. A higher effort gives more careful answers and costs more output tokens.
* If the chosen provider has no API key, the helpers use the default AI model of **Settings > General**, and the note under each button says so. Until you save a choice, the card shows the default it would use.

The explanation panel, the grouping estimate and the weekly summary switch each show a line naming what will run, for example "Uses Ollama · llama3.1:8b, runs locally", or "billed to your API key" for a cloud provider.

## Why did it move?

Use it when a keyword's position changed and you want to know what the data says.

{% stepper %}
{% step %}

#### Open the explanation

Click a keyword to open its [details](https://help.seoutils.app/guide/google-search-console/gsc-rank-tracker/keyword-details.md), then click **Why did it move?** or **Explain** in the panel. You can also open the **⋯** menu of a row in the Keywords table and choose **Why did it move?**.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-09026ee94e1f006cb6dfab6308b024b77dc02808%2Fgsc-rankings-ai-why-explain.png?alt=media" alt="The keyword details with the Why did it move? button and the Explain button"><figcaption><p>Two buttons start the same request</p></figcaption></figure>

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-c640b528e35eda06803919a25987a7b13147825b%2Fgsc-rankings-ai-why-row-menu.png?alt=media" alt="The row menu of a keyword with Why did it move? at the top"><figcaption><p>The row menu</p></figcaption></figure>
{% endstep %}

{% step %}

#### Read the answer

The answer is two or three sentences, with an evidence line for each fact it relies on. The panel names the day it explains, for example "Around Oct 22". That is the keyword's latest day with final data, or the day of the mover or alert you opened it from.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-6537d7c891a6e175d6cabcdf4bf9bb06d5563bd7%2Fgsc-rankings-ai-why-answer.png?alt=media" alt="An answer with three evidence lines and the Written by AI footer"><figcaption><p>The answer (1), its evidence (2) and who wrote it (3)</p></figcaption></figure>

Click a date chip to jump to that day on the chart. The chart widens when it needs to, and Google updates and your notes appear when the chip is about one.
{% endstep %}
{% endstepper %}

The answer is saved. Click again with nothing changed and the panel says "Up to date: nothing has changed since this answer, so nothing was sent." Nothing is asked and nothing is billed. If new data arrives, the panel says "The data changed since this was written." and offers **Explain again**. Another model or reasoning effort asks again.

A rule can be explained too. An archived keyword cannot, until you restore it, and neither can a keyword with no final data yet.

## Weekly summary

A short write-up of the week, shown on the tracker page and available to your automations. It is off by default.

{% stepper %}
{% step %}

#### Turn it on

Switch on **Weekly AI summary** in the tracker's **Settings** (click the tracker's name at the top) and click **Save**, or on the **Review** step when you [create a tracker](https://help.seoutils.app/guide/google-search-console/gsc-rank-tracker/create-a-tracker.md#the-five-steps). The line under the switch names the model and says it runs once a week.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-d10c9be7c8b6d42bf25ced453b08d4329f039219%2Fgsc-rankings-ai-weekly-setting.png?alt=media" alt="The tracker settings with the Weekly AI summary switch turned on"><figcaption><p>The switch in the tracker settings</p></figcaption></figure>
{% endstep %}

{% step %}

#### Read the This week card

Every Monday, after the first refresh of the week, SEO Utils writes the summary for the 7 days ending on the latest final date. It appears in a **This week** card above the KPI strip, built from the confirmed moves, the alerts and the position bands.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-8750e12157c1488769ea971aec1024b6ff64ae0a%2Fgsc-rankings-ai-this-week.png?alt=media" alt="The This week card with a summary and three evidence lines"><figcaption><p>The title (1), the evidence (2) and the arrow that hides the card (3)</p></figcaption></figure>

A keyword or alert chip opens that keyword at that date. A position band or Google update chip focuses the chart, and the key figures chip scrolls to the KPI strip.
{% endstep %}
{% endstepper %}

* A week with no confirmed moves and no alerts reads "No confirmed moves or alerts this week." and sends nothing to the AI.
* If the request fails, the card shows the reason and **Try again**. SEO Utils also tries once more 30 minutes later.
* Until the first Monday after you turn it on, the card says when the first summary will be written. An older summary stays visible as **Last summary**.
* In [Automations](https://help.seoutils.app/guide/automations.md#gsc-rank-tracker-alerts-trigger), the summary is the `aiSummaryText` variable and the `aiSummary` part of a webhook. It is also the Weekly summary section of the [report](https://help.seoutils.app/guide/google-search-console/gsc-rank-tracker/print-and-pdf.md).

### Hide the AI label for clients

If the tracker's reports go to clients who do not need to know that an AI wrote the summary, turn off **Show the AI label in reports and emails**. It is in the tracker's **Settings** (click the tracker's name at the top), under **Weekly AI summary**. It is on by default, also for trackers you made before it existed, and a [duplicate](https://help.seoutils.app/guide/google-search-console/gsc-rank-tracker/manage-trackers.md#duplicate-a-tracker) keeps your choice.

With it off, the [report](https://help.seoutils.app/guide/google-search-console/gsc-rank-tracker/print-and-pdf.md), the PDF, the HTML page, the browser print and the PDF an automation creates still show the weekly summary with its title, dates, text and evidence chips, but:

* the "Written by AI (provider and model)" line is gone, and so is "No AI request was needed" in a quiet week;
* the "Written by AI from the data above" footer under the evidence is gone;
* the `aiSummaryText` variable of an [automation email](https://help.seoutils.app/guide/automations.md#gsc-rank-tracker-alerts-trigger) reads "This week (Oct 1 – Oct 7): …" instead of "This week (Oct 1 – Oct 7), written by AI (provider and model): …".

The switch changes only what a client reads. These always show the AI label, because you and your team need to know which text came from AI:

* the **This week** card, the **Why did it move?** panel and the **Group with AI** dialog in the app;
* the `aiSummary` part of a webhook, which keeps the provider and model, since the webhook is your own data feed;
* the answers of an AI assistant connected through [MCP](https://help.seoutils.app/guide/mcp-server.md).

The switch costs nothing and starts no AI request. A team member with the **Manager** role can change it in the browser.

## Group with AI

Group with AI sorts your keywords into topics, so you can filter the table by subject.

{% stepper %}
{% step %}

#### Start it

Click the arrow beside **Add keywords** and choose **Group with AI…**. It covers every active keyword. To group only some, tick rows and choose **Group with AI…** in the bulk actions. Rules and archived keywords are left out.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-e0181f7a21f39ff4f85f8a563a57f795c4d8f664%2Fgsc-rankings-add-keywords-menu.png?alt=media" alt="The Add keywords menu with Group with AI and Check metrics for missing"><figcaption><p>The menu beside Add keywords</p></figcaption></figure>
{% endstep %}

{% step %}

#### Check the estimate

The dialog shows how many keywords and AI requests the run needs and the approximate tokens, and says whether your provider bills for them. Nothing is sent until you click **Group N keywords**. Switch on **Only keywords without a topic** to leave keywords that already have one.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-7dcfc04c1b6da52656e62d3c7098e36308d8fd28%2Fgsc-rankings-ai-group-estimate.png?alt=media" alt="The Group with AI estimate with keywords, requests, tokens and the Group 87 keywords button"><figcaption><p>The estimate (1), the cost note (2) and the start button (3)</p></figcaption></figure>

If you use the [Embedding Database](https://help.seoutils.app/guide/embedding-database.md), SEO Utils groups similar keywords by their embeddings first and asks the AI only to name each group. Otherwise the AI reads the keywords in batches of 300.

You can close the window while it runs. When it is done, a message tells you to open **Group with AI** to review the topics.
{% endstep %}

{% step %}

#### Review and apply

Nothing is tagged until you apply. In the table:

* Edit a **Topic** name to rename it (1).
* Pick another topic in **Merge into** to join two topics (2).
* Untick a topic to leave its keywords alone (3).

Keywords the AI put in no topic are listed under **Unassigned** and keep their tags. Click **Apply topics** (4), or **Start over** to ask again.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-14824f583751e08065730642c4115c56b37d8eca%2Fgsc-rankings-ai-group-review.png?alt=media" alt="The topic review table with a renamed field, a merged topic, an unticked topic and the Apply topics button"><figcaption><p>Rename, merge or untick a topic, then apply</p></figcaption></figure>
{% endstep %}
{% endstepper %}

Each topic becomes a tag on its keywords. To see one topic's keywords, open the **Tags** filter and pick it from the **Topics** group, which sits above your own tags. The **Show in Tags filter** button in the message after Apply opens it for you.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-95c204b0986b644d56628bfd13916d61bd06b772%2Fgsc-rankings-ai-topics-filter.png?alt=media" alt="The Tags filter with a Topics group listing the topics"><figcaption><p>Topics have their own group in the Tags filter</p></figcaption></figure>

In the **Tag…** dialog, topics show apart from your own tags, and you can remove one from a keyword. Topics also appear in the CSV export's tags and are copied when you [duplicate a tracker](https://help.seoutils.app/guide/google-search-console/gsc-rank-tracker/manage-trackers.md#duplicate-a-tracker).

## Team members

Every role can read the saved answers, the This week card and the topics. Asking for a new answer, a new grouping or a retry needs **Run reports** and **Can use the owner's machine and accounts**, because they spend your AI provider. Applying topics needs the right to tag keywords. Turning on the weekly summary needs the owner's accounts too. See [Team](https://help.seoutils.app/guide/team.md).

## Best practices

* Treat the answer as a lead to check, not as proof. The evidence lines show what it rests on.
* Turn the weekly summary on for the trackers you report on, and leave it off for the rest.
* Run **Group with AI** after you add a batch of keywords, with **Only keywords without a topic** switched on.
