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

> Outils pour analyser les concurrents mentionnés dans les réponses IA et suivre leur évolution.

<Note>
  Consultez [Compatibilité des filtres](/fr/mcp/tools/filters) pour le contrat de référence des filtres globaux. Ces paramètres communs s’ajoutent aux paramètres propres à chaque outil présentés ci-dessous.
</Note>

## get\_competitors

Classe les concurrents selon leurs mentions dans un périmètre d’analyse. Sans fenêtre, l’outil renvoie les résultats sur tout l’historique ; utilisez une période glissante ou des dates personnalisées incluses, éventuellement combinées avec un Topic et/ou un Tag.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | L’identifiant de marque |
| `relationship` | string | Non | `SELF`, `DIRECT`, `INDIRECT`, `ECOSYSTEM`, `COMPLEMENTARY` ou `SELF_DIRECT` |
| `period` | integer ou string | Non | Jours glissants (1 à 3650), `"all"`, ou `"custom"` avec des dates ; omettez-le pour tout l’historique |
| `startDate` | string | Non | Date de début incluse (`YYYY-MM-DD`) ; à fournir avec `endDate` |
| `endDate` | string | Non | Date de fin incluse (`YYYY-MM-DD`) ; à fournir avec `startDate` |
| `provider` | string | Non | Ancien alias pour un seul fournisseur ou modèle |
| `providers` | string\[] | Non | Identifiants de fournisseurs ou de modèles IA ; valeurs combinées par OU |
| `topic` / `topicId` | string | Non | Alias pour un seul Topic, avec un UUID renvoyé par `list_topics` |
| `topicIds` | string\[] | Non | UUID de Topics ; valeurs combinées par OU |
| `tag` / `tagId` | string | Non | Alias pour un seul Tag, avec un UUID renvoyé par `list_tags` |
| `tagIds` | string\[] | Non | UUID de Tags ; valeurs combinées par OU |
| `funnelStages` | string\[] | Non | Parmi `TOFU`, `MOFU`, `BOFU` et `POST_PURCHASE` ; valeurs combinées par OU |
| `limit` | integer | Non | Nombre maximal de concurrents renvoyés (par défaut : 20, maximum : 100) |

### Types de relation

| Type | Description |
| - | - |
| `SELF` | Votre propre marque |
| `DIRECT` | Concurrents directs (même catégorie de produits) |
| `INDIRECT` | Concurrents indirects (solutions voisines) |
| `ECOSYSTEM` | Acteurs de l’écosystème (produits complémentaires) |
| `COMPLEMENTARY` | Produits ou services complémentaires |
| `SELF_DIRECT` | Votre marque et ses concurrents directs dans un même classement |

### Résultat

| Champ | Type | Description |
| - | - | - |
| `brandName` | string | Nom de la marque suivie |
| `appliedFilters` | object | Fenêtre d’analyse et filtres de taxonomie effectivement utilisés pour le classement |
| `competitors[].id` | string | Identifiant du domaine concurrent |
| `competitors[].name` | string | Nom du concurrent |
| `competitors[].domain` | string ou null | Domaine du concurrent |
| `competitors[].relationship` | string | Type de relation |
| `competitors[].mentions` | number | Nombre de mentions dans le périmètre demandé |
| `competitors[].uniqueAnswers` / `uniqueQuestions` | number | Réponses et questions suivies distinctes qui contribuent aux mentions |
| `competitors[].shareOfVoice` | number ou null | Part des mentions SELF et DIRECT dans le périmètre ; null pour les autres relations |
| `competitors[].shareOfResponses` / `mentionRate` | number ou null | Taux de visibilité au niveau des réponses, lorsqu’ils sont disponibles |
| `competitors[].avgPosition` | number ou null | Position moyenne dans les réponses du périmètre demandé |
| `competitors[].avgSentiment` | number ou null | Sentiment moyen (0 à 100) |
| `competitors[].providers` | string\[] | Fournisseurs qui apportent des données sur ce concurrent |

### Exemple de sortie

```markdown theme={null}
## Competitors for Acme Corp

| Rank | Name | Relationship | Mentions | Share of Voice | Avg Position | Sentiment | Competitor Domain ID |
|------|------|--------------|----------|----------------|--------------|-----------|----------------------|
| 1 | CompetitorA | DIRECT | 892 | 34.26% | 2.3 | 75/100 | 11111111-1111-4111-8111-111111111111 |
| 2 | CompetitorB | DIRECT | 654 | 25.11% | 3.1 | 72/100 | 22222222-2222-4222-8222-222222222222 |
| 3 | Acme Corp | SELF | 612 | 23.50% | 2.8 | 78/100 | 33333333-3333-4333-8333-333333333333 |
| 4 | CompetitorC | DIRECT | 445 | 17.09% | 4.2 | 68/100 | 44444444-4444-4444-8444-444444444444 |
| 5 | ToolX | INDIRECT | 234 | - | 5.1 | 71/100 | 55555555-5555-4555-8555-555555555555 |
```

### Exemples de prompts

```text theme={null}
Qui sont mes concurrents dans les réponses IA ?
```

```text theme={null}
Montre-moi uniquement les concurrents directs
```

```text theme={null}
Quelles marques apparaissent le plus souvent à côté de la mienne ?
```

```text theme={null}
Classe ma marque et mes concurrents directs pour ce Tag sur les 30 derniers jours
```

### Scope OAuth

Requis : `read:competitors`

***

## get\_competitor\_evolution

Suit l’évolution de la présence d’un concurrent dans le temps : tendances des mentions, de la position et du sentiment.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | L’identifiant de marque |
| `competitorId` | string | Oui | L’identifiant du domaine concurrent (issu de `get_competitors`) |
| `period` | integer ou string | Non | Fenêtre d’analyse globale ; 30 jours par défaut |
| `groupBy` | string | Non | `day` (par défaut) ou `week` |

### Résultat

Tableau de points de données, un par jour :

| Champ | Type | Description |
| - | - | - |
| `date` | string | Date (YYYY-MM-DD) |
| `mentions` | number | Mentions ce jour-là |
| `avgPosition` | number | Position moyenne |
| `avgSentiment` | number | Sentiment moyen |

### Exemple de sortie

```markdown theme={null}
## CompetitorA - Evolution Over Time

Relationship: DIRECT

| Date | Mentions | Avg Position | Sentiment |
|------|----------|--------------|-----------|
| 2025-01-21 | 28 | 2.5 | 73/100 |
| 2025-01-22 | 31 | 2.3 | 74/100 |
| 2025-01-23 | 35 | 2.1 | 76/100 |
| 2025-01-24 | 29 | 2.4 | 75/100 |
| 2025-01-25 | 38 | 2.0 | 77/100 |
```

### Exemples de prompts

```text theme={null}
Comment CompetitorA a-t-il évolué au cours du dernier mois ?
```

```text theme={null}
CompetitorB gagne-t-il ou perd-il en visibilité ?
```

```text theme={null}
Montre-moi l’évolution des mentions de ma propre marque
```

<Tip>
  Appelez d’abord `get_competitors` pour trouver le `competitorId` à suivre.
</Tip>

### Scope OAuth

Requis : `read:competitors`

***

## get\_competitor\_comparison

Comparaison directe de la marque avec ses principaux concurrents directs : vos statistiques, votre rang sur le marché, les statistiques des principaux concurrents, un bilan victoires/défaites par concurrent sur le nombre de mentions, et la menace perçue la plus forte.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | L’identifiant de marque issu de `list_brands` |
| `period` | integer ou string | Non | Fenêtre d’analyse globale ; 30 jours par défaut |
| `competitorIds` | string\[] | Non | Limite la comparaison à 1 à 10 identifiants de domaines concurrents |

### Résultat

| Champ | Description |
| - | - |
| `period` / `periodLabel` | La fenêtre analysée |
| `yourStats` | Votre marque : `name`, `mentionCount`, `avgSentiment`, `avgPosition` (null si elle n’est pas mentionnée sur la période) |
| `marketRank` | Votre rang parmi les marques SELF et DIRECT selon le nombre de mentions |
| `totalCompetitors` | Nombre de concurrents directs trouvés |
| `topCompetitors[]` | Par concurrent : `name`, `domain`, `mentionCount`, `avgSentiment`, `avgPosition` |
| `headToHead[]` | Les 5 principaux duels : `competitor`, `yourMentions`, `theirMentions`, `winner` (you/them/tie), ainsi que votre sentiment et votre position face aux leurs |
| `insights` | `winsAgainstTop5`, `lossesAgainstTop5`, `biggestThreat` |

### Exemples de prompts

```text theme={null}
Comment est-ce que je me situe face à mes principaux concurrents en ce moment ?
```

```text theme={null}
Quels concurrents est-ce que je devance, et lesquels me devancent ?
```

### Scope OAuth

Requis : `read:competitors`


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