List competitor brands already tracked on a project.
Use this before a gap analysis or snippet comparison so you do not invent rival names. Status is
TRACKED,SUGGESTED, orIGNORED.
Why you need it
Skills that mention “competitors” still need the list the user actually tracks. Guessing “HubSpot, Salesforce, Pipedrive” is wrong if the project only tracks two of them, or tracks a niche rival instead.
Use it when you need to:
- Pass a real
brandinto aiseo_list_snippets. - Scope a gap analysis to tracked rivals, not the open web.
- See which suggested brands the user has not accepted yet.
Capabilities
- List competitor brands with name, slug, domain, aliases, and status.
- Include suggested and ignored rows, not only active tracking.
- Give
brandSlugyou can pass asbrandon snippets.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
projectSlug | string | Yes | From aiseo_list_projects |
No extra filters. Ignore IGNORED rows in the client if you only want active rivals.
Input
{
"projectSlug": "acme"
}
Output
{
"project": {
"name": "Acme",
"slug": "acme"
},
"competitors": [
{
"aliases": ["Hubspot"],
"brandName": "HubSpot",
"brandSlug": "hubspot",
"domain": "hubspot.com",
"status": "TRACKED"
},
{
"aliases": [],
"brandName": "Pipedrive",
"brandSlug": "pipedrive",
"domain": "pipedrive.com",
"status": "SUGGESTED"
}
]
}
| Field | Meaning |
|---|---|
competitors[].brandName | Display name |
competitors[].brandSlug | Safe id; usable as brand on snippets |
competitors[].domain | Competitor site, if known |
competitors[].aliases | Extra names the tracker matches |
competitors[].status | TRACKED | SUGGESTED | IGNORED |
competitors is [] when none are tracked yet. Do not fill the gap from memory.
Example prompt
Call
aiseo_list_competitors. Use onlyTRACKEDbrands. For each, callaiseo_list_snippetsand tell me who wins the “best for startups” narrative. Do not add brands that are not in this list.
Related skills
Next
- aiseo_list_snippets for voice on each
brandName - aiseo_list_prompts for prompts they outrank you on