aios-local-seo

Reports map-pack rankings and audits Google Business Profile completeness and NAP consistency.

1|Updated Jul 8, 2026
One-click install
npx skills add https://github.com/codesofadan/danyals-aios --skill aios-local-seo-codesofadan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: aios-local-seo
Source: https://github.com/codesofadan/danyals-aios/tree/main/.claude/skills/aios-local-seo
Command: npx skills add https://github.com/codesofadan/danyals-aios --skill aios-local-seo-codesofadan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Local SEO operators need to know whether a client appears in the Google map pack, whether their Google Business Profile is complete, and whether their name, address, and phone data is consistent across directories — without manually checking each source. ## Core Features & Use Cases - Map-Pack Rank Reporting: Reads measured map-pack rankings per keyword and geo, including rank history, competitor data, and in-pack status (null rank means not in the pack). - GBP Completeness Audit: Recomputes a fresh audit of the Google Business Profile, returning per-field verdicts (ok, missing, thin) and a completeness score. - NAP Alignment Report: Checks name/address/phone consistency across directories, distinguishing real inconsistencies from cosmetic formatting differences. - Use Case: An operator asks "do we show in the 3-pack for 'plumber austin'?" — the Skill resolves the client, reads rankings and the GBP audit, and renders a pinned report; on request it can add a keyword or kick a refresh sweep (which spends metered budget). ## Quick Start Ask the assistant to report the map-pack rankings and GBP audit for a given client and location, for example: "Check whether Client X shows in the map pack for Austin and audit their Google Business Profile."

Frequently Asked Questions about aios-local-seo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if a business shows in the Google map pack?▼

Resolve the client, then read the local-seo rankings endpoint filtered by client. Each row's rank field shows the measured map-pack position for a keyword and geo; a null rank means the business was checked and is not in the pack.

How do I audit Google Business Profile completeness?▼

Call the profile audit endpoint, which recomputes the audit fresh rather than reading a stored score. It returns a completeness value plus per-field findings with verdicts of ok, missing, or thin, and lists every field that is not ok.

What does a null rank mean in map-pack tracking?▼

A null rank means the check succeeded and the business is not in the map pack for that keyword and geo. It is never a failed check and never position zero; a failed check writes no row at all.

Why does Google Business Profile sync return held with no_oauth_client?▼

The hold is the designed steady state, not an error. GBP sync is approval-gated behind the Google API and no GBP reader is wired, so the worker always holds; report it as pending the approval-gated Google API and do not retry.

Can I run a geo-grid or radius scan for local rankings?▼

No. The provider accepts a single scalar geo, so there is structurally nowhere to put grid points, and geo-grids, radius sweeps, and heatmaps are out of contract scope. Simulating one with invented coordinates would fabricate data.

Does refreshing one keyword update only that ranking?▼

No. The refresh endpoint kicks the entire due sweep, not just the selected row; the ranking_id only selects the 404 check and the echoed id. It also spends metered budget, so refresh only when the operator asks.