google_maps_reviews
Extract reviews from Google Maps places using Outscraper
LABSCO SUMMARY
Two calls, and the second one takes the first one's output.
The pairing is the whole workflow: search returns place ids, and passing a place id rather than a business name into the review call is what stops it matching the wrong branch. Set the region and language explicitly on both — the defaults will happily return an English-language read of a market you were not asking about. Enrichment is where a search turns into a contact list, and it is a parameter on the same call rather than a separate step.
What it is
Two calls against Outscraper's Google Maps extraction service: one finds places, one returns their reviews. Large requests are handled asynchronously by the service, so a big pull is one call rather than a paging loop of your own.
What you get
- Place search from a plain query such as restaurants brooklyn usa, up to 400 results a call, with duplicates optionally dropped
- Results localised by language code and narrowed to a country or region code, so a query for one market does not return another
- Enrichment on the search call — domains_service and emails_validator_service add contact information to the rows
- Reviews for a place named by query, business name or place id, with the number of reviews per place set per call and 0 meaning no limit
- Reviews sorted by most_relevant, newest, highest_rating or lowest_rating, and cut off at a Unix timestamp when only recent ones matter
Requirements
An Outscraper API key in OUTSCRAPER_API_KEY, from the account profile page — usage is billed by Outscraper, not by this package. Python 3.10 or newer; it starts over stdio as uvx outscraper-mcp, and can be run over Streamable HTTP instead by launching it with that transport. The search call is what returns the place ids that make the reviews call precise.
Setup effort
One command plus a key — uvx outscraper-mcp, then supply credentials
USE CASES
01
Building a list of businesses in one market
Query the category and city, pin the region and language, and drop duplicates — up to 400 rows come back in a call.
02
Reading what customers say about a specific place
Take the place id from the search results and pull its reviews sorted newest first, capped at however many you want to read.
03
Checking whether sentiment changed after a date
Cut the review pull off at a timestamp so only reviews written since the change you are investigating come back.
04
Turning a search into reachable leads
Run the search with the domain and email-validation enrichments so the rows arrive with contact information already attached.
2 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
google_maps_search
Search for businesses and places on Google Maps using Outscraper
BEFORE YOU INSTALL
What to know first
Tools you get
2 tools when we connected. domains_service and emails_validator_service are enrichment values, and most_relevant, highest_rating and lowest_rating are sort values, not tools.
Requires
- uvx on PATH
- OUTSCRAPER_API_KEY in your environment
Where it runs
All 3 documented setups run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 2 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
uvx outscraper-mcpMCP Clients
Claude Desktop — uvx, Cursor — uvx
JSON
{
"mcpServers": {
"outscraper": {
"command": "uvx",
"args": [
"outscraper-mcp"
],
"env": {
"OUTSCRAPER_API_KEY": "<YOUR_OUTSCRAPER_API_KEY>"
}
}
}
}Cursor — manual install
CURSOR — MANUAL INSTALL · JSON
{
"mcpServers": {
"outscraper": {
"command": "outscraper-mcp",
"env": {
"OUTSCRAPER_API_KEY": "<YOUR_OUTSCRAPER_API_KEY>"
}
}
}
}
