GeckoGrid documentation
Everything you need to run GeckoGrid.
Install the desktop app, run your first geo-grid scan, automate the repeat work, and hand the rest to your AI agent. Local scans are free and unlimited on every plan.
- MCP tools for your AI agent
- 47
- bundled analyst skills
- 10
- free trial on monthly plans
- 7 days
- Solo plan, unlimited local scans
- $19/mo
Getting started
-
What is GeckoGrid GeckoGrid is a desktop app for local SEO that scans a grid of points around a business and maps exactly where it ranks in Google Maps.
-
Installing GeckoGrid System requirements, Windows and macOS installers, what gets installed on your machine, and how updates work.
-
Activating your license Enter your license key, how the 7-day free trial works on Solo and Agency, machine limits per tier, and how to deactivate a machine.
-
Your first scan Create a project, add a business and keywords, pick a grid shape and size, and read your first local rank heatmap.
Core concepts
-
Local scans and API scans Compare the two GeckoGrid scan engines: free unlimited local Chrome scanning versus DataForSEO API speed on Agency and Lifetime.
-
How scans run The scan queue, local scan pacing and browser tabs, the daily advisory counter, and the scan retention setting.
-
Reading scan history How the project page's Scan History works: map rank, like-for-like changes, the Keywords, Timeline, and Runs views, filters, and bulk actions.
Guides
-
Scheduling recurring scans Put projects on weekly, biweekly, or monthly scan schedules, run one on demand, decide what happens to scans missed while the app was closed, and start GeckoGrid at sign-in.
-
Exporting results Export heatmaps as PNG into an organised export folder, with white-label branding and auto-export, export CSV from Scan History, and use your AI agent for full top-20 CSVs and advanced image exports.
-
App settings and shortcuts Set the interface size, date, time, and distance formats, start GeckoGrid at sign-in, get a notification when scans finish, and use the keyboard shortcuts.
AI and MCP
-
Connecting an AI agent Connect Claude, Cursor, or Codex to GeckoGrid's local MCP server with the built-in setup prompt, 47 tools, and 10 analyst skills.
-
MCP tool reference All 47 GeckoGrid MCP tools in one place, grouped by what they do, from projects and scans to competitor intel, reports, schedules, and skills.
-
MCP analyst skills The ten analyst skills bundled with GeckoGrid: what each one teaches an AI agent, and when the agent should load it.
-
MCP recipes Four ready-to-paste agent workflows: a client report, a prospect pitch from scratch, an instant rank check, and keeping watch on a competitor.
-
MCP security How GeckoGrid contains the agent connection: localhost binding, bearer-token auth, keychain-stored credentials, and what an agent can never change.
DataForSEO
-
Setting up DataForSEO Create a DataForSEO account, add a little credit, connect your API credentials in GeckoGrid, and pick a delivery mode for your first API scan.
-
DataForSEO costs and spending controls Per-point pricing by delivery mode, worked cost examples for common grids, the spend panel, and the optional monthly spend cap that is the only hard refusal in the app.
Troubleshooting
-
Installation problems SmartScreen and Gatekeeper first-run warnings, the macOS App Management prompt, installers that will not run, and where to check requirements.
-
Scan problems Chrome not detected, scans that feel slow by design, stuck or failed scans, and results that look wrong.
-
Your agent can't connect MCP server status and the 1423 port, what happens after a token is regenerated, same-machine requirements, and re-copying the setup prompt.
-
License and activation problems Rejected keys, the machine limit per plan, what an offline launch really means, and how the 7-day trial billing works.
-
Data, backup, and moving machines Where projects and scans live on disk, the scan retention setting, exporting a database backup, moving to a new machine, and what deleting a project removes.
Reference
-
Release notes Every GeckoGrid release, newest first, from API-powered scanning and MCP agent tools to scheduling, grid shapes, and stability work.
-
Frequently asked questions Straight answers on the free trial and billing, machine limits, DataForSEO costs, local scan limits, white-label tiers, AI agents, and where your data lives.
-
Trials and billing What happens when your trial ends, how to cancel or change plans in the customer portal, and what stays on your machine if you cancel.