list_competitors
List the organization’s competitors: ONE list that SEO and AI Search both compare, shared by every website (edited in Competitors in SEO or AI Search settings, or with update_competitors).
PENDING FIRST: while pending is set, the websites it names still research and score their
own competitor choices, so the list below (and research_usd, researched_sites,
researched_in_seo) is NOT what they use yet, and update_competitors is refused. pending says
who (sentence, websites) and what combining does (consequence, adds, listed_only,
monthly_change_usd); combine with combine_competitor_lists when the user agrees.
Once combined (pending is null), a compared competitor (compared=true) is researched in Google once a month for each website
with SEO tracking (research_usd each, researched_sites websites), names the competing page in
SEO content gaps, and is scored in the AI answers of websites with AI Search on (ai_checked:
whether any website has it on; with none, no AI answer scores it). A listed competitor (compared=false) is
kept but not compared. At most limit (10) are compared at once; SEO researches at most that
many per website, the oldest compared first.
Returns: competitors [{domain, name, aliases, exclusions, source, watching_ads, compared, researched_in_seo, compare_refused, caption}], compared first; suggestions [{domain, name}] (Brand Profile competitors not on the list); limit; cap_reason (at the cap: a competitor added now is listed, not compared; else null); seo_note (over the cap: why rows with researched_in_seo=false are not researched in SEO; their caption says whether AI Search still scores them; else null); research_usd; researched_sites; ai_checked; description, compare_effect, empty_sentence (the editor’s sentences); pending (see above). watching_ads is Brand Watch (list_watched_competitors), a separate, billed ad-library subscription.
Parameters#
None.
Generated by generate_mcp_docs from the server tool. Add to this page below this block; the block is rewritten on every run.