> ## 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 de découverte

> Outils pour découvrir les marques suivies et les Topics et Tags configurés dans Qwairy.

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

## list\_brands

Liste toutes les marques suivies de votre compte. **Appelez-le en premier** pour obtenir les identifiants de marque dont les autres outils ont besoin.

### Paramètres

Cet outil ne prend aucun paramètre.

### Résultat

| Champ | Type | Description |
| - | - | - |
| `id` | string | Identifiant unique de la marque |
| `name` | string | Nom affiché de la marque |
| `domain` | string | Domaine principal de la marque |
| `team` | object | Identifiant et nom du workspace |
| `countryCode` / `languageCode` | string | Marché et langue configurés |
| `monitoring` | object | État d’activation, fréquence, codes des modèles et date de la dernière analyse |
| `counts` | object | Nombre de prompts, Topics et Tags configurés |

### Exemple de sortie

```markdown theme={null}
## Your monitored brands

1. **Acme Corp** (ID: abc-123-def)
   Domain: acme.example
   Workspace: Agency workspace (ID: team-123)
   Market: en / US
   Monitoring: enabled, weekly
   Models: openai-chatgpt-core, google-gemini-core
   Last analysis: 2026-07-19T12:00:00.000Z
   Configuration: 156 prompts, 12 topics, 8 tags
```

### Exemples de prompts

```text theme={null}
Quelles marques est-ce que je suis ?
```

```text theme={null}
Liste mes marques Qwairy
```

```text theme={null}
Montre-moi les marques que je suis
```

### Scope OAuth

Requis : `read:brands`

***

## list\_topics

Liste tous les Topics configurés pour une marque, y compris ceux sans réponse récente. Utilisez cet outil pour obtenir des identifiants de Topic stables avant d’appliquer des filtres par Topic ailleurs.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | L’identifiant de marque issu de `list_brands` |
| `search` | string | Non | Recherche dans le libellé du Topic, sans tenir compte de la casse |
| `limit` | number | Non | Nombre maximal de Topics (par défaut : 50, maximum : 100) |
| `offset` | number | Non | Décalage de pagination (par défaut : 0) |

### Résultat

| Champ | Type | Description |
| - | - | - |
| `id` | string | Identifiant de Topic utilisé par les filtres de Topic |
| `text` | string | Libellé du Topic |
| `promptsCount` | number | Prompts suivis actifs rattachés au Topic |

### Scope OAuth

Requis : `read:topics`

***

## list\_tags

Liste tous les Tags de prompts configurés pour une marque. Utilisez cet outil pour obtenir des identifiants de Tag stables avant d’appliquer des filtres par Tag ailleurs.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | L’identifiant de marque issu de `list_brands` |
| `search` | string | Non | Recherche dans le libellé du Tag, sans tenir compte de la casse |
| `limit` | number | Non | Nombre maximal de Tags (par défaut : 50, maximum : 100) |
| `offset` | number | Non | Décalage de pagination (par défaut : 0) |

### Résultat

| Champ | Type | Description |
| - | - | - |
| `id` | string | Identifiant de Tag utilisé par les filtres de Tag |
| `name` | string | Libellé du Tag |
| `color` | string | Couleur configurée, ou `null` |
| `promptsCount` | number | Prompts suivis actifs portant le Tag |

### Scope OAuth

Requis : `read:topics`

***

## get\_overview

Obtient une vue d’ensemble rapide d’une marque, comme dans le Cockpit : principaux volumes, scores de performance avec leur évolution par rapport à la période précédente, et date du dernier suivi.

**Utilisez-le en deuxième appel**, après `list_brands`, pour avoir un instantané avant d’entrer dans le détail.

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

### Résultat

| Champ | Description |
| - | - |
| `counts` | questions, answers, competitors, sources, selfMentions, socialCitations, shoppingInsights, localBusinesses |
| `scores` | mentionRate, sourceRate, shareOfVoice, sentiment (période en cours) |
| `previousPeriodScores` | Mêmes indicateurs sur la période précédente (comparaison de tendance) |
| `lastMonitoringDate` | Date de la réponse IA la plus récente |

### Scope OAuth

Requis : `read:brands`


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