> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Outils d’analyse approfondie

> Outils d’analyse détaillée : présence des pages, profils de source, positionnement des concurrents et matrice de visibilité GEO.

<Note>
  Consultez [Compatibilité des filtres](/fr/mcp/tools/filters) pour le contrat de filtres de référence et la couverture de chaque outil MCP.
</Note>

## 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) |

<Tip>
  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.
</Tip>

### Scope OAuth

Requis : `read:visibility`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.