npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

n8n-nodes-google-maps-agentic

v0.5.12

Published

Production-grade Google Maps & Places API scraper for n8n. Specifically designed for AI Agents, B2B lead generation, and mass email scraping with built-in rate limit handling.

Readme

npm version License: MIT


Are you tired of basic Google Maps nodes that just pull names and phone numbers, crash on large datasets, or fail when used by AI Agents?

Welcome to n8n-nodes-google-maps-agentic — a complete, production-grade overhaul of Google Maps data extraction for n8n. If you are building automated B2B Lead Generation workflows, researching competitor reviews, or equipping AI Agents (like Google Gemini, OpenAI, Claude) with local search tools, this is the only node you need.

This node transforms the standard Maps API into a relentless business intelligence tool. It visits business websites natively, scrapes Email Addresses, Instagram, and LinkedIn links, and seamlessly bypasses Google's strict pagination limits—all while being 100% memory-safe to prevent n8n server crashes.


🚀 Why Choose This Node? (Value Proposition & Expertise)

Built from the ground up to solve the most painful scaling issues in n8n scraping workflows.

  1. Memory-Safe Concurrency Processing: Fetching 60 websites simultaneously used to crash n8n Docker containers with CPU panics. This node utilizes a fine-tuned for...of sequential loop with a 200ms sleep buffer, preventing DNS timeouts and Cloudflare bans.
  2. AI-Agent Schema Safe: Conditionally hidden UI fields can cause AI models like Gemini to crash due to JSON Schema thought_signature / allOf validation errors. We've stripped out restrictive validations, allowing your LLMs to use this node as a flawless Native Tool.
  3. Data Protection Built-In: Large raw HTML website bodies are truncated to 150kb limits before passing to Regex email matching—completely eliminating V8 Engine thread locks associated with catastrophic backtracking.

✨ Key Features & Capabilities

  • 📧 Native Email & Social Extraction: Stop using expensive third-party tools. Send a Text Search, and this node will automatically extract mailto: email addresses and social media links directly from the local business's website.
  • 🔄 Automatic Pagination & Rate Limiting: Effortlessly retrieves all 60 results from a text search using automatic token pagination and Exponential Backoff.
  • 💸 Cost-Controlled API Calls: Stop overpaying Google! Use precise Data Fields masks (Basic, Contact, Full) to control API costs per request. Need just names and emails? Use the cheapest tier.
  • Advanced Review Analysis Tools: Fetch the newest reviews, filter for negative ratings (competitor analysis), or search for specific keywords inside reviews.
  • 🌍 Localization & Geo-Targeting: Narrow results using exact Language Code and Region Code biasing.

🛠️ How To Install

Method 1: Quick Install (n8n UI) - Recommended

  1. Go to your n8n instance -> Settings -> Community Nodes.
  2. Click Install.
  3. Enter n8n-nodes-google-maps-agentic and click Install.

Method 2: NPM (Self-Hosted/Docker) Run the following command in your n8n installation directory:

npm install -g n8n-nodes-google-maps-agentic

📋 Available Operations (The API Arsenal)

This node utilizes both the modern Google Places API (New) and the established routing APIs.

  1. Text Search (Paginated): Natural language search (e.g., "plumbers in London"). Automatically fetches up to 60 results. Includes full access to Emails, Reviews, and localization.
  2. Search Nearby: Find places around a specific Latitude/Longitude with a set radius limit. Includes all features.
  3. Get Place Details: Deep scrape a specific place_id for granular hours, reviews, and photos.
  4. Get Photo: Convert a Google Maps photo_reference into a raw .jpg URL stream.
  5. Geocode / Reverse Geocode: Convert physical addresses into Latitude/Longitude coordinates or vice-versa.
  6. Distance Matrix: Calculate real-time travel parameters (drive times, distances) between origins and destinations.
  7. Directions: Get step-by-step navigation instructions.

💡 Practical Use Cases & Workflows

1. The Ultimate B2B Cold Email Pipeline

Turn Google Maps into an automated lead machine.

  • Workflow: Schedule Trigger ➡️ Google Maps Agentic (Text Search: "Marketing agencies in Austin" + Extract Emails = True) ➡️ OpenAI (Write personalized intro email based on their Maps profile) ➡️ Gmail/Outlook (Send draft).

2. Automated Competitor Review Analysis

Understand exactly what customers hate about your competitors.

  • Workflow: Webhook Trigger ➡️ Google Maps Agentic (Place Details: Max Rating 3, Sort: Newest) ➡️ AI Agent (Categorize poor reviews to find business improvement opportunities for your sales team).

3. AI Agent "Local Guide" Assistant

Give your AI Chatbot eyes into the real world.

  • Workflow: Expose this node as a Tool to an AI Agent. When a user asks "Find me a highly rated sushi place open now in Tokyo", the AI dynamically passes the parameters, queries the map, reads the reviews, and summarizes the best options natively.

🔑 Authentication Guide

You must use a Google Cloud Platform (GCP) account. Enable the following APIs in your GCP Console to unlock full functionality:

  • Places API (New) (Required for Search and Details)
  • Geocoding API
  • Distance Matrix API
  • Directions API

Create an API Key, restrict it if necessary, and insert it into the Google Maps API credential inside your n8n workspace.


🤝 Community, License & Support

Distributed under the MIT License. Designed and optimized by the n8n community to push the boundaries of seamless data scraping and LLM-powered AI workflows.

If you encounter an issue or have a feature request, please open an issue on the GitHub repository. Happy automating!