Skip to content

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.

Add update script and Updating section to README (#34)

Mahan Aid99a47085a7d
diff --git a/README.md b/README.md
index 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
+```
+
## Support
Found a bug? [Open an issue](https://github.com/Mahanaicoach/google-maps-scraper-kit/issues/new/choose) with
diff --git a/scripts/update.sh b/scripts/update.sh
new file mode 100755
index 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