Files
geolocal-io/docs/THE_BLACK_BOX.md
T
grokbot_ty 303932d814 Add plain-language black box note for local SMB data drift.
Explain unreconciled NAP copies across platforms and syndicators,
the claim-as-source-of-truth fix, and the three-frame visual without
implementation detail.
2026-10-01 10:22:42 -07:00

64 lines
5.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# The black box of local business data
**Branch:** `planning-selfserve-audit`
**Status:** Working draft from conversation on 2026-10-01
**Audience:** owners, partners, and anyone who needs the problem in plain words
**Related:** [`SELF_SERVE_AI_DISCOVERABILITY_CONCEPT.md`](./SELF_SERVE_AI_DISCOVERABILITY_CONCEPT.md)
This note explains a quiet mess that sits under “why doesn’t AI recommend my business?” It is not a product checklist. It is the **big black box of confusion** — and how we intend to open it.
---
## The problem
A local business is not a single record on the internet. It is a **cloud of copies**.
Over years, real life moves. You change suite numbers. The town renumbers a road. The phone company swaps an area code. You get a new mobile for the shop. You update the website. Each of those changes is ordinary. What is not ordinary is what happens next.
Every major place that stores local businesses keeps **its own copy** of your name, address, and phone — the boring facts people call **NAP** (name, address, phone). Google Business Profile has a copy. Apple has a copy. Bing has a copy. Yelp has a copy. Foursquare’s place graph has a copy. Underneath many of them, **data aggregators and syndicators** (companies such as Data Axle and Localeze / TransUnion) hold yet another copy and push it out to directories, maps, navigation apps, and anything that buys “local listings” feeds.
Nobody is paid to keep all of those copies honest with each other.
So the copies **drift**. One still has the old area code. One still has the storefront you left three years ago. One has the right street but the wrong suite. Search engines and AI assistants do not magically know which copy is you today. They see a **black box of conflicting facts** and pick whatever their ranking and training happen to trust that week.
When an owner finally **claims** Google Business Profile and fixes it, that is powerful — GBP is usually the strongest **claim surface** an owner can touch. But it is not the only voice. Syndicated feeds can still broadcast the old NAP. Those stale copies can show up in search results and in AI answers **alongside or even above** the listing the owner just cleaned up. From the owner’s chair it feels like: “I fixed it — why does the world still lie about me?”
That is the problem in one line: **the owner cannot control what the world believes about their business**, because the world is not one database. It is a black box of unreconciled copies.
---
## The solution
We flip the direction of truth.
Today, copies compete. The owner chases them. Tomorrow, the owner **declares one clean NAP** — a single claimed truth for who they are and how to reach them — and that declaration becomes the **source of truth**. The job of the system is then to **push corrections outward** into the aggregators and syndicated feeds, instead of letting those feeds quietly overwrite or outrank the claim.
Think of it as three frames:
```text
BEFORE CLAIM AFTER
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ five wrong │ │ one clean │ │ copies that │
│ copies of │ ──────► │ NAP the │ ──────► │ match the │
│ the same │ │ owner just │ │ claim — │
│ business │ │ declared │ │ pushed out │
└─────────────┘ └─────────────┘ └─────────────┘
(the black box) (source of truth) (reconciled world)
```
**Frame one — left.** The black box: several disagreeing copies (Google, Apple, Bing, Yelp, Foursquare, and whatever else still carries an old feed). The owner did not ask for five versions of themselves. The market produced them.
**Frame two — middle.** The claim: one clean NAP the owner stands behind. That is the only version we treat as authoritative for *this* business. Fixing GBP still matters — it is often the best place to start the claim — but the point is the **declared truth**, not loyalty to any one logo.
**Frame three — right.** Corrections flowing out. The system’s job is to make the other copies **match the claim**, including the ugly middle layer most owners never see: **syndication**. Aggregators that feed directories and assistants must be visible on the scoreboard and fixable in the same story. If you only polish the claim surface and ignore syndication, the black box regenerates overnight.
What this is *not*: a promise that every directory on earth will update in an hour, or that AI will suddenly recommend you because your phone number matches. Matching NAP is the floor — **presence** with consistent facts. **Recommendability** (would an assistant pick you for a real customer question in your genre) still needs categories, relevance, and the rest of the product story. This note is about opening the black box so the floor stops moving under the owner’s feet.
---
## Why this matters for AI
Assistants answer from whatever they can find and trust. When five copies disagree, the assistant is guessing in the fog. When one claimed truth is pushed outward and the syndicators are brought into line, the fog thins. The owner is no longer shouting into a black box. They are updating a source of truth and watching the copies follow.
That is the strategic bet in plain words: **stop competing with your own stale twins. Claim once. Correct outward.**