Outils de découverte

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

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

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

Quelles marques est-ce que je suis ?

Liste mes marques Qwairy

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

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

Bien démarrer

Référence des outils

Exemples

Workflows

list_brands

Paramètres

Résultat

Exemple de sortie

Exemples de prompts

Scope OAuth

list_topics

Paramètres

Résultat

Scope OAuth

Paramètres

Résultat

Scope OAuth

get_overview

Paramètres

Résultat

Scope OAuth

​list_brands

​Paramètres

​Résultat

​Exemple de sortie

​Exemples de prompts

​Scope OAuth

​list_topics

​Paramètres

​Résultat

​Scope OAuth

​list_tags

​Paramètres

​Résultat

​Scope OAuth

​get_overview

​Paramètres

​Résultat

​Scope OAuth

list_brands

Paramètres

Résultat

Exemple de sortie

Exemples de prompts

Scope OAuth

list_topics

Paramètres

Résultat

Scope OAuth

list_tags

Paramètres

Résultat

Scope OAuth

get_overview

Paramètres

Résultat

Scope OAuth