Outils d’insights

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

get_shopping_insights

Obtient la visibilité e-commerce dans les résultats shopping de l’IA : boutiques qui mentionnent vos produits, produits concurrents, notes et opportunités.

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
`limit`	number	Non	Nombre maximal d’éléments renvoyés (par défaut : 10, maximum : 20)

Résultat

Champ	Description
`summary`	Total des produits, boutiques et mentions, note moyenne
`topStores[]`	Boutiques avec nombre de produits et de mentions, présence de la marque et des concurrents
`topProducts[]`	Produits les plus mentionnés, avec leur note
`opportunities[]`	Boutiques où les concurrents apparaissent mais pas la marque (priorité : very-high/high)

Scope OAuth

Requis : read:visibility

get_social_insights

Obtient les citations de réseaux sociaux et de forums dans les réponses IA : Reddit, YouTube, HackerNews, Stack Overflow, etc.

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
`limit`	number	Non	Nombre maximal de communautés renvoyées (par défaut : 10, maximum : 20)

Résultat

Champ	Description
`summary.totalSocialCitations`	Total des citations de réseaux sociaux et de forums
`summary.socialShareOfVoice`	Part des citations sociales dans l’ensemble des citations, en %
`platformDistribution[]`	Citations par plateforme (reddit, youtube, etc.)
`topCommunities[]`	Domaines sociaux les plus cités, avec leur position moyenne

Scope OAuth

Requis : read:sources

get_local_insights

Obtient la visibilité des commerces locaux dans les réponses IA : établissements mentionnés, catégories, notes et nombre d’avis.

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
`limit`	number	Non	Nombre maximal d’établissements renvoyés (par défaut : 10, maximum : 20)

Résultat

Champ	Description
`summary`	Total des mentions, établissements distincts, position moyenne, catégorie principale
`categoryDistribution[]`	Mentions par catégorie d’établissement
`topBusinesses[]`	Établissements les plus mentionnés, avec note, avis et indicateur de concurrent

Scope OAuth

Requis : read:visibility

get_query_fan_out

Obtient les requêtes de recherche web détectées dans les réponses IA : variantes de requêtes autour des Topics suivis, avec la visibilité de la marque et la présence des concurrents pour chaque requête.

Paramètres

Paramètre	Type	Requis	Description
`brandId`	string	Oui	L’identifiant de marque issu de `list_brands`
`promptId`	string	Non	Limite à un prompt suivi issu de `get_prompts`
`period`	integer ou string	Non	Fenêtre d’analyse globale ; 30 jours par défaut
`limit`	number	Non	Nombre maximal de requêtes renvoyées (par défaut : 20, maximum : 500)
`offset`	number	Non	Décalage de pagination (par défaut : 0)

Résultat

Champ	Description
`summary`	Total des requêtes, requêtes distinctes, présence moyenne de la marque en %
`topQueries[]`	Requêtes les plus fréquentes, avec présence de la marque en %, nombre de concurrents et priorité

Le résumé est calculé sur l’ensemble du résultat filtré : avgBrandPresence reste donc stable d’une page à l’autre.

Exemples de prompts

Montre le Query Fan-Out de ce prompt suivi

Quelles requêtes dérivées font apparaître des concurrents mais pas ma marque ?

Scope OAuth

Requis : read:prompts

get_follow_ups

Liste les questions suivantes que les fournisseurs IA ont suggérées après vos réponses suivies, des plus récentes aux plus anciennes. Chaque question de suivi indique son prompt source, le fournisseur et le modèle, sa position dans les suggestions et si vous suivez déjà cette question.

Paramètres

Paramètre	Type	Requis	Description
`brandId`	string	Oui	L’identifiant de marque issu de `list_brands`
`period`	integer ou string	Non	Nombre de jours glissants ou `"all"` ; 30 jours par défaut
`startDate` / `endDate`	string	Non	Plage personnalisée incluse (`YYYY-MM-DD`), fournie par paire
`providers`	string[]	Non	Identifiants de fournisseurs ou de modèles IA
`topicIds`	string[]	Non	UUID de Topics issus de `list_topics`
`tagIds`	string[]	Non	UUID de Tags issus de `list_tags`
`funnelStages`	string[]	Non	`TOFU`, `MOFU`, `BOFU` ou `POST_PURCHASE`
`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)
`limit`	number	Non	Nombre maximal de questions de suivi renvoyées (par défaut : 25, maximum : 100)
`offset`	number	Non	Décalage de pagination (par défaut : 0)

Résultat

Champ	Description
`pagination`	`total`, `count`, `limit`, `offset` et `hasMore`
`followUps[].text`	La question suggérée
`followUps[].kind`	`SUGGESTION` (un prompt que le moteur propose tel quel) ou `GUIDED_CONTINUATION` (le message que ChatGPT envoie une fois son formulaire rempli ; les champs apparaissent sous la forme `{placeholders}`)
`followUps[].types`	Types d’intention, comme `COMPARISON` ou `HOW_TO` ; vide tant que la question n’est pas classée
`followUps[].position`	Position de la suggestion dans la liste du fournisseur
`followUps[].isMonitored`	Indique si la même question est déjà un prompt suivi
`followUps[].prompt`	Prompt source (`id`, `text`)
`followUps[].answer`	Réponse source : `id`, `providerId`, `modelId`, `createdAt`

Exemples de prompts

Quelles questions de suivi les fournisseurs IA suggèrent-ils après mes prompts ?

Liste les questions de suivi suggérées que je ne suis pas encore

Scope OAuth

Requis : read:prompts

get_sponsored_content

Détecte les contenus sponsorisés et les publicités qui apparaissent dans les réponses IA : quels annonceurs, produits et prompts déclenchent des publicités, et si des concurrents en font partie.

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
`limit`	number	Non	Nombre maximal d’annonceurs et de publicités récentes renvoyés (par défaut : 10, maximum : 20)

Résultat

Champ	Description
`summary`	`totalAds`, `uniqueAdvertisers`, `uniquePrompts`, `uniqueProducts`
`topAdvertisers[]`	Par annonceur : `name`, `count`, `products`, `prompts`, `isCompetitor`
`recentAds[]`	Par publicité : `advertiserName`, `productName`, `description`, `promptText`, `provider`, `date`

Exemples de prompts

Des concurrents diffusent-ils des publicités dans les réponses IA sur mes Topics ?

Quels prompts déclenchent des contenus sponsorisés ?

Scope OAuth

Requis : read:visibility

Bien démarrer

Référence des outils

Exemples

Workflows

get_shopping_insights

Paramètres

Résultat

Scope OAuth

get_social_insights

Paramètres

Résultat

Scope OAuth

get_local_insights

Paramètres

Résultat

Scope OAuth

get_query_fan_out

Paramètres

Résultat

Exemples de prompts

Scope OAuth

get_follow_ups

Paramètres

Résultat

Exemples de prompts

Scope OAuth

get_sponsored_content

Paramètres

Résultat

Exemples de prompts

Scope OAuth

​get_shopping_insights

​Paramètres

​Résultat

​Scope OAuth

​get_social_insights

​Paramètres

​Résultat

​Scope OAuth

​get_local_insights

​Paramètres

​Résultat

​Scope OAuth

​get_query_fan_out

​Paramètres

​Résultat

​Exemples de prompts

​Scope OAuth

​get_follow_ups

​Paramètres

​Résultat

​Exemples de prompts

​Scope OAuth

​get_sponsored_content

​Paramètres

​Résultat

​Exemples de prompts

​Scope OAuth

get_shopping_insights

Paramètres

Résultat

Scope OAuth

get_social_insights

Paramètres

Résultat

Scope OAuth

get_local_insights

Paramètres

Résultat

Scope OAuth

get_query_fan_out

Paramètres

Résultat

Exemples de prompts

Scope OAuth

get_follow_ups

Paramètres

Résultat

Exemples de prompts

Scope OAuth

get_sponsored_content

Paramètres

Résultat

Exemples de prompts

Scope OAuth