Google Maps Scraper
Live Google Maps business search, review, and photo data for AI agents over MCP.
ماذا يمكنك أن تفعل مع Google Maps Scraper؟
- Search businesses by keyword and location, including listing details such as names, addresses, phone numbers, websites, ratings, reviews, and photos.
- Retrieve public Google Maps reviews for reputation research and customer feedback analysis.
- Retrieve public business photos and image URLs for listing enrichment and visual audits.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http google-maps-scraper 'https://cloud.gmapsextractor.com/api/mcp' --header 'Authorization: <G Maps Extractor API key in the format: Bearer YOUR_API_KEY>'
{
"mcpServers": {
"google-maps-scraper": {
"type": "http",
"url": "https://cloud.gmapsextractor.com/api/mcp",
"headers": {
"Authorization": "<G Maps Extractor API key in the format: Bearer YOUR_API_KEY>"
}
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
Google Maps Scraper MCP server
Give your AI agent live Google Maps business search, review, and photo data through one secure Model Context Protocol connection.
This repository is the public listing and manifest for the hosted G Maps Extractor MCP server. The server runs remotely, so there is no package to install and nothing to host locally.
- Website: gmapsextractor.com
- Product page: Google Maps Scraper MCP
- Get an API key: cloud.gmapsextractor.com
- MCP endpoint:
https://cloud.gmapsextractor.com/api/mcp - Transport: Streamable HTTP
- Authentication:
Authorization: Bearer YOUR_API_KEY
What you can do
- Search businesses by keyword and location, including listing details such as names, addresses, phone numbers, websites, ratings, reviews, and photos.
- Retrieve public Google Maps reviews for reputation research and customer feedback analysis.
- Retrieve public business photos and image URLs for listing enrichment and visual audits.
Common workflows include prospecting research, local market analysis, competitor comparisons, CRM enrichment, reputation analysis, and listing audits.
Connect
Create an API key in the G Maps Extractor dashboard, keep it in a secure environment variable or secret store, and register the remote endpoint with your MCP client.
Claude Code
claude mcp add --transport http google-maps-scraper-mcp \
https://cloud.gmapsextractor.com/api/mcp \
--header "Authorization: Bearer YOUR_API_KEY"
Cursor
Add this to .cursor/mcp.json in your project:
{
"mcpServers": {
"google-maps-scraper-mcp": {
"url": "https://cloud.gmapsextractor.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
VS Code
Add this to .vscode/mcp.json in your project:
{
"servers": {
"google-maps-scraper-mcp": {
"type": "http",
"url": "https://cloud.gmapsextractor.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Codex
Add this to ~/.codex/config.toml:
[mcp_servers.google-maps-scraper-mcp]
type = "http"
url = "https://cloud.gmapsextractor.com/api/mcp"
[mcp_servers.google-maps-scraper-mcp.headers]
Authorization = "Bearer YOUR_API_KEY"
Cline
Add this to your MCP settings:
{
"mcpServers": {
"google-maps-scraper-mcp": {
"type": "streamableHttp",
"url": "https://cloud.gmapsextractor.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Tools
search_google_maps
Search for businesses and places on Google Maps in real time.
| Parameter | Type | Required | Description |
|---|---|---|---|
q | string | Yes | Search query, such as coffee shops in New York |
ll | string | No | Coordinates and zoom, such as @40.7128,-74.0060,11z |
hl | string | No | Language code; defaults to en |
gl | string | No | Country code; defaults to us |
page | number | No | Page number; defaults to 1 |
extra | boolean | No | Include emails, social profiles, and extended details |
get_place_reviews
Retrieve public reviews for a place using the fid returned by search_google_maps.
| Parameter | Type | Required | Description |
|---|---|---|---|
fid | string | Yes | Google Maps feature ID returned by a search |
page | number | No | Page number; defaults to 1 |
max_page | number | No | Maximum number of pages to retrieve |
sort_by | number | No | 1 relevant, 2 newest, 3 highest rating, 4 lowest rating |
get_place_photos
Retrieve public photos for a place using the fid returned by search_google_maps.
| Parameter | Type | Required | Description |
|---|---|---|---|
fid | string | Yes | Google Maps feature ID returned by a search |
page | number | No | Page number; defaults to 1 |
max_page | number | No | Maximum number of pages to retrieve |
Example prompts
- “Find the top-rated coffee shops in Portland and return their website, phone number, rating, and review count.”
- “Get the newest Google Maps reviews for this place and summarize the recurring customer complaints.”
- “Retrieve public photos for these restaurant FIDs and identify locations with limited visual content.”
- “Compare visible listing signals for dentists in Austin and group the results by rating.”
Authentication and usage
Every request must include your G Maps Extractor API key:
Authorization: Bearer YOUR_API_KEY
Do not commit a real API key to this repository or any client configuration. New accounts can start with the available free monthly requests; higher-volume usage follows the plan attached to the key.
About this repository
This is a public discovery, configuration, and documentation repository. It contains:
server.jsonfor MCP Registry-compatible server metadata.mcp.jsonas a ready-to-customize client configurationllms-install.mdwith concise installation instructions for AI agents- product icons and branding
The hosted MCP implementation remains at https://cloud.gmapsextractor.com/api/mcp.
License
الأسئلة الشائعة
ما هو Google Maps Scraper؟
Live Google Maps business search, review, and photo data for AI agents over MCP.
كيف أثبّت Google Maps Scraper؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http google-maps-scraper 'https://cloud.gmapsextractor.com/api/mcp' --header 'Authorization: <G Maps Extractor API key in the format: Bearer YOUR_API_KEY>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Google Maps Scraper إلى مفتاح API؟
نعم. يتطلب Authorization، وتضبطها في إعداداته.
هل Google Maps Scraper مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون Google Maps Scraper؟
ينشره GMapsExtractor. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.