Docs/Range
BETA · v0.1.0 · Cloud

Range

Suivi de positionnement local Google pour SAB et boutiques physiques. Geo-grid, territory mode, historique.

copiez dans votre agent IA

Le problème (le SEO local est invisible)

Un plombier à Paris 15 ne se classe pas de la même façon à 500 m de son adresse et à 3 km. Google Maps affiche des résultats différents selon l'endroit exact d'où on cherche.

Les outils de tracking classiques donnent une position "moyenne" — inutilisable pour guider une stratégie locale. Range découpe la zone en grille et mesure la position réelle en chaque point.

EXEMPLE — "plombier Paris 15" · grille 3×3
#5
#4
#7
#3
#3
#4
#6
#5
#8

La position varie de #3 au centre à #8 en périphérie — un écart invisible avec un outil classique. C'est la donnée dont votre agent a besoin pour prioriser les actions.

Pas de dashboard. Votre agent IA est l'interface. Il interroge Range à la demande et vous sort une analyse en langage naturel.

Modes de suivi

Range propose deux modes selon le type de business :

geo-grid
Geo-grid
Grille de points autour d'une adresse fixe. Pour les commerces physiques ou les SAB avec une zone de chalandise définie. La taille de la grille (3×3, 5×5…) et le rayon sont configurables.
territory
Territory
Zone personnalisée (polygone ou rayon). Pour les SAB qui couvrent plusieurs quartiers ou villes sans point fixe central. Idéal pour les artisans itinérants.

Mise en service

Rien à installer. Range est un service cloud pur — pas de package npm, pas de tracker à déployer sur les sites clients, pas de skill ni de hook à configurer. Il est intégré dans le serveur MCP SilverBackBase unifié.

Contrairement à Trail qui a un tracker t.js à installer sur chaque site client, Range n'a pas de composant côté client — il interroge les SERPs Google directement via DataForSEO depuis le serveur.

Prérequis : le serveur MCP SilverBackBase doit être connecté à votre agent. Si c'est déjà fait pour Trail ou Root, Range est déjà disponible — aucune étape supplémentaire. Première fois ? Suivez ce guide →

1. Ajouter un mot-clé via l'agent

Formulez votre demande à votre agent directement :

"Suis le mot-clé 'plombier Paris 15' en mode geo-grid pour le compte plomberie-dupont. Adresse : 15 rue de la Convention, Paris."

L'agent appelle range_add_keyword puis range_add_zone pour configurer la grille autour de l'adresse.

2. Vérifier la position

Une fois le mot-clé ajouté, déclenchez une vérification immédiate :

"Vérifie maintenant la position et montre-moi la grille."

L'agent utilise range_check_now puis range_get_grid pour retourner la carte de positions point par point.

3. Analyser l'historique

Range conserve l'historique des vérifications pour mesurer les évolutions dans le temps :

"Comment a évolué notre position sur 'plombier Paris 15' ces 3 derniers mois ?"

L'agent interroge range_get_history et vous présente la tendance.

Prompts SEO local (agency recipes)

Questions à haute valeur ajoutée à poser directement à votre agent :

"Quels mots-clés ont perdu plus de 3 positions ce mois ?"
"Pour le compte dupont-plomberie, quelles zones géographiques sont les plus faibles ?"
"Qualifie ces 10 mots-clés et dis-moi lesquels ont une intention transactionnelle forte."
"Vérifie le volume de recherche pour les variantes de 'plombier Paris 15' et recommande les plus pertinentes."
"Compare les positions de cette semaine vs il y a 30 jours pour tous mes comptes."

Super-pouvoirs (outils MCP)

Les outils MCP exposés par Range permettent à votre agent d'agir en autonomie complète sur le suivi de positionnement local :

OutilDescription
range_add_keywordAjoute un mot-clé à suivre (account_id, keyword, mode, localisation, langue)
range_add_zoneDéfinit la zone géographique d'un mot-clé (adresse, rayon, taille de grille)
range_list_keywordsListe les mots-clés suivis pour un compte avec leurs dernières positions
range_get_summaryRésumé des positions actuelles et tendances pour un compte
range_get_historyHistorique chronologique des positions d'un mot-clé
range_get_gridGrille de positions géographiques point par point (mode geo-grid)
range_check_nowLance une vérification immédiate sans attendre le prochain cycle automatique
range_check_volumeVolume de recherche mensuel pour une liste de mots-clés (DataForSEO)
range_qualify_intentQualification de l'intention de recherche : transactionnel, informationnel, navigationnel
range_delete_keywordSupprime un mot-clé et l'intégralité de son historique

Skill /range-setup

Pour configurer un nouveau compte client sans avoir à choisir manuellement le mode, la taille de grille, ou le rayon — utilisez le skill /range-setup dans Claude Code.

Ce que le skill fait automatiquement :
Détermine le bon mode selon le type de business (commerce fixe → Google Maps · artisan SAB → SERP organique)
Calibre la taille de grille et le rayon selon la densité urbaine
Qualifie l'intention de chaque mot-clé avant de le configurer
Lance un premier check pour avoir une baseline immédiate
"/range-setup dupont-plomberie — plombier sur Paris 15, mots-clés : plombier paris 15, débouchage paris 15"

Technique

Range est un service cloud hébergé sur range.silverbackbase.com. Les vérifications de position passent par DataForSEO — SERP réel, pas estimé, basé sur la géolocalisation exacte de chaque point de grille.

IsolationDonnées isolées par workspace — votre agent ne voit que vos mots-clés.
SourceDataForSEO Google SERP — position réelle, pas une moyenne sur une grande zone.
HistoriqueChaque vérification est conservée indéfiniment pour mesurer les évolutions.
FacturationChaque appel MCP est débité sur votre solde SilverBackBase. Voir /account/billing.