Free, open-source Google Maps scraper for lead generation (Python, no API key, no Docker). Exports name, phone, email, website, rating and Instagram/Facebook/LinkedIn/TikTok/YouTube/X links to CSV. 100 places with emails in 44 s; --grid beats Google's 120 cap. MX email check, ad-pixel detection. Skill for Claude Code, Codex and Cursor.
Python agent-skillsb2b-leadsclaude-codeclaude-skillscodex-skillsemail-extractoremail-scrapergoogle-mapsgoogle-maps-extractorgoogle-maps-leadsgoogle-maps-scrapergoogle-maps-scraper-pythongoogle-maps-scrapinggooglemaps-scraperheadless-chromelead-generationlead-scraperno-api-keypythonweb-scraping
Add update script and Updating section to README (#34)
Mahan Aid99a47085a7d
diff --git a/README.md b/README.mdindex 5684e7c..83f9199 100644--- a/README.md+++ b/README.md@@ -333,6 +333,26 @@ google-maps-scraper-kit/</details>+## Updating++Pull the latest fixes with one command. It works in a clone of this repo or of your fork, and it+keeps your own commits:++```bash+bash scripts/update.sh+```++If the engine is running, the script restarts it so a new engine version takes effect.+Forked it on GitHub? Run `git push` afterwards, or click **Sync fork** on your fork's+page.++On Windows without Git Bash, run the same update by hand:++```bash+git pull https://github.com/Mahanaicoach/google-maps-scraper-kit.git master+docker compose up -d+```+## SupportFound a bug? [Open an issue](https://github.com/Mahanaicoach/google-maps-scraper-kit/issues/new/choose) withdiff --git a/scripts/update.sh b/scripts/update.shnew file mode 100755index 0000000..e53a0fd--- /dev/null+++ b/scripts/update.sh@@ -0,0 +1,61 @@+#!/usr/bin/env bash+# Update this kit to the latest version from github.com/Mahanaicoach/google-maps-scraper-kit.+# Works whether you cloned the original repo or your own fork. Your own commits+# are kept: git merges the update into them.+#+# bash scripts/update.sh+set -euo pipefail++UPSTREAM="https://github.com/Mahanaicoach/google-maps-scraper-kit.git"+BRANCH="master"++KIT_DIR="$(cd "$(dirname "$0")/.." && pwd -P)"+cd "$KIT_DIR"++# A ZIP download has no git history. Check the top level too, so a copy inside+# another repo (for example a git-tracked ~/.claude) is never merged into it.+if [ "$(git rev-parse --show-toplevel 2>/dev/null)" != "$KIT_DIR" ]; then+ echo "This folder is not a git clone of the kit, so it can't update itself."+ echo "Clone it again: git clone $UPSTREAM"+ exit 1+fi++if ! git diff --quiet HEAD --; then+ echo "You have uncommitted changes. Save them with 'git stash' (or commit them), then run this again."+ exit 1+fi++git remote get-url upstream >/dev/null 2>&1 || git remote add upstream "$UPSTREAM"+git fetch --quiet upstream "$BRANCH"++if ! git merge-base HEAD "upstream/$BRANCH" >/dev/null; then+ echo "This copy shares no history with the original (it was made with 'Use this template',"+ echo "or it is a shallow clone), so git can't merge updates into it."+ echo "See what changed: https://github.com/Mahanaicoach/google-maps-scraper-kit/commits/$BRANCH"+ exit 1+fi++BEFORE="$(git rev-parse HEAD)"+if ! git merge --no-edit "upstream/$BRANCH"; then+ echo+ echo "The update conflicts with your own changes in the files listed above."+ echo "Fix them, then run: git add -A && git commit --no-edit"+ echo "Or undo the update: git merge --abort"+ exit 1+fi++if [ "$BEFORE" = "$(git rev-parse HEAD)" ]; then+ echo "Already up to date."+else+ echo "Updated. What's new:"+ git log --oneline --no-merges -n 20 "$BEFORE..HEAD"+ if ! git remote get-url origin 2>/dev/null | grep -qi "mahanaicoach/google-maps-scraper-kit"; then+ echo "Your fork on GitHub is still on the old version. Run 'git push' to update it too."+ fi+fi++# A new kit version can pin a new engine image. Restart a running engine so it takes effect.+if [ "$BEFORE" != "$(git rev-parse HEAD)" ] && command -v docker >/dev/null 2>&1 \+ && [ -n "$(docker compose ps -q 2>/dev/null)" ]; then+ docker compose up -d+fi