Outscraper

A streamlined Model Context Protocol (MCP) server that provides access to Outscraper's Google Maps data extraction services. This server implements2 essential toolsfor extracting Google Maps data with high reliability.

- 🗺️ Google Maps Search- Search for businesses and places with detailed information
- ⭐ Google Maps Reviews- Extract customer reviews from any Google Maps place

- Data Enrichment- Enhance results with additional contact information via enrichment parameter
- Multi-language Support- Search and extract data in different languages
- Regional Filtering- Target specific countries/regions for localized results
- Flexible Sorting- Sort reviews by relevance, date, rating, etc.
- Time-based Filtering- Filter reviews by date using cutoff parameter
- High Volume Support- Handles async processing for large requests automatically

To install the Outscraper MCP server for Claude Desktop automatically viaSmithery:

npx -y @smithery/cli install outscraper-mcp --client claude

# Using pip pip install outscraper-mcp # Using uv (recommended) uv add outscraper-mcp # Using uvx for one-time execution uvx outscraper-mcp

git clone https://github.com/jayozer/outscraper-mcp cd outscraper-mcp # Using uv (recommended) uv sync # Using pip pip install -e .

- Sign up atOutscraper
- Get your API key from the profile page

export OUTSCRAPER_API_KEY="your_api_key_here"

{ "mcpServers": { "outscraper": { "command": "npx", "args": ["-y", "@smithery/cli", "run", "outscraper-mcp"], "env": { "OUTSCRAPER_API_KEY": "your_api_key_here" } } } }

{ "mcpServers": { "outscraper": { "command": "uvx", "args": ["outscraper-mcp"], "env": { "OUTSCRAPER_API_KEY": "your_api_key_here" } } } }

{ "mcpServers": { "outscraper": { "command": "uv", "args": ["run", "python", "-m", "outscraper_mcp"], "env": { "OUTSCRAPER_API_KEY": "your_api_key_here" } } } }

Automatic Installation with UVX (Recommended):

{ "mcpServers": { "outscraper": { "command": "uvx", "args": ["outscraper-mcp"], "env": { "OUTSCRAPER_API_KEY": "your_api_key_here" } } } }

{ "mcpServers": { "outscraper": { "command": "outscraper-mcp", "env": { "OUTSCRAPER_API_KEY": "your_api_key_here" } } } }

Note for Cursor Users: The configuration file is typically located at:

- macOS:~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
- Windows:%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
- Linux:~/.config/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

Search for businesses and places on Google Maps

# Parameters: query: str # Search query (e.g., 'restaurants brooklyn usa') limit: int = 20 # Number of results (max: 400) language: str = "en" # Language code region: str = None # Country/region code (e.g., 'US', 'GB') drop_duplicates: bool = False # Remove duplicate results enrichment: List[str] = None # Additional services ['domains_service', 'emails_validator_service']

# Parameters: query: str # Place query, place ID, or business name reviews_limit: int = 10 # Number of reviews per place (0 for unlimited) limit: int = 1 # Number of places to process sort: str = "most_relevant" # Sort order: 'most_relevant', 'newest', 'highest_rating', 'lowest_rating' language: str = "en" # Language code region: str = None # Country/region code cutoff: int = None # Unix timestamp for reviews after specific date

# FastMCP Inspector - Web-based testing dashboard fastmcp dev outscraper_mcp/server.py # Then open your browser to: http://127.0.0.1:6274 # Interactive testing of Google Maps tools with real-time responses

# Via PyPI installation outscraper-mcp # Via uv uv run python -m outscraper_mcp # Via manual installation python -m outscraper_mcp

from outscraper_mcp import mcp if __name__ == "__main__": mcp.run(transport="streamable-http", host="127.0.0.1", port=8000)

Example 1: Find Restaurants and Get Reviews

# 1. Search for restaurants results = google_maps_search( query="italian restaurants manhattan nyc", limit=5, language="en", region="US" ) # 2. Get reviews for a specific place reviews = google_maps_reviews( query="ChIJrc9T9fpYwokRdvjYRHT8nI4", # Place ID from search results reviews_limit=20, sort="newest" )

Example 2: Lead Generation with Enrichment

# Find businesses with enhanced contact information businesses = google_maps_search( query="digital marketing agencies chicago", limit=20, enrichment=["domains_service", "emails_validator_service"] ) # Get detailed reviews for sentiment analysis for business in businesses: if business.get('place_id'): reviews = google_maps_reviews( query=business['place_id'], reviews_limit=10, sort="newest" )

# Research competitors in specific area competitors = google_maps_search( query="coffee shops downtown portland", limit=50, region="US" ) # Analyze recent customer feedback recent_reviews = google_maps_reviews( query="coffee shops downtown portland", reviews_limit=100, sort="newest" )

This server is compatible with any MCP client, including:

- Claude Desktop
- Cursor AI
- Raycast
- VS Codewith MCP extensions
- Custom MCP clients

- CheckOutscraper Pricingfor current rates
- API key usage is tracked per request
- Consider implementing caching for frequently accessed data
-

import logging logging.basicConfig(level=logging.DEBUG)

- Outscraper API Documentation
- FastMCP Documentation
- Model Context Protocol
- Smithery Registry

Search job postings, companies, and technology stacks across 10M+ companies.