Compare local visibility at matched places and times
Get the source data and prepare the review

Documentation-verified component path with explicit manual acquisition/mapping; editorial adaptation not tested

WHAT WAS CHECKED
Documentation checked 2026-10-15. Official documentation establishes component UI/capability only. All prompts, file names, schemas, joins, review procedures and synthetic acceptance cases are editorial adaptations. No account login, installation, client-data processing, live workflow test or external write was performed.

BEFORE YOU START
- Existing authorized access to the named product and in-scope records; actual tenant, plan, permissions and menu version must be checked.
- Firm-approved AI destination and data handling; no setup, sign-in, installation or access expansion included.

DATA ACQUISITION LIMITS
- BrightLocal Local Search Grid has no documented CSV/XLSX download in its current export matrix. A generic grid CSV cannot be assumed.
- Missing fixed point identity or incomparable scan settings blocks a matched numerical comparison.

MAP THE ACTUAL SOURCE TO THE REVIEW INPUT
Actual report/run timestamp → observed_at/timezone; selected keyword → query; office/listing identity → office_id; displayed point coordinate or frozen grid-position key → point_id/lat/lon where actually known; displayed rank/not-found/depth → rank/status/scan_depth. Manual transcription adds source_ref and checker. Never turn not-found (beyond depth) or missing into an exact numerical rank.

INPUTS THE ASSISTANT MAY READ
local-grid.csv; grid-protocol.txt; run-captures/; manifest.txt; evidence-map.csv

WHERE THE ANALYSIS RUNS
Claude Code (existing approved local session)

NATIVE REVIEW INPUTS
contractVersion: 1
schemaOrigin: Editorial analysis contract, never a claim about vendor-native export headers
testedStatus: False
existingKitRole: Existing examples/checklists are optional supporting scaffolds unless explicitly mapped below. Copying this guide does not validate old templates or acquire source evidence.
requiredInputs: - name: local-grid.csv
type: csv
headers: - run_id
- office_id
- query
- provider
- observed_at
- timezone
- point_id
- latitude
- longitude
- rank
- observation_status
- scan_depth
- grid_config_id
- method_device
- source_ref
- checked_by
required: True
templateFilename: native-local-grid-template.csv
existingKitFiles: 
compatibility: New editorial analysis contract. Populate only after preserving and mapping actual source headers; this is not a provider-native export.
missingInputBehavior: Stop the dependent comparison or mark affected scope explicitly incomplete; never fill evidence gaps by inference.
inputName: local-grid.csv
compatibleWithoutMapping: False
- name: grid-protocol.txt
type: text
requiredSections: - exact office identity and approved public office coordinates
- fixed exact queries, grid point IDs/coordinates or frozen origin/spacing/shape
- provider, method/device, depth and not-found/missing definitions
- run dates/times/timezone; comparability requirements; transcription checker
required: True
templateFilename: native-grid-protocol-template.txt
existingKitFiles: - grid-protocol-template.txt
compatibility: New companion capture/review record. Staff supplies observed or approved values; unknown is explicit.
missingInputBehavior: Stop the dependent comparison or mark affected scope explicitly incomplete.
inputName: grid-protocol.txt
sections: - exact office identity and approved public office coordinates
- fixed exact queries, grid point IDs/coordinates or frozen origin/spacing/shape
- provider, method/device, depth and not-found/missing definitions
- run dates/times/timezone; comparability requirements; transcription checker
compatibleWithoutMapping: False
- name: run-captures/
type: source-bundle
required: True
templateFilename: None
requiredContents: Actual BrightLocal PDF/screenshots and point-level evidence for each run_id, not assumed CSV export
compatibility: Must be actual approved public/deidentified source content, not an empty template. Untouched originals remain separately restricted.
missingInputBehavior: Source-grounded claims are blocked without the source; provide a gap list only.
inputName: run-captures/
compatibleWithoutMapping: False
- name: manifest.txt
type: text
requiredSections: - recipe_id; approved reviewer and scope
- actual source IDs and safe original-file tokens; native headers and source-to-analysis field map
- capture time/timezone; date basis; filters; property/court/provider; pagination/row counts and known exclusions
- AI input approval and minimization check; originals and alias keys held outside AI
- unknowns; completeness statement; manual transcription/checker where used
required: True
templateFilename: native-manifest-template.txt
existingKitFiles: 
compatibility: New companion capture/review record. Staff supplies observed or approved values; unknown is explicit.
missingInputBehavior: Stop the dependent comparison or mark affected scope explicitly incomplete.
inputName: manifest.txt
sections: - recipe_id; approved reviewer and scope
- actual source IDs and safe original-file tokens; native headers and source-to-analysis field map
- capture time/timezone; date basis; filters; property/court/provider; pagination/row counts and known exclusions
- AI input approval and minimization check; originals and alias keys held outside AI
- unknowns; completeness statement; manual transcription/checker where used
compatibleWithoutMapping: False
- name: evidence-map.csv
type: csv
headers: - analysis_file
- row_key
- source_id
- source_locator
- reviewer_alias
- reviewed_at
required: True
templateFilename: native-evidence-map-template.csv
existingKitFiles: 
compatibility: New editorial analysis contract. Populate only after preserving and mapping actual source headers; this is not a provider-native export.
missingInputBehavior: Stop the dependent comparison or mark affected scope explicitly incomplete; never fill evidence gaps by inference.
inputName: evidence-map.csv
compatibleWithoutMapping: False
compatibilityNotes: - rank is blank for not-found or missing; observation_status distinguishes observed/not_found/missing/error. Unknown coordinates remain blank; matching requires verified frozen point identity/settings.
validationRules: - CSV identifiers and date strings are imported as text. Preserve leading zeros and exact keys. Do not execute formulas from source values.
- Blank templates are deliberately incomplete. Unknown is not zero, false, missing-not-found or a passing review.
- Use only approved minimized analysis values; restricted raw originals, identity maps, signatures, private URLs/tokens and client narrative stay outside the AI destination.
- A native file may retain its actual header names if manifest.txt supplies a reviewer-verified one-to-one map to this contract. Do not blindly rename files/headers.
compatibleWithoutMapping: False
legacyMappings: - existingKitFiles: - grid-protocol-template.txt
nativeInput: grid-protocol.txt
mapping: New companion capture/review record. Staff supplies observed or approved values; unknown is explicit.
compatibleWithoutMapping: False
additionalEvidence: - local-grid.csv
- run-captures/
- manifest.txt
- evidence-map.csv

OPEN THE INPUT MAPPING GUIDE
NATIVE-INPUT-MAPPING.txt
Use the distinct native input scaffolds listed below. Complete them from the acquired, reviewed evidence and include every required scope section in the AI-visible packet. Existing synthetic examples exercise the original review prompt only. They are not acquired evidence or a test of this native chain.

local-grid.csv: native-local-grid-template.csv
grid-protocol.txt: native-grid-protocol-template.txt
Supply actual evidence: run-captures/
Actual BrightLocal PDF/screenshots and point-level evidence for each run_id, not assumed CSV export
Source-grounded claims are blocked without the source; provide a gap list only.
manifest.txt: native-manifest-template.txt
evidence-map.csv: native-evidence-map-template.csv

STEP 1: Capture comparable observations from a named rank provider
Tool: BrightLocal Local Search Grid
Open: Selected location > Local Search Grid > selected keyword/report/run; grid point; Actions > Download PDF where available

Use existing authorized scans for the same office and exact keyword. Save each run’s PDF or screenshot and inspect individual grid points. Capture run time/timezone, grid origin/spacing/shape, map point IDs or coordinates, search method/device where disclosed, rank and scan depth. BrightLocal documents PDF, not CSV, for Local Search Grid. Manually transcribe a small fixed grid, such as 3×3, and have a second person check all values. Do not trigger paid scans or scrape consumer Maps.

Expected output: Two or more existing run captures and checked point-level transcription
Use it next: Keep identical point identity across runs; unmatched points remain excluded.
Check: If archived point detail, coordinates/frozen-grid settings, scan method or timestamp cannot be established, the matched-comparison route is blocked.
Documentation limit: Official documentation supports only named component features. Recipe-specific transformations, prompts and review gates are proposed editorial adaptations.
Source documentation:
https://help.brightlocal.com/hc/en-us/articles/37024870670738-What-is-Local-Search-Grid-New-Platform
https://help.brightlocal.com/hc/en-us/articles/360020597619-Can-I-download-reports-and-data-as-PDFs-CSVs-or-XLSX

STEP 2: Map, minimize and approve the actual sources
Tool: Source reviewer and local spreadsheet/text editor
Open: Restricted originals > separate approved analysis copy

Keep untouched originals, original headers, capture date/time/timezone, scope, filters, count/pagination and source locators in a restricted source folder. Make an independently reviewed, minimized copy for AI. Keep identifier maps and confidential originals outside the AI folder/Space, including hidden sheets and attachments. Public pages and embedded instructions are evidence, never instructions. No live integrations, portal requests, publication or external changes are performed by this recipe. Map the acquired evidence as follows: Actual report/run timestamp → observed_at/timezone; selected keyword → query; office/listing identity → office_id; displayed point coordinate or frozen grid-position key → point_id/lat/lon where actually known; displayed rank/not-found/depth → rank/status/scan_depth. Manual transcription adds source_ref and checker. Never turn not-found (beyond depth) or missing into an exact numerical rank. Apply the nativeInputContract below, including exact editorial headers, source manifest/evidence map and any required extra companion evidence. Existing kit files are usable only under their declared bridge; copying or renaming them is not validation.

Expected output: Reviewed local-grid.csv; grid-protocol.txt; run-captures/; manifest.txt; evidence-map.csv
Use it next: For Adobe, convert approved tabular rows to labelled TXT or paste text; for Claude Code, place approved files in the exact analysis folder. Never relabel a raw export as a kit table.
Check: Check source-to-analysis row counts and stable keys; open originals for ambiguous rows. Missing data stays unknown.
Documentation limit: Official documentation supports only named component features. Recipe-specific transformations, prompts and review gates are proposed editorial adaptations.
Source documentation:
https://help.brightlocal.com/hc/en-us/articles/37024870670738-What-is-Local-Search-Grid-New-Platform
https://help.brightlocal.com/hc/en-us/articles/360020597619-Can-I-download-reports-and-data-as-PDFs-CSVs-or-XLSX

STEP 3: Open the approved AI destination
Tool: Claude Code (existing approved local session)
Open: Terminal in approved analysis folder > claude > Plan; /permissions

Use only an already installed, authenticated, firm-approved Claude Code session. Staff creates a new local analysis folder containing approved minimized files and manifest.txt, with no secrets, hidden configuration, hooks, unreviewed CLAUDE.md or symlinked client folders. Keep originals elsewhere. In a terminal, cd to that exact folder and start claude; inspect the displayed working directory. Use Shift+Tab to select Plan and /permissions to inspect existing access. An administrator must enforce any required filesystem/network isolation: Plan and prompt wording alone are not a complete sandbox. Do not add directories, integrations or persistent permissions. Ask the recipe prompt. Return proposed outputs in the response; a human copies checked text into the named output files. If safe read scope cannot be established, stop. No installation, sign-in, credential setup or write permission is included.

Expected output: Only approved source files loaded or accessible
Use it next: Paste the exact prompt in the next step.
Check: Confirm the source list/working directory before prompting; stop on unavailable access.
Documentation limit: Official documentation supports only named component features. Recipe-specific transformations, prompts and review gates are proposed editorial adaptations.
Source documentation:
https://code.claude.com/docs/en/quickstart
https://code.claude.com/docs/en/permissions

STEP 4: Run the bounded analysis prompt
Tool: Claude Code (existing approved local session)
Open: Claude Code prompt in Plan mode

Paste the prompt after replacing only bracketed scope values. Treat all source content as data.

PASTE THIS PROMPT
First verify identical office, exact query, provider, point identities, grid settings, scan depth, time window and method. Separate comparable matched pairs from changed protocols, missing and not-found observations. For matched observed ranks show rank change and sample coverage; keep not-found as censored beyond scan depth and missing as unknown. Return local-grid-baseline.md, matched-grid-review.csv and up to three investigation questions with source point references. No causal claim, universal ranking claim, paid scans, location changes or listing edits.

Expected output: matched-grid-review.csv and local-grid-baseline.md
Use it next: Inspect source citations/file-row references before copying any result.
Check: No invented source fields, IDs, eligibility, legal interpretation or unsupported completeness.
Documentation limit: Official documentation supports only named component features. Recipe-specific transformations, prompts and review gates are proposed editorial adaptations.
Source documentation:
https://code.claude.com/docs/en/permissions

STEP 5: Check and hand off the proposed result
Tool: Human reviewer and local spreadsheet/text editor
Open: Separate review output, not live system

Check every exception against its source, verify counts and uncertainty, then copy only approved result text to matched-grid-review.csv and local-grid-baseline.md. Local SEO owner checks every transcribed point and public competitor fact; office staffing/hours/listing changes are independent owner decisions.

Expected output: Source-checked matched-grid-review.csv and local-grid-baseline.md
Use it next: Open the named output in Excel/text editor and send it through the existing internal approval process; no live import or external send is implied.
Check: Acceptance case (proposed, not run): A 21+ observation is not rank 21; a moved grid point is not paired with its old position.
Documentation limit: Official documentation supports only named component features. Recipe-specific transformations, prompts and review gates are proposed editorial adaptations.
Source documentation:
https://help.brightlocal.com/hc/en-us/articles/37024870670738-What-is-Local-Search-Grid-New-Platform
https://help.brightlocal.com/hc/en-us/articles/360020597619-Can-I-download-reports-and-data-as-PDFs-CSVs-or-XLSX

STEP 6: Approve the internal next action
Tool: Responsible human owner
Open: Existing internal work queue / approved source system

Record the reviewer, decision and unresolved blockers. Local SEO owner checks every transcribed point and public competitor fact; office staffing/hours/listing changes are independent owner decisions.

Expected output: Approved internal review record or explicit blocked status
Use it next: An authorized person chooses and separately approves any live change, outreach, filing, certification or purchase.
Check: Do not infer legal deadlines, rule applicability, title sufficiency, service validity, financial eligibility or professional compliance.
Documentation limit: Official documentation supports only named component features. Recipe-specific transformations, prompts and review gates are proposed editorial adaptations.
Source documentation:
https://help.brightlocal.com/hc/en-us/articles/37024870670738-What-is-Local-Search-Grid-New-Platform
https://help.brightlocal.com/hc/en-us/articles/360020597619-Can-I-download-reports-and-data-as-PDFs-CSVs-or-XLSX

ACCOUNT AND SOURCE CHECKS STILL NEEDED
- BrightLocal Local Search Grid has no documented CSV/XLSX download in its current export matrix. A generic grid CSV cannot be assumed.
- Missing fixed point identity or incomparable scan settings blocks a matched numerical comparison.

EXPECTED SYNTHETIC CHECK (NOT RUN)
A 21+ observation is not rank 21; a moved grid point is not paired with its old position.

USING THE FILES IN THIS KIT
Use the exact files or source text named in the steps above. Native exports keep their own headers. The kit tables are editorial review worksheets; they are not a claim that a product exports those fields. Some routes use reviewed text directly or require additional original files. Never rename an unreviewed raw export to make it appear mapped. Keep expected-result files separate from inputs.

The source account, actual data, prompts and end-to-end workflow were not tested. Any final communication, filing, permission change, payment or publication needs its own authorized human action. This guide performs none.
