Outils d’analyse approfondie

Consultez Compatibilité des filtres pour le contrat de filtres de référence et la couverture de chaque outil MCP.

get_page_presence

Obtient la présence des pages : quelles pages du site de la marque sont citées par l’IA, avec le nombre de citations, les questions distinctes et le statut d’optimisation.

Paramètres

Paramètre	Type	Requis	Description
`brandId`	string	Oui	L’identifiant de marque issu de `list_brands`
`limit`	number	Non	Nombre maximal de pages renvoyées (par défaut : 50)
`status`	string	Non	Filtre : `WORKING`, `NEEDS_ATTENTION`, `NOT_CITED`, `DISCOVERED`

Statut des pages

Statut	Signification
`WORKING`	Dans le sitemap et au moins 3 citations
`NEEDS_ATTENTION`	Dans le sitemap et 1 ou 2 citations
`NOT_CITED`	Dans le sitemap et aucune citation
`DISCOVERED`	Absente du sitemap mais citée par l’IA

Résultat

Champ	Description
`stats`	Nombre total de pages, de pages citées, non citées et découvertes
`pages[]`	Pages avec chemin, URL, statut, nombre de citations, questions distinctes, position moyenne et fournisseurs

Scope OAuth

Requis : read:sources

get_source_profile

Analyse en détail un domaine source : autorité de la source calculée par Qwairy, statistiques de citation, URL les plus citées, concurrents cités conjointement et disponibilité de backlinks.

Paramètres

Paramètre	Type	Requis	Description
`brandId`	string	Oui	L’identifiant de marque issu de `list_brands`
`sourceDomainId`	string	Oui	UUID du domaine source issu de `get_source_domains`, ou un nom de domaine comme `example.com`
`period`	integer ou string	Non	Fenêtre d’analyse globale ; 30 jours par défaut
`limit`	number	Non	Nombre maximal d’URL renvoyées (par défaut : 10)

Résultat

Champ	Description
`source`	Domaine, nom, type, relation (SELF/DIRECT/tiers) et `aiSourceAuthorityScore` (0 à 100 ou `null`)
`stats`	Nombre total de mentions, questions et réponses distinctes, position moyenne, fournisseurs
`topUrls[]`	URL les plus citées avec leur nombre de mentions
`coCitedCompetitors[]`	Concurrents présents dans les mêmes réponses que cette source
`backlink`	Disponibilité, meilleur prix, nombre de plateformes

Scope OAuth

Requis : read:sources

get_competitor_position

Analyse en détail un concurrent : couverture du marché, part de voix, position et sentiment moyens, principales sources qui le citent, et chevauchement shopping et local.

Paramètres

Paramètre	Type	Requis	Description
`brandId`	string	Oui	L’identifiant de marque issu de `list_brands`
`competitorId`	string	Oui	Identifiant, domaine (par exemple « adidas.com ») ou nom (par exemple « Adidas ») du concurrent
`period`	integer ou string	Non	Fenêtre d’analyse globale ; 30 jours par défaut

Résultat

Champ	Description
`stats.coveragePercentage`	Pourcentage des questions suivies où ce concurrent apparaît
`stats.shareOfVoice`	Part du concurrent dans l’ensemble des mentions SELF et DIRECT
`stats.avgPosition`	Position moyenne dans les réponses IA
`stats.avgSentiment`	Score de sentiment moyen
`stats.providers[]`	Fournisseurs IA qui mentionnent ce concurrent
`topSources[]`	Domaines qui citent le plus souvent ce concurrent
`shoppingOverlap`	Nombre de produits shopping liés à ce concurrent, sur tout l’historique
`localOverlap`	Nombre d’commerces locaux liés à ce concurrent, sur tout l’historique

Scope OAuth

Requis : read:competitors

get_matrix

Obtient la matrice de visibilité GEO : des lignes (Topics, Tags, prompts ou étapes du tunnel) croisées avec des colonnes (fournisseurs IA), avec pour chaque cellule le score composite, les sous-scores, les classements, les citations et le principal concurrent.

Paramètres

Paramètre	Type	Requis	Description
`brandId`	string	Oui	L’identifiant de marque issu de `list_brands`
`granularity`	string	Non	Regroupement : `topics` (par défaut), `tags`, `prompts` ou `funnel`
`period`	integer ou string	Non	Fenêtre d’analyse globale ; 30 jours par défaut
`personaIds`	string[]	Non	UUID des Personas enregistrées sur la réponse ; `"default"` correspond aux réponses sans Persona
`countries`	string[]	Non	Pays des réponses (codes ISO 3166-1 alpha-2)
`competitorDomainId`	string	Non	UUID d’un domaine concurrent SELF issu de `get_competitors`, pour limiter la matrice à une concession ou une sous-marque
`tagOperator`	string	Non	Combine plusieurs filtres de Tags par `or` (par défaut) ou `and` ; les lignes par Tag utilisent toujours OU
`limit`	integer	Non	Nombre maximal de lignes renvoyées (par défaut : 20, maximum : 50)

Options de granularité

Valeur	Regroupe les lignes par
`topics`	Mots-clés et Topics (par défaut)
`tags`	Tags de prompts configurés
`prompts`	Questions suivies une par une
`funnel`	Étapes du tunnel (TOFU/MOFU/BOFU/POST_PURCHASE)

Résultat

Champ	Description
`appliedFilters`	Fenêtre d’analyse et filtres effectivement utilisés pour le résultat
`providers[]`	Liste des fournisseurs IA (colonnes)
`rows[]`	Lignes de la matrice, chacune avec `mentionRate`, `coverage` (`{count, total, percentage}`) et une cellule par fournisseur
`rows[].cells[]`	Par cellule : `score` (composite de 0 à 100), `subScores` (mentionRate, shareOfVoice, citationRate, sentiment), `ranking` (rang sur total pour chaque indicateur), `citations`, `position`, `topCompetitor` (nom ou null)

La matrice permet de repérer quels Topics sous-performent sur quels fournisseurs. Cherchez les cellules aux scores faibles ou aux classements médiocres où les concurrents ont des taux de mention élevés.

Scope OAuth

Requis : read:visibility

Bien démarrer

Référence des outils

Exemples

Workflows

get_page_presence

Paramètres

Statut des pages

Résultat

Scope OAuth

get_source_profile

Paramètres

Résultat

Scope OAuth

get_competitor_position

Paramètres

Résultat

Scope OAuth

get_matrix

Paramètres

Options de granularité

Résultat

Scope OAuth

​get_page_presence

​Paramètres

​Statut des pages

​Résultat

​Scope OAuth

​get_source_profile

​Paramètres

​Résultat

​Scope OAuth

​get_competitor_position

​Paramètres

​Résultat

​Scope OAuth

​get_matrix

​Paramètres

​Options de granularité

​Résultat

​Scope OAuth

get_page_presence

Paramètres

Statut des pages

Résultat

Scope OAuth

get_source_profile

Paramètres

Résultat

Scope OAuth

get_competitor_position

Paramètres

Résultat

Scope OAuth

get_matrix

Paramètres

Options de granularité

Résultat

Scope OAuth