{
  "markdown": "<p align=\"center\">\n  <a href=\"https://gmapsextractor.com\">\n    <img src=\"logo.png\" alt=\"G Maps Extractor\" width=\"400\">\n  </a>\n</p>\n\n# Google Maps Scraper MCP server\n\nGive your AI agent live Google Maps business search, review, and photo data through one secure [Model Context Protocol](https://modelcontextprotocol.io/) connection.\n\nThis 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.\n\n- Website: [gmapsextractor.com](https://gmapsextractor.com)\n- Product page: [Google Maps Scraper MCP](https://gmapsextractor.com/google-maps-scraper-mcp)\n- Get an API key: [cloud.gmapsextractor.com](https://gmapsextractor.com/google-maps-scraper-mcp)\n- MCP endpoint: `https://cloud.gmapsextractor.com/api/mcp`\n- Transport: Streamable HTTP\n- Authentication: `Authorization: Bearer YOUR_API_KEY`\n\n## What you can do\n\n- Search businesses by keyword and location, including listing details such as names, addresses, phone numbers, websites, ratings, reviews, and photos.\n- Retrieve public Google Maps reviews for reputation research and customer feedback analysis.\n- Retrieve public business photos and image URLs for listing enrichment and visual audits.\n\nCommon workflows include prospecting research, local market analysis, competitor comparisons, CRM enrichment, reputation analysis, and listing audits.\n\n## Connect\n\nCreate an API key in the [G Maps Extractor dashboard](https://cloud.gmapsextractor.com), keep it in a secure environment variable or secret store, and register the remote endpoint with your MCP client.\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http google-maps-scraper-mcp \\\n  https://cloud.gmapsextractor.com/api/mcp \\\n  --header \"Authorization: Bearer YOUR_API_KEY\"\n```\n\n### Cursor\n\nAdd this to `.cursor/mcp.json` in your project:\n\n```json\n{\n  \"mcpServers\": {\n    \"google-maps-scraper-mcp\": {\n      \"url\": \"https://cloud.gmapsextractor.com/api/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n### VS Code\n\nAdd this to `.vscode/mcp.json` in your project:\n\n```json\n{\n  \"servers\": {\n    \"google-maps-scraper-mcp\": {\n      \"type\": \"http\",\n      \"url\": \"https://cloud.gmapsextractor.com/api/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n### Codex\n\nAdd this to `~/.codex/config.toml`:\n\n```toml\n[mcp_servers.google-maps-scraper-mcp]\ntype = \"http\"\nurl = \"https://cloud.gmapsextractor.com/api/mcp\"\n\n[mcp_servers.google-maps-scraper-mcp.headers]\nAuthorization = \"Bearer YOUR_API_KEY\"\n```\n\n### Cline\n\nAdd this to your MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"google-maps-scraper-mcp\": {\n      \"type\": \"streamableHttp\",\n      \"url\": \"https://cloud.gmapsextractor.com/api/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n## Tools\n\n### `search_google_maps`\n\nSearch for businesses and places on Google Maps in real time.\n\n| Parameter | Type | Required | Description |\n| --- | --- | --- | --- |\n| `q` | string | Yes | Search query, such as `coffee shops in New York` |\n| `ll` | string | No | Coordinates and zoom, such as `@40.7128,-74.0060,11z` |\n| `hl` | string | No | Language code; defaults to `en` |\n| `gl` | string | No | Country code; defaults to `us` |\n| `page` | number | No | Page number; defaults to `1` |\n| `extra` | boolean | No | Include emails, social profiles, and extended details |\n\n### `get_place_reviews`\n\nRetrieve public reviews for a place using the `fid` returned by `search_google_maps`.\n\n| Parameter | Type | Required | Description |\n| --- | --- | --- | --- |\n| `fid` | string | Yes | Google Maps feature ID returned by a search |\n| `page` | number | No | Page number; defaults to `1` |\n| `max_page` | number | No | Maximum number of pages to retrieve |\n| `sort_by` | number | No | `1` relevant, `2` newest, `3` highest rating, `4` lowest rating |\n\n### `get_place_photos`\n\nRetrieve public photos for a place using the `fid` returned by `search_google_maps`.\n\n| Parameter | Type | Required | Description |\n| --- | --- | --- | --- |\n| `fid` | string | Yes | Google Maps feature ID returned by a search |\n| `page` | number | No | Page number; defaults to `1` |\n| `max_page` | number | No | Maximum number of pages to retrieve |\n\n## Example prompts\n\n- “Find the top-rated coffee shops in Portland and return their website, phone number, rating, and review count.”\n- “Get the newest Google Maps reviews for this place and summarize the recurring customer complaints.”\n- “Retrieve public photos for these restaurant FIDs and identify locations with limited visual content.”\n- “Compare visible listing signals for dentists in Austin and group the results by rating.”\n\n## Authentication and usage\n\nEvery request must include your G Maps Extractor API key:\n\n```http\nAuthorization: Bearer YOUR_API_KEY\n```\n\nDo 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.\n\n## About this repository\n\nThis is a public discovery, configuration, and documentation repository. It contains:\n\n- `server.json` for MCP Registry-compatible server metadata\n- `.mcp.json` as a ready-to-customize client configuration\n- `llms-install.md` with concise installation instructions for AI agents\n- product icons and branding\n\nThe hosted MCP implementation remains at `https://cloud.gmapsextractor.com/api/mcp`.\n\n## License\n\n[MIT](LICENSE)\n",
  "bytes": 5557,
  "sha": "be2047383139fdace0791cb17694b3fd35b34523318bde61a268dee47008a1e2",
  "repo_slug": "gmapsextractor/google-maps-scraper-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_gmapsextractor_google_maps_scraper_9a063089/readme"
}