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.

feat(ui): sponsor box lists the current premium sponsors from assets/sponsors/sponsors.json

Mahanaicoache7f89416849a
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 93edfd6..83ada37 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -36,6 +36,7 @@ jobs:
curl -s http://localhost:8080/ | grep -q 'github.com/Mahanaicoach/google-maps-scraper-kit'
curl -s http://localhost:8080/ | grep -q 'id="email" name="email" checked'
curl -s http://localhost:8080/api/docs | grep -q 'redoc/v2.5.0/'
+ curl -s http://localhost:8080/ | grep -q 'assets/sponsors/sponsors.json'
- name: proxy refuses other hosts and other sites
run: |
test "$(curl -s -o /dev/null -w '%{http_code}' -H 'Host: evil.com' http://localhost:8080/api/v1/jobs)" = 421
diff --git a/README.md b/README.md
index 1ef0eee..5f15247 100644
--- a/README.md
+++ b/README.md
@@ -55,7 +55,7 @@ Access Google Maps listings, reviews, directions, and other public search data w
Maps API, delivered as clean, structured JSON and Markdown.
[**Try SerpApi →**](https://serpapi.com/maps-scraper-kit-github)
-<p align="center"><sub><a href="https://github.com/sponsors/Mahanaicoach">Become a sponsor</a></sub></p>
+<p align="center"><sub><a href="https://github.com/sponsors/Mahanaicoach">Become a sponsor</a> · Sponsors also appear in the sponsor box of every installed copy's web UI, read from <a href="assets/sponsors/sponsors.json">assets/sponsors/sponsors.json</a>.</sub></p>
---
@@ -198,8 +198,9 @@ One keyword per line. One job. One CSV.
- **The web UI is the engine's own page.** It downloads the raw 36-column CSV and uses the engine's
slower email option, whose `emails` column can keep junk such as `sentry.wixpress.com` and image
names. For a clean outreach list, use the scripts. The page also loads its scripts,
- fonts and map tiles from public CDNs and OpenStreetMap, so it needs internet. Scraped data stays on
- your machine.
+ fonts and map tiles from public CDNs and OpenStreetMap, and its sponsor box from this repo on
+ GitHub (`assets/sponsors/sponsors.json`, a static file, no tracking), so it needs internet.
+ Scraped data stays on your machine.
- **Apple Silicon runs natively from v1.18.0 on.** The image publishes arm64 builds, so M-series
Macs need no emulation. Older tags are amd64 only and run under emulation.
diff --git a/assets/sponsors/sponsors.json b/assets/sponsors/sponsors.json
new file mode 100644
index 0000000..e18c3ec
--- /dev/null
+++ b/assets/sponsors/sponsors.json
@@ -0,0 +1,15 @@
+{
+ "_comment": "Premium sponsors shown in the sponsor box of the kit's web UI. Edit this file and push: every installed copy's web UI reads it from GitHub in the browser (a static file, cached for a day, no tracking). Fields: name (shown as the link text), url (https only), tagline (one short line). Four at most are shown.",
+ "sponsors": [
+ {
+ "name": "Swiftproxy",
+ "url": "https://www.swiftproxy.net/?ref=googlemapsscraperkit",
+ "tagline": "residential proxies for Google Maps scraping, code PROXY90 for 10% off"
+ },
+ {
+ "name": "SerpApi",
+ "url": "https://serpapi.com/maps-scraper-kit-github",
+ "tagline": "Google Maps API in JSON and Markdown"
+ }
+ ]
+}
diff --git a/ui-branding.conf b/ui-branding.conf
index 10cf655..ed7bf26 100644
--- a/ui-branding.conf
+++ b/ui-branding.conf
@@ -42,7 +42,10 @@ server {
# pagination <div>. htmx parses a <tbody> reply inside a <table>, where that <div> breaks the
# parse, so #job-tbody disappears and later swaps have no target. The script splits the <div>
# off before the swap and applies it itself. Remove this once the engine ships the fix.
- # The JS avoids double quotes and dollar signs, which this nginx string would mangle.
+ # Second script: the sponsor box lists the kit's current premium sponsors from
+ # assets/sponsors/sponsors.json on GitHub (a static file, fetched by the browser, cached a day,
+ # no tracking). Names and taglines are set as text, never as HTML, and only https links are used.
+ # Both scripts avoid double quotes and dollar signs, which this nginx string would mangle.
sub_filter '</body>' "<script>
document.addEventListener('htmx:beforeSwap', function (e) {
var r = e.detail.serverResponse || '', i = r.search(/<div id=.pagination-container/);
@@ -56,6 +59,37 @@ document.addEventListener('htmx:beforeSwap', function (e) {
htmx.process(document.getElementById('pagination-container'));
});
});
+</script>
+<script>
+(function () {
+ var p = document.querySelector('#sponsor-section .sponsor-text');
+ if (!p || !window.fetch) return;
+ var url = 'https://raw.githubusercontent.com/Mahanaicoach/google-maps-scraper-kit/master/assets/sponsors/sponsors.json';
+ var key = 'gmskit-sponsors', day = 86400000;
+ function render(list) {
+ if (!Array.isArray(list) || !list.length) return;
+ p.textContent = 'Sponsored by ';
+ var shown = 0;
+ list.slice(0, 4).forEach(function (s) {
+ if (!s || typeof s.name !== 'string' || typeof s.url !== 'string' || s.url.indexOf('https://') !== 0) return;
+ if (shown++) p.appendChild(document.createTextNode(' | '));
+ var a = document.createElement('a');
+ a.href = s.url; a.target = '_blank'; a.rel = 'noopener noreferrer sponsored';
+ a.textContent = s.name.slice(0, 40);
+ p.appendChild(a);
+ if (typeof s.tagline === 'string' && s.tagline) p.appendChild(document.createTextNode(': ' + s.tagline.slice(0, 120)));
+ });
+ }
+ try {
+ var c = JSON.parse(localStorage.getItem(key) || 'null');
+ if (c && Date.now() - c.t < day) { render(c.list); return; }
+ } catch (e) {}
+ fetch(url, {cache: 'no-store'}).then(function (r) { return r.ok ? r.json() : null; }).then(function (d) {
+ if (!d || !Array.isArray(d.sponsors)) return;
+ render(d.sponsors);
+ try { localStorage.setItem(key, JSON.stringify({t: Date.now(), list: d.sponsors})); } catch (e) {}
+ }).catch(function () {});
+})();
</script></body>";
}
}