| name | apify-avis-clients-maps |
| description | Use when you want all the Google Maps reviews of one place in one shot - to read the verbatim, spot recurring complaints, or mine testimonials. Place URL -> CSV of reviews. |
Récupérer les avis clients d'un lieu
Objectif & quand
One-shot : tu veux tous les avis Google Maps d'un lieu d'un coup - le tien, celui d'un client à auditer, ou d'un concurrent à décortiquer. Pour lire le verbatim en entier, repérer ce qui revient (les points forts à mettre en avant, les reproches récurrents à corriger), ou piocher des témoignages. Cet Actor lit les avis publics du lieu et te sort un tableau exploitable.
Prérequis
- Compte Apify +
APIFY_TOKEN (gratuit pour démarrer).
- MCP Apify configuré (
CONNECTING-MCP.md).
Actor utilisé
compass/Google-Maps-Reviews-Scraper (https://apify.com/compass/Google-Maps-Reviews-Scraper) - extrait les avis d'un lieu Google Maps à partir de son URL (note, texte, date, réponse du gérant).
Config (config.example.yaml)
| Champ | Rôle |
|---|
startUrls | URL(s) du/des lieu(x) Google Maps (contient /maps/place/) |
maxReviews | nombre max d'avis à récupérer par lieu (borne le coût) |
reviewsSort | ordre : newest, mostRelevant, highestRanking, lowestRanking |
language | langue des résultats (fr) |
Procédure (via MCP)
- Récupérer l'URL du lieu : le chercher sur Google Maps, ouvrir sa fiche, copier l'URL (elle contient
/maps/place/).
- Demander au MCP Apify de lancer l'Actor
compass/Google-Maps-Reviews-Scraper avec l'input de config.example.yaml (tool call-actor).
- Récupérer les items du dataset (
get-dataset-items).
- Mettre en forme : une ligne par avis (colonnes ci-dessous).
Variantes utiles
Trois champs de l'Actor permettent de cibler la lecture sans changer de skill :
- Filtrer par note :
reviewsSort: lowestRanking fait remonter d'abord les avis négatifs (les reproches à corriger). highestRanking fait ressortir les meilleurs (témoignages à recycler).
- Filtrer par période :
reviewsStartDate (ex 3 months, ou 2026-01-01) ne garde que les avis récents - utile pour juger la période post-changement (nouveau gérant, nouveau menu).
- Filtrer par mot-clé :
reviewsFilterString (ex accueil, livraison) ne remonte que les avis contenant ce mot - pour isoler un sujet précis (le service, un produit, un délai).
Si le MCP ne fait pas l'action
Fallback via lib/apify_helpers.py :
from lib import apify_helpers as a
reviews = a.run_actor("compass/Google-Maps-Reviews-Scraper", {
"startUrls": [{"url": "https://www.google.com/maps/place/?q=place_id:ChIJb2000001"}],
"maxReviews": 100,
"reviewsSort": "newest",
"language": "fr",
})
Ou lancer l'Actor depuis la console Apify (bouton Start) avec le même input.
Livrable
CSV : reviewer, rating, date, review_text, owner_response, likes.
Coût & limites
Pay-per-result : ~$0.0005 / avis. 200 avis ≈ $0.10. Le champ maxReviews borne la dépense. Données publiques ; les noms d'auteurs sont des données personnelles (RGPD), à n'exploiter qu'avec un motif légitime. Pour surveiller les nouveaux avis dans le temps (cron), voir le script veille_avis_maps.
Exemple
examples/avis-clients-maps.csv (données fictives, schéma réel).