Outils
Les outils du MCP GClimb, leurs paramètres et leur coût en crédits. Votre assistant ne voit que les outils ouverts à votre compte : un outil fermé n’apparaît pas.
lookup
Coût : GratuitTrouver une boutique
Résout un nom de marque, un domaine ou une adresse de page en boutiques de l'index GClimb (shop_id, domaine, nom, pays). À appeler en premier quand l'utilisateur nomme une boutique : les autres outils prennent un shop_id. Cherche dans tous les pays ; au plus 5 résultats.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| q | string | oui | Marque, domaine (boutique.fr) ou adresse (https://…). |
search_shops
Coût : 1 crédit par ligne renvoyée (au plus 25 par appel)Rechercher des boutiques
Liste les boutiques e-commerce de l'index GClimb pour un pays, avec leurs visites estimées, leurs annonces Google (actives, lancées sur 7 et 30 jours) et leur niche. Filtres : niche (slug donné par list_niches), recherche par nom ou domaine (tous pays), seuils. Tri « new_30d » = boutiques qui ont lancé le plus d'annonces sur 30 jours. Un champ null signifie « non mesuré », jamais zéro ; at_least = true signifie « au moins ce nombre ». ads.active_at_least = true : au moins ce nombre d'annonces actives. visits_band : tranche de popularité estimée (top N du pays, ordre de grandeur, jamais un nombre de visites), seulement quand visits_estimated est null.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| country | string | oui | Pays : FR, US, UK, DE, ES, IT, NL, BE ou CA.FR, US, UK, DE, ES, IT, NL, BE, CA |
| query | string | non | Nom ou domaine de boutique (cherche dans tous les pays). |
| niche | string | non | Slug de niche (list_niches). |
| sort | string | non | Tri décroissant. Défaut : active (annonces actives).active, new_30d, visits, growth, niche_volume, traffic_value, avg_cpc, main_keyword_volume, products, created |
| min_visits | integer | non | Visites mensuelles estimées minimum. |
| min_new_30d | integer | non | Annonces lancées sur 30 jours, minimum. |
| min_active | integer | non | Annonces actives, minimum. |
| page | integer | non | Page (défaut 1).1–40 |
| per_page | integer | non | Lignes par page (défaut 10, max 25).1–25 |
get_shop
Coût : 5 crédits par appelFiche d'une boutique
Fiche détaillée d'une boutique de l'index : produits, meilleures ventes, apps et pixels, réseaux sociaux, avis clients, visites et annonces Google par pays (rythme de lancement sur 12 semaines), niche et mots-clés principaux (si country est donné). Prend un shop_id (search_shops ; pour un domaine, chercher d'abord avec search_shops et query). Un champ null signifie « non mesuré », jamais zéro ; at_least = true signifie « au moins ce nombre ».
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| shop_id | string | oui | Identifiant de la boutique (search_shops). |
| country | string | non | Pays : FR, US, UK, DE, ES, IT, NL, BE ou CA.FR, US, UK, DE, ES, IT, NL, BE, CA |
get_shop_ads
Coût : 1 crédit par ligne renvoyée (au plus 36 par appel)Annonces d'une boutique
Annonces Google d'une boutique, de la plus récemment diffusée à la plus ancienne : format, type (Shopping, Search…), titre, prix, dates de première et dernière diffusion, affichages estimés par pays de l'UE quand ils sont mesurés. 36 annonces par page ; next_cursor donne la page suivante. Un champ null signifie « non mesuré », jamais zéro ; at_least = true signifie « au moins ce nombre ». accounts_known = false : annonces non vérifiées pour cette boutique (jamais « aucune annonce »).
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| shop_id | string | oui | Identifiant de la boutique (search_shops). |
| country | string | non | Pays : FR, US, UK, DE, ES, IT, NL, BE ou CA.FR, US, UK, DE, ES, IT, NL, BE, CA |
| cursor | string | non | next_cursor de la page précédente. |
search_ads
Coût : 1 crédit par ligne renvoyée (au plus 36 par appel)Rechercher des annonces
Bibliothèque des annonces Google diffusées dans un pays de l'UE (FR, DE, ES, IT, NL, BE), toutes boutiques confondues. Tri : last (vue le plus récemment), first (lancée le plus récemment), shown (les plus affichées), running (diffusée depuis le plus longtemps). Filtres : niche, format, annonces actives, durée de diffusion minimum. 36 par page ; next_cursor donne la page suivante. Un champ null signifie « non mesuré », jamais zéro ; at_least = true signifie « au moins ce nombre ». partial = true : recherche non terminée, résultat non concluant.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| country | string | oui | Pays de diffusion (UE).FR, DE, ES, IT, NL, BE |
| sort | string | non | Tri. Défaut : last.last, first, shown, running |
| niche | string | non | Slug de niche (list_niches). |
| format | string | non | Format de l'annonce.text, image, video |
| active_only | boolean | non | Seulement les annonces diffusées ces derniers jours. |
| min_days | integer | non | Durée de diffusion minimum, en jours.1–3650 |
| cursor | string | non | next_cursor de la page précédente. |
list_niches
Coût : GratuitNiches d'un pays
Liste les niches e-commerce suivies par GClimb pour un pays, avec le volume de recherche mensuel total, le CPC médian et le nombre de mots-clés de chaque niche. Le slug sert de filtre à search_shops, search_ads et get_niche. Un champ null signifie « non mesuré », jamais zéro ; at_least = true signifie « au moins ce nombre ».
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| country | string | oui | Pays : FR, US, UK, DE, ES, IT, NL, BE ou CA.FR, US, UK, DE, ES, IT, NL, BE, CA |
get_niche
Coût : 5 crédits par appelFiche d'une niche
Fiche d'une niche dans un pays : volume de recherche, CPC et enchères médianes, concurrence, part d'intention d'achat, tendance et saisonnalité, mots-clés mesurés (volume, CPC, concurrence) et boutiques qui captent le plus de trafic. Montants dans la devise du pays. Un champ null signifie « non mesuré », jamais zéro ; at_least = true signifie « au moins ce nombre ».
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| slug | string | oui | Slug de niche (list_niches). |
| country | string | oui | Pays : FR, US, UK, DE, ES, IT, NL, BE ou CA.FR, US, UK, DE, ES, IT, NL, BE, CA |
get_shop_keywords
Coût : 1 crédit par ligne renvoyée (au plus 100 par appel)Mots-clés d'une boutique
Mots-clés Google sur lesquels une boutique capte du trafic naturel dans un pays, déjà mesurés : volume, CPC, position, trafic estimé. measured = false : pas encore mesurés pour ce pays (aucune mesure n'est lancée par cet outil). keywords = les mots-clés détaillés de la boutique, du plus fort trafic estimé au plus faible ; keywords_total = leur nombre, toutes pages comprises. Pagination : page et per_page (défaut 25, max 100) ; has_more = true : d'autres mots-clés détaillés sur next_page. organic_keywords_count = toutes les positions de la boutique, y compris celles qui ne sont pas détaillées (not_detailed) : ce n'est jamais une limite du compte. Un champ null signifie « non mesuré », jamais zéro ; at_least = true signifie « au moins ce nombre ».
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| shop_id | string | oui | Identifiant de la boutique (search_shops). |
| country | string | oui | Pays : FR, US, UK, DE, ES, IT, NL, BE ou CA.FR, US, UK, DE, ES, IT, NL, BE, CA |
| page | integer | non | Page (défaut 1).1–100 |
| per_page | integer | non | Mots-clés par page (défaut 25, max 100).1–100 |
get_shop_ad_keywords
Coût : 1 crédit par ligne renvoyée (au plus 25 par appel)Recherches où une boutique apparaît
Recherches Google où une boutique a été vue, par famille : résultats naturels, annonces Search, annonces Shopping (meilleure position, première et dernière fois vue), avec le volume et le CPC de chaque recherche. state = not_verified : aucune recherche vue pour cette boutique dans ce pays (jamais « aucun mot-clé »). Un champ null signifie « non mesuré », jamais zéro ; at_least = true signifie « au moins ce nombre ».
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| shop_id | string | oui | Identifiant de la boutique (search_shops). |
| country | string | oui | Pays : FR, US, UK, DE, ES, IT, NL, BE ou CA.FR, US, UK, DE, ES, IT, NL, BE, CA |
similar_shops
Coût : 1 crédit par ligne renvoyée (au plus 25 par appel)Boutiques similaires
Boutiques proches d'une boutique de l'index (catalogue et positionnement voisins, tous pays), avec leurs visites estimées, annonces actives et mot-clé principal. state = not_verified : liste pas encore calculée (jamais « aucune boutique similaire »). Un champ null signifie « non mesuré », jamais zéro ; at_least = true signifie « au moins ce nombre ».
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| shop_id | string | oui | Identifiant de la boutique (search_shops). |
my_watchlist
Coût : 1 crédit par ligne renvoyée (au plus 100 par appel)Mes concurrents suivis
Les concurrents que le compte suit dans la Veille : annonces actives, annonces lancées sur 30 jours (par semaine), trafic estimé et sa tendance, part Shopping / Search, nombre de produits (produits poussés : watch_products). Un champ null signifie « non mesuré », jamais zéro ; at_least = true signifie « au moins ce nombre ». ads_state : measured, pending (mesure en cours), none_found, not_verified, hidden (non disponible sur ce compte).
Aucun paramètre.
compare_competitors
Coût : 1 crédit par ligne renvoyée (au plus 5 par appel)Comparer des concurrents suivis
Compare côte à côte 2 à 5 concurrents suivis dans la Veille (par shop_id ou domaine) : annonces actives, lancées sur 30 jours, trafic estimé et tendance, part Shopping / Search, nombre de produits. Une boutique non suivie est listée dans not_followed (la suivre depuis l'écran pour la comparer). Un champ null signifie « non mesuré », jamais zéro ; at_least = true signifie « au moins ce nombre ».
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| shops | array | oui | shop_id ou domaines (ex. boutique.fr) des concurrents suivis à comparer.2 à 5 éléments |
watch_activity
Coût : 1 crédit par ligne renvoyée (au plus 60 par appel)Activité des concurrents suivis
Ce que les concurrents suivis ont fait sur une période, jour par jour : annonces lancées (avec leurs titres et prix), nouveaux produits mis en ligne, changements de prix, variations de trafic estimé. counts donne les totaux de la période. Un champ null signifie « non mesuré », jamais zéro ; at_least = true signifie « au moins ce nombre ». Les jours sont ceux de Paris ; au-delà de 90 jours, rien n'est mesuré.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| period | string | non | Période. Défaut : 7d.24h, 7d, 14d, 30d |
watch_products
Coût : 1 crédit par ligne renvoyée (au plus 50 par appel)Produits poussés par les concurrents
Produits que les concurrents suivis poussent en annonces Shopping : les plus affichés et ceux apparus sur la période (titre, prix, nombre d'annonces, dates), et pour chaque concurrent le nombre d'annonces lancées par type. Un champ null signifie « non mesuré », jamais zéro ; at_least = true signifie « au moins ce nombre ».
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| days | integer | non | Période en jours. Défaut : 7.7, 14, 30 |
my_markets
Coût : 1 crédit par ligne renvoyée (au plus 25 par appel)Mes niches suivies
Les niches que le compte suit, avec leur dernière photo : boutiques de la niche, boutiques qui font de la publicité, nouvelles boutiques, volume de recherche, boutiques en croissance et annonces les plus diffusées. Un champ null signifie « non mesuré », jamais zéro ; at_least = true signifie « au moins ce nombre ».
Aucun paramètre.
my_audits
Coût : 1 crédit par ligne renvoyée (au plus 25 par appel)Mes audits Merchant Center
Les derniers audits Merchant Center du compte : site audité, date, statut, note sur 100, nombre de problèmes bloquants. score = null : audit non noté (en cours ou en échec).
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| limit | integer | non | Nombre d'audits (défaut 10).1–20 |
get_quotas
Coût : GratuitCrédits et quotas restants
Ce qu'il reste au compte GClimb ce mois-ci : crédits MCP GClimb (bloc credits : utilisés, restants, limite), audits, recherches de mots-clés, boutiques suivies, niches suivies (limite, utilisé, restant) et date de remise à zéro. null = non vérifié.
Aucun paramètre.