Skip to content

Open-source agentic AI Search Execution Platform. Track AI visibility, find opportunities, and let agents turn signals into prioritized actions and drafted fixes across ChatGPT, Claude, Gemini, Google AI Overviews, Google AI Mode, Perplexity, Grok, and Microsoft Copilot.

docs(skills): teach the AEO coach skills about get_prompt_usage (#1055)

Cihan417b81d84f4e
diff --git a/skills/ansvisor-aeo-coach-standalone/SKILL.md b/skills/ansvisor-aeo-coach-standalone/SKILL.md
index c144893b6..21d907969 100644
--- a/skills/ansvisor-aeo-coach-standalone/SKILL.md
+++ b/skills/ansvisor-aeo-coach-standalone/SKILL.md
@@ -98,6 +98,7 @@ mirrors the MCP tool of the same purpose and returns the same data.
| `GET /prompts` | `brand_id`, `topic_id`, `is_active`, `limit` (default 100, max 500) | `{ prompts: [...] }` |
| `GET /prompt-performance` | `brand_id`, dates, `topic_id`, `sort_by` (`visibility`/`mentions`/`citations`/`appearances`), `order`, `limit`, `model`, `region` | per-prompt visibility, mentions, citations, competitor score |
| `GET /prompt-volumes` | `brand_id`, `limit` | `{ volumes: [...] }` — Google volumes, `est_ai_volume`, competition |
+| `GET /prompt-usage` | `brand_id` | `{ plan: { key, name, locationLimit, cta }, brand: { active, paused, total }, account: { activePrompts, brands, locationsUsed }, updatedAt }` — the plan's prompt allowance, as on the Tracked Prompts usage cards. The limit counts prompt **locations** account-wide (one slot per location of each active prompt; paused prompts use none, and resuming one needs free slots like adding one); `locationLimit: null` = unlimited |
| `GET /topic-suggestions` | `brand_id` | `{ suggestions: [...] }` pending topic ideas |
| `POST /topic-suggestions/{id}/accept` *(write)* | — | creates one topic |
| `POST /topic-suggestions/{id}/dismiss` *(write)* | — | hides the suggestion |
@@ -311,6 +312,14 @@ or any "do I have gaps" question:
rather than inventing topics.
5. `GET /prompt-volumes` tells you which prompts carry real demand —
use it to say which gaps matter most.
+6. Before suggesting new prompts, call `GET /prompt-usage?brand_id=…`
+ to see how many slots are left (`locationLimit − locationsUsed`,
+ never below 0). A `null` `plan.locationLimit` means no limit
+ (self-hosted, or an Enterprise account whose limit isn't set yet):
+ skip the check. Otherwise, if none are left (or fewer than you'd
+ suggest), say so: pausing low-value prompts frees their slots, and
+ `plan.cta` names the next step (`upgrade_growth`, `upgrade` or
+ `contact`).
### 6. Prompt deep-dive
diff --git a/skills/ansvisor-aeo-coach/SKILL.md b/skills/ansvisor-aeo-coach/SKILL.md
index f7002b273..3f7a422d1 100644
--- a/skills/ansvisor-aeo-coach/SKILL.md
+++ b/skills/ansvisor-aeo-coach/SKILL.md
@@ -106,6 +106,16 @@ timestamps (`date_from` / `date_to`).
Use for "best / worst prompt this week?".
- **`get_prompt_volumes`** — per-prompt search demand: Google volumes,
`est_ai_volume` and competition. Use to prioritise.
+- **`get_prompt_usage`** — the plan's prompt allowance, as on the
+ Tracked Prompts usage cards: the brand's `active`, `paused` and
+ `total` prompts, and the account's `activePrompts` across `brands`
+ and `locationsUsed` against `plan.locationLimit` (`null` =
+ unlimited). The limit counts **prompt locations** across every brand
+ of the account: an active prompt uses one slot per location it
+ targets, a paused one uses none, and resuming a paused prompt needs
+ free slots like adding one. Slots left = `locationLimit −
+ locationsUsed` (never below 0). Use for "how many prompts can we
+ still add?".
- **`list_topic_suggestions`** — pending AI topic suggestions.
**`accept_topic_suggestion`** / **`dismiss_topic_suggestion`** act on
one *(writes)*.
@@ -293,6 +303,13 @@ or any "do I have gaps" question:
rather than inventing topics.
5. `get_prompt_volumes` tells you which prompts carry real demand —
use it to say which gaps matter most.
+6. Before suggesting new prompts, call `get_prompt_usage(brand_id)`
+ to see how many slots are left. A `null` `plan.locationLimit` means
+ no limit (self-hosted, or an Enterprise account whose limit isn't
+ set yet): skip the check. Otherwise, if none are left (or fewer than
+ you'd suggest), say so: pausing low-value prompts frees their slots,
+ and `plan.cta` names the next step (`upgrade_growth`, `upgrade` or
+ `contact`).
### 6. Prompt deep-dive