Local SEO Brain: Free Local SEO for Small Business With Claude or ChatGPT
A free, open-source brain your AI assistant reads so you can do your own local SEO: how Google ranks local results, install steps, six refusals and honest limits.

Local SEO Brain is a free, open-source guide that your AI assistant reads so it can help you do your own local SEO, the honest way. You give Claude Code, Codex or a desktop assistant with code mode the repo link, it sets the brain up in a folder on your computer, and from what you give it (your Business Profile data, reviews, directory list and notes about your website) it drafts a plan: a scorecard, a roadmap and a weekly report. Nothing is posted or changed anywhere until you say yes.
I built it as a thank you to the people who fix, build, treat and serve: plumbers, electricians, dentists, cafes, roofers, and the agencies who help them. If you have been looking for local SEO for small business that you can actually do yourself, without buying links or tricks, this is the written companion to my video walkthrough: how local ranking works, what is inside the brain, the six things it refuses to do, the install, and two free tools that complete the check.
Updated October 17, 2026, for Local SEO Brain version 0.3.0 and the October 15 video. First published May 21, 2026, about the first version.
- 59plain-language chapters, each marked with how well it is backed
- 37ready-to-use prompts for your AI assistant
- 6current rulebooks, each with a review date
- 6things it refuses, even if you ask
- $0MIT license: use it for your business or your clients
Key takeaways
- Google says local results depend mainly on relevance, distance and prominence, and you cannot pay for a better local ranking. The brain helps you work on the parts you control.
- Your rank is not one number. It changes with where the customer stands, which is why a geo grid check beats a single search.
- The brain is a folder of plain text notes your assistant reads, so it works from Google's published rules instead of guessing.
- It is approval first: it drafts, you decide, and you or your agency make the change. It never asks for your password.
- Nobody can guarantee you rank first or get cited by an AI answer. That includes me, and that includes this tool.
Watch the walkthrough
The video is 23 minutes: a short presentation on how local search works, then the real install on my screen, the brain open in Obsidian, the setup prompt for a real business, and the two companion tools.
Video: “I Built a Free Local SEO Brain for Small Businesses” by Agrici Daniel, published 2026-10-15. The privacy-enhanced player loads only after you activate it. Watch directly on YouTube.
Jump to a chapter (18 chapters)
- 0:00 A free brain for local businesses
- 1:26 Someone nearby is searching for what you do
- 3:40 Rankings change street by street
- 5:11 Old advice vs one place for everything
- 6:39 Nothing goes live without your yes
- 7:20 Reviews: ask, reply, never fake
- 8:28 Six things it refuses
- 9:11 AI answers use the same sources
- 10:00 The repo
- 10:58 Install it with your AI agent
- 13:05 Connect Google (Cloud CLI and Business Profile)
- 14:20 Open it in Obsidian
- 16:37 Set it up for a real business
- 17:42 The Start Here dashboard
- 18:51 For agencies
- 20:20 Pair it with Claude SEO
- 21:08 Legends Geogrid map check
- 22:19 Wrap-up
How local SEO for small business works, in plain words
Someone has a burst pipe or a cracked tooth. They pick up their phone and search "plumber near me" or "dentist near me". For searches like that, Google usually shows a map with a short list of businesses, often called the map pack, before the regular results. Being in that short list is what local SEO is about.
Google's own help page says local results are based mainly on three things: relevance (how well your profile matches the search), distance (how far you are from the person searching, or from the place they named), and prominence (how well known your business is, online and off). On reviews, the same page says: "More reviews and positive ratings can help your business's local ranking." Google keeps the details of its algorithm confidential, and it states plainly: "There's no way to request or pay for a better local ranking on Google" (Google Business Profile Help).
So the useful question is not "what trick works this year". It is "are my details accurate, are real customers talking about me, and does my website answer what people ask". That is what the brain helps your assistant work through.

Rankings change street by street
Because distance is part of the ranking, there is no single "my rank". The top three for "plumber" on one side of town can be a different top three a few streets away. A geo grid check shows this: it runs the same search from many points on a map around your business and records where you appear at each point.
Illustrative geo grid
Same search, same business, 41 results across the map
Map data © OpenStreetMap contributors (ODbL)
Reading a grid is simple. Purple points are where you are in the top three, so customers there see you in the map pack. Gold points are ranks 4 to 10: close, and worth fixing. Grey points are rank 11 or worse, where people searching rarely see you. Start with the weak zones that matter to your business, for example the area your vans already drive to every day.
The brain does not pick zones for you, and it does not claim to know why you rank where you do. Its geo grid import records, with a date, the average rank and the share of top three points for each keyword, because a grid shows where, not why.
What is Local SEO Brain?
It is a folder of Markdown notes, which is plain text with a little formatting. That folder is also an Obsidian vault, so you can open it in Obsidian and browse it like a wiki with links and a graph. Your AI assistant does the reading, so you do not need SEO knowledge to use it.

| Part | What it is | Why it helps you |
|---|---|---|
| 59 chapters | Business Profile, reviews, directories, your website and AI search, each marked with how well the advice is backed by evidence | You and your assistant can tell solid guidance from folklore |
| 37 prompts | Questions for your assistant, written so it works from your data instead of guessing | Faster drafts without made-up facts |
| 6 rulebooks | Short dated notes on the 2026 search update timeline, the current state of Business Profile, structured data boundaries, AI search, community content and AI citations, and how to evaluate AI models without favouring one provider | You follow the real rules, not forum rumours |
| Import adapters | Manual evidence, Business Profile CSV, citation CSV, reviews JSON or CSV, and geo grid CSV. Raw files are kept unchanged and fingerprinted | Your own numbers become dated evidence the plan can point back to |
| Draft plan | A scorecard, a roadmap and a weekly report, marked Draft | You see what is missing before anyone touches your accounts |
| Approval queue | Every suggested change waits for your yes | Nothing goes live by accident |
| Local SEO secretary | A written role your assistant can take on. It opens with: read the instructions first, read before you write, and default to read-only investigation | Keeps your assistant careful with your business data |
The repository includes instruction files for Claude Code, Codex and Gemini (CLAUDE.md, AGENTS.md and GEMINI.md).
Nothing goes live without your yes
This is the most important part of the design. The brain is advisory. It does not edit your Business Profile, Search Console, Google Maps, review sites, directories or website on its own, and it never asks for your password.
How it works
Three steps. You approve each one.
- Bring what you have
A Business Profile export, a reviews file, a list of directories you are on, a geo grid report if you have one. Notes are fine too.
- Get a draft plan
A scorecard, a roadmap and a weekly report. Each line points back to the evidence it came from. Where there is no evidence, it says so instead of guessing.
- Approve what ships
Every suggestion lands in an approval queue. You read it, you decide, and you or your agency post it.
The scorecard stays marked Draft on purpose. The brain does not invent a grade or a score out of 100, because no transparent scoring model exists yet. It shows what the evidence says and what is missing.
Your Business Profile and reviews: what the brain tells you
A few examples of the guidance inside, next to Google's own published rules:
| Topic | What Google says | What the brain does |
|---|---|---|
| Your name | "Your name should reflect your business's real-world name, as used consistently on your storefront, website, stationery, and as known to customers." Adding unnecessary information to the name "isn't permitted, and could result in the suspension of your Business Profile" (guidelines). | Its guidance tells your assistant to use your real-world name, the one on your van and invoices, with no extra keywords or city names. |
| Categories | "Choose the fewest number of categories it takes to describe your overall core business." | Guidance: one main category that says what you do, extras only when true. |
| Address | "If you're a service-area business, you should hide your business address from customers." A remote mailbox or a virtual office you do not work from is not an eligible address. | Guidance: list a service area instead of a home, a mailbox or a desk you never use. |
| Asking for reviews | You can ask customers to leave a review through a Google link or QR code, and "As best practice, reply to reviews and share your perspective" (tips). | Your assistant can draft review replies for you to approve. |
| Filtering reviews | Merchants may not "selectively solicit positive reviews from customers", offer incentives, or post fake engagement (policy). | Tells you to ask every customer, never only the happy ones. Keeps reviewer names out of its notes. |
| Posting rules | Google sets no required posting frequency. Repeating a post is optional, and posts older than 6 months are archived (posts help). | Marks "post twice a week" and "reply within 24 hours" style rules as unsupported. |
On reviews, the advice is short: ask every customer, reply to every review, never fake one. Ask the unhappy customers too, because filtering who gets asked is itself against Google's rules. Your assistant can draft replies for you to approve, and reviewer names stay out of the brain's notes and reports.
In the video I searched "plumber near me" and then "best plumber near me", and the top result changed. One pair of searches proves nothing about causes, but it shows how much the exact words people type shape what they see.
Six things it refuses to do
The brain's rules say no to these even if you ask, and point to the honest alternative instead:
| It refuses | Why it is a risk |
|---|---|
| Fake addresses or virtual offices | Google's guidelines rule out remote mailboxes and virtual offices you do not work from. A profile at an ineligible address can be suspended. |
| Fake or filtered reviews | Fake engagement, paid or incentivised reviews, and asking only happy customers are all prohibited under Google's Maps content policy. |
| Link schemes and doorway pages | Google's spam policies cover link spam and doorway abuse, which they describe as pages "created to rank for specific, similar search queries" (spam policies). |
| Mass directory spam | Links built mainly to manipulate rankings fall under Google's link spam policy. Instead, the brain's citation workflow has your assistant review the listings you already have. |
| Asking for your passwords | The brain is advisory and never logs in for you. Its rules forbid storing credentials in the vault. |
| Promising a number one ranking | Google says there is no way to request or pay for a better local ranking, and it keeps its algorithm details confidential. Nobody can honestly promise first place. |
It also does not grade your business with a made-up score, and it does not claim to know why a competitor outranks you.
If an agency once bought you cheap links or set you up in a virtual office, read this part twice. Google's Search Status Dashboard lists a spam update that began on September 24, 2026 and finished on October 8, 2026. Updates like that are a reminder that shortcuts can stop working without warning, while accurate details and real reviews keep their value.
AI answers use the same sources
People now ask AI assistants and Google's AI features for a local recommendation, and someone is always selling a secret trick for it. Google's own guidance for its AI features says: "There are no additional requirements to appear in AI Overviews or AI Mode, nor other special optimizations necessary." It adds that you do not need special structured data or AI text files (Google Search Central). What you control is the same list as for the map pack: an accurate profile, real reviews, and clear pages that answer the questions customers ask, with the same name, phone and hours everywhere.

In the video I also said you will appear number one in your area. Nobody can promise that, and the brain itself refuses to. What it can do is help you find what to fix, draft it, and wait for your yes.
Install it step by step
Before you start: you need a paid plan for an AI assistant that can work with files in a folder, such as Claude Code, Codex, or the Claude or ChatGPT desktop app with code mode turned on. The brain's own scripts need Python 3.11 or newer; your assistant can check that for you. I use Claude Code in the terminal because it is simplest for me, and that is the only one I showed in the video. The others should work the same way. On Windows, the import scripts may need WSL (see Limits).
Install
From an empty folder to a working brain
- Make a folder
Create a folder on your computer and name it after your business.
- Open your assistant in that folder
In a terminal, go into the folder and type
claudeorcodex. In a desktop app, turn on code mode and choose the folder when it asks which project to work in. - Paste the repo link
Say:
https://github.com/AI-Marketing-Hub/local-seo-brain install this brain. It copies the repository into the folder. Prefer not to? On GitHub, use Code, then Download ZIP, and unzip it there. - Bring your Google data (optional)
The easiest start is files. In Business Profile Manager you can download a performance report as a spreadsheet: select your profile, choose Actions, then Insights, pick a timeframe and download the report (Google's help). That CSV is what the brain's Business Profile import reads. Save it in your business folder, along with any reviews export you have (a CSV with rating and date columns works), and tell your assistant where they are. If you want your assistant to read Search Console or Business Profile data directly, ask it to help you install the Google Cloud CLI (
gcloud) and connect your accounts. In the video I called it the Google console CLI; the real name is Google Cloud CLI. Direct Business Profile API access needs a request that Google must approve. - Open it in Obsidian (optional)
In Obsidian, choose Manage vaults, then Open folder as vault, and pick your business folder.

Engineers who want the scripts directly will find the scaffold, ingest, synthesize and lint commands in the README's collapsed "For engineers and contributors" section.
Set it up for a real business
Once the brain is installed, the setup is one sentence. In the video I gave my assistant a real local contractor's website and typed a prompt like this (cleaned up here):
> help me set up the Local SEO Brain for my business: [your website]Guide me through the process and help me set it up in full.
From there your assistant is told to follow the brain's own Start Here note: before client work, check how fresh the evidence is, confirm the owner, the location model and the privacy boundary, use only the evidence you authorize, and leave missing inputs marked as missing. The rules tell it not to invent data, so without your Business Profile it should work from your website and what is public. As I explained in the video, it should then tell you what is missing, for example a page for a town you serve or a missing meta description.

Then you review. Read the draft scorecard, approve the first few fixes, make the changes yourself or hand them to whoever runs your website, and check again in a few weeks.
The free local SEO stack: brain, geo grid, site audit
The brain tells your assistant what good looks like. Two other free tools give it fresh evidence to work from:
| Tool | What it does | Cost and license |
|---|---|---|
| Local SEO Brain | The rules, the prompts and the approval queue. Turns your exports into a draft plan. | Free, MIT, version 0.3.0 |
| Legends Geogrid, by my partner Benjamin | A Google Maps grid rank check you run locally: where you rank from each point around your business, as a PDF or HTML report plus CSV and JSON files. The brain's geo grid import reads CSVs with keyword and rank columns, so check that your Legends CSV has those before you import it. | Free, MIT, version 0.1.0. Searches are billed to your own DataForSEO account |
| Claude SEO | A full SEO audit of your website for Claude Code: broken links, orphan pages, technical issues and more. | Free, MIT, version 2.4.2 |
For the geo grid in the video, my check and report cost around $1 in DataForSEO credits. Legends Geogrid runs on your own DataForSEO account, pay per use, with no subscription. Its README estimates one 17 by 17 scan (289 searches) at about $0.17 on DataForSEO's standard queue, before optional extras, so your cost depends on the grid size, the number of keywords and the queue. We ran one for a member of our community, and you can run one for yourself.
For agencies
No offense meant, agencies: this is for you too. Not every client has the time or the technical knowledge, and your job is to set things up correctly for them. The brain gives you one vault per client or location, the same rules everywhere, source-cited plans built from each client's own exports, and a clear line that nothing changes on a live account without the owner's yes.

Limits to know before you rely on it
- It cannot guarantee rankings or AI citations. Results depend on your business, your area, your competitors and your work.
- It does not act for you. That is a safety choice. You or your agency still make every change.
- Your assistant still needs reviewing. The rules are written instructions your AI follows, not hard locks. Read what it proposes before you approve it.
- Advice ages. The rulebooks carry review dates, and the freshness check flags overdue evidence. Run it before client work.
- It is version 0.3.0 and still maturing. The repository's own October 15 verification report records zero critical failures and all 14 test scripts passing, but its strict Brainstein maturity gate still fails, mainly because notes are shorter than that checker's line and link quotas, so the report calls it a review candidate, not market ready. There is no GitHub release yet. The import scripts use a module that exists only on macOS and Linux, so on native Windows they may not run without WSL.
- Your data goes where your assistant goes. The brain's scripts make no network calls, but whatever your AI assistant reads is processed by its provider, such as Anthropic or OpenAI, under their terms. Notes leave reviewer names out, but a raw review export can still contain personal data, so keep the vault on your own machine and access controlled.
Frequently asked questions
Is Local SEO Brain free?
Yes. It is open source under the MIT license, so you can use it for your own business or for clients, change it and share it. You need your own AI assistant plan, such as a Claude or ChatGPT subscription. Obsidian is free, and paid data such as a DataForSEO geo grid scan is optional.
Do I need to be technical to use it?
No. Make a folder for your business, open Claude Code, Codex or a desktop assistant with code mode in that folder, paste the repo link and say "install this brain". Then ask: "help me set up the Local SEO Brain for my business". You need a paid plan for that assistant.
Will it change my Google Business Profile on its own?
No. It is advisory. Every suggestion lands in an approval queue, you decide, and you or your agency make the change. It never asks for your password.
What does Local SEO Brain refuse to do?
Fake addresses or virtual offices, fake or filtered reviews, link schemes and doorway pages, mass directory spam, asking for your passwords, and promising a number one ranking. Each one risks a suspended profile, a penalised site, or your customers' trust.
Can it guarantee I rank first on Google Maps or get cited by AI?
No, and nobody can. Google says there is no way to request or pay for a better local ranking. AI answers draw on the same things you control: an accurate profile, real reviews and clear pages. The brain helps you get those right.
Does it work outside the US?
Yes. It follows Google's global Business Profile and Search rules and works from your own data, so it fits any country. The notes are in English, and your assistant can work with you in your own language.
Do I need Obsidian?
No. The brain is a folder of plain text files your assistant reads directly. Obsidian lets you browse the notes, links and graph yourself. It costs nothing for personal or commercial use, but it is not open source.
Which AI assistants work with it?
The repository ships instruction files for Claude Code, Codex and Gemini. In the video I used Claude Code in the terminal. Desktop apps with a code mode that can work with files in a folder should work the same way.
How much does a geo grid check cost?
Legends Geogrid is free and uses your own DataForSEO account, pay per use. Its README estimates one 17 by 17 scan at about $0.17 on the standard queue, before optional extras. My check and report in the video cost around $1.
Does it send my business data anywhere?
The brain's scripts make no network calls, and your exports stay in your vault. But whatever your AI assistant reads is processed by its provider, such as Anthropic or OpenAI, under their terms, and any Google accounts you connect follow Google's. A raw review export can contain personal data, so keep the vault access controlled.
Methodology and disclosure
I built Local SEO Brain and made the video, so I am not neutral. The tool is free and MIT licensed. I run AI Marketing Hub; AI Marketing Hub Pro is a paid community where we go deeper on tools like this, and you do not need it to use the brain. Legends Geogrid is built by my partner Benjamin, and Claude SEO is my own open-source project.
Repository facts were checked against the public repository and its files on 2026-10-17, and Google's rules against Google's own help and developer pages on the same day. Rules change, so follow the links for current wording. Figure 2 is an illustrative example, not a real business's data. Figures 1, 4 and 7 are slides from my presentation; Figures 3, 5 and 6 are frames from my screen recording in the video published 2026-10-15. This article was drafted with Claude Code from my video, my presentation and the repository, then fact checked against the sources linked above.
Not affiliated with Google, Anthropic, OpenAI or Obsidian.
Share this article



