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.

Agrici Daniel takes a selfie in front of a group of smiling local business owners, next to the words Free, for local businesses, Built for You

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
At a glance: Local SEO Brain version 0.3.0, checked against the public repository on 2026-10-17. You still need your own AI assistant plan, such as a paid Claude or ChatGPT subscription.

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.

Slide titled Accurate details, no tricks, with four cards: use your real business name, pick the fewest accurate categories, hide your address if you go to customers, and skip made-up rules such as post twice a week.
Figure 1. The Business Profile slide from my presentation. The first three cards come from Google's Business Profile guidelines; the fourth reflects that Google sets no required posting frequency. Sources are in the profile table below.

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

Street map of a coastal area with towns, roads and an estuary, under the grid of search points

Map data © OpenStreetMap contributors (ODbL)

Top 3: in the map pack10 of 41 points
Ranks 4 to 10: close, worth fixing18 of 41 points
Rank 11 or worse: not seen here13 of 41 points
Figure 2. The illustrative grid from my presentation (video at 3:40), redrawn here over the same OpenStreetMap map. Each circle is one search point; the number is the business's rank there. Small white circles mark points with no result. This is an example, not a real business. A real check, like the one Legends Geogrid produces, uses your own business and keywords.

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.

Obsidian graph view of the Local SEO Brain vault: hundreds of linked notes such as Claim Ledger, Approval Queue, Citation Audit Workflow and dashboard, with the repository folders listed on the left.
Figure 3. The brain open in Obsidian's graph view, from my screen recording. Every dot is a note and every line is a link your assistant can follow.
What ships in Local SEO Brain 0.3.0. Source: the repository README and files, checked 2026-10-17.
PartWhat it isWhy it helps you
59 chaptersBusiness Profile, reviews, directories, your website and AI search, each marked with how well the advice is backed by evidenceYou and your assistant can tell solid guidance from folklore
37 promptsQuestions for your assistant, written so it works from your data instead of guessingFaster drafts without made-up facts
6 rulebooksShort 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 providerYou follow the real rules, not forum rumours
Import adaptersManual evidence, Business Profile CSV, citation CSV, reviews JSON or CSV, and geo grid CSV. Raw files are kept unchanged and fingerprintedYour own numbers become dated evidence the plan can point back to
Draft planA scorecard, a roadmap and a weekly report, marked DraftYou see what is missing before anyone touches your accounts
Approval queueEvery suggested change waits for your yesNothing goes live by accident
Local SEO secretaryA written role your assistant can take on. It opens with: read the instructions first, read before you write, and default to read-only investigationKeeps 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.

  1. 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.

  2. 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.

  3. Approve what ships

    Every suggestion lands in an approval queue. You read it, you decide, and you or your agency post it.

The approval-first loop, as described in the repository README and shown in the video at 6:20.

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:

What Google's own rules say, and how the brain uses them. Sources: Google Business Profile Help and Maps content policy, checked 2026-10-17.
TopicWhat Google saysWhat 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 reviewsYou 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 reviewsMerchants 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 rulesGoogle 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:

The six refusals and the rule behind each. Sources: Google Business Profile guidelines, Maps content policy, Search spam policies, and the brain's safety gates, checked 2026-10-17.
It refusesWhy it is a risk
Fake addresses or virtual officesGoogle'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 reviewsFake engagement, paid or incentivised reviews, and asking only happy customers are all prohibited under Google's Maps content policy.
Link schemes and doorway pagesGoogle'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 spamLinks 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 passwordsThe brain is advisory and never logs in for you. Its rules forbid storing credentials in the vault.
Promising a number one rankingGoogle 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.

Slide titled AI answers use the same sources, with four points: no secret file or special code needed, clear pages that answer real questions, consistent name, phone and hours everywhere, and a warning that nobody can guarantee an AI will cite you.
Figure 4. The AI search slide from my presentation, shown in the video at 9:11.

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

  1. Make a folder

    Create a folder on your computer and name it after your business.

  2. Open your assistant in that folder

    In a terminal, go into the folder and type claude or codex. In a desktop app, turn on code mode and choose the folder when it asks which project to work in.

  3. 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.

  4. 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.

  5. Open it in Obsidian (optional)

    In Obsidian, choose Manage vaults, then Open folder as vault, and pick your business folder.

The install steps as I showed them in the video from 10:58 to 16:37.
Claude Code open in a terminal inside a folder named My local business, with the prompt: the Local SEO Brain GitHub link followed by install this brain.
Figure 5. The only install prompt you need, from my screen at 11:50 in the video.

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.
The setup prompt from the video at 16:45. You can write it in your own language.

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.

The Local SEO Brain dashboard note in Obsidian. Evidence first: run the dated freshness check before client work. Operator tasks: Start Here, Claim Ledger, Freshness Hub, Evidence Refresh Flow, Source Intake Workflow, Property Audit Workflow, GBP Optimization Workflow, Citation Audit Workflow, Synthesis and Reporting Workflows, and the Approval Queue.
Figure 6. The dashboard your assistant starts from, from my screen at 17:47 in the video. Each link opens a written workflow, ledger or queue.

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:

The free local SEO stack shown in the video. Versions and licenses checked on GitHub on 2026-10-17.
ToolWhat it doesCost and license
Local SEO BrainThe 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 BenjaminA 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 SEOA 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.

Slide titled People who fix, build, treat and serve, with four groups: trades such as plumbers, electricians, roofers and HVAC; builders such as contractors, landscapers and remodelers; shops and clinics such as dentists, salons, cafes and repair shops; and agencies serving many local clients at once.
Figure 7. Who it is built for, from my presentation, shown in the video at 9:50.

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

LinkedInX

Keep reading.

All 48 posts

Free community

Build this with other people.

The free AI Marketing Hub is where I share release updates and answer questions. 6,200+ builders are already inside, and it costs nothing to join.

Join the free AI Marketing Hub
↑ ↓ to move, Enter to open