From local-seo-skills
Executes Local Falcon geogrid scans for local SEO rankings across areas, checks reports, tracks trends over time, monitors GBP changes via Falcon Guard, analyzes reviews.
npx claudepluginhub garrettjsmith/localseoskillsThis skill uses the workspace's default tool permissions.
> **Note:** LocalSEOData (`localseodata-tool`) now has a `geogrid_scan` endpoint for one-time ranking scans. Use LocalSEOData for quick audits and one-off scans. Local Falcon remains essential for trend reports, recurring campaigns, Falcon Guard monitoring, and AI platform scans (GAIO/ChatGPT/Gemini/Grok).
Creates isolated Git worktrees for feature branches with prioritized directory selection, gitignore safety checks, auto project setup for Node/Python/Rust/Go, and baseline verification.
Executes implementation plans in current session by dispatching fresh subagents per independent task, with two-stage reviews: spec compliance then code quality.
Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.
Note: LocalSEOData (
localseodata-tool) now has ageogrid_scanendpoint for one-time ranking scans. Use LocalSEOData for quick audits and one-off scans. Local Falcon remains essential for trend reports, recurring campaigns, Falcon Guard monitoring, and AI platform scans (GAIO/ChatGPT/Gemini/Grok).
You have direct access to Local Falcon via MCP. This skill tells you WHEN to use each operation and WHAT to do with the results.
| You Need | Use Local Falcon | Use Instead |
|---|---|---|
| Rankings across a geographic area | ✅ Geogrid scans | — |
| Rankings at one specific point | ✅ Can do it but overkill | SerpAPI for quick spot-check |
| Competitor rankings in an area | ✅ Competitor reports auto-generated | — |
| Ranking trends over time | ✅ Trend reports | — |
| GBP monitoring for changes | ✅ Falcon Guard | — |
| Review analysis with sentiment | ✅ Reviews Analysis | — |
| Keyword search volume | ❌ | Semrush, Ahrefs, DataForSEO |
| Backlink data | ❌ | Ahrefs, Semrush |
| Website traffic data | ❌ | Google Analytics |
| Technical site audit | ❌ | Screaming Frog |
Always check existing reports first. Scans cost credits. Don't duplicate work.
Step 1: listAllLocalFalconLocations → Find the place ID
Step 2: listLocalFalconScanReports (filter by placeId + keyword) → Check if a recent scan exists
Step 3: Only run a NEW scan if no recent report exists or the user explicitly wants fresh data
When: User wants to know how a business ranks for a keyword across a geographic area.
listAllLocalFalconLocations — search by name or address
searchForLocalFalconBusinessLocation → saveLocalFalconBusinessLocationToAccountrunLocalFalconScan — returns immediately with "submitted"listLocalFalconScanReports (filter by placeId) — check every 30 secondsgetLocalFalconReport with fieldmask for analysisgeogrid-analysis skill to diagnose resultsRecommended fieldmask for analysis:
report_key,date,place_id,keyword,location,arp,atrp,solv,found_in,total_competitors,grid_size,radius,measurement,ai_analysis,image,heatmap
When: User asks about current/recent rankings, or you need baseline data.
listLocalFalconScanReports with filters (placeId, keyword, date range)report_key,date,keyword,location.name,arp,atrp,solv,grid_size,platformgetLocalFalconTrendReport for the trend viewWhen: User wants to see if rankings are improving or declining.
listLocalFalconTrendReports (filter by placeId and keyword)getLocalFalconTrendReport — returns historical ARP, ATRP, SoLV per scan dateKey insight: Trend reports only exist when 2+ scans have identical settings (same placeId, keyword, grid size, radius, coordinates). If settings differ between scans, no trend report is generated.
When: User wants automated regular scanning.
listLocalFalconCampaignReports — check existing campaigns firstcreateLocalFalconCampaign — set up keyword(s), location(s), frequency, grid sizegetLocalFalconCampaignReport — retrieve aggregated resultsCampaign vs individual scans: Campaigns consolidate data in one report. Individual scans generate separate trend/location/keyword reports. Use campaigns for ongoing monitoring, individual scans for one-off analysis.
When: User wants to know who's beating them.
getLocalFalconCompetitorReports — list available reportsgetLocalFalconCompetitorReport — top competitors with ARP, ATRP, SoLV, reviews, ratingsdate,keyword,grid_size,radius,businesses.*.name,businesses.*.place_id,businesses.*.arp,businesses.*.atrp,businesses.*.solv,businesses.*.reviews,businesses.*.ratingWhen: User wants to protect their GBP from unauthorized edits.
listLocalFalconGuardReports — see what's currently monitoredaddLocationsToFalconGuard — add locations to monitoringgetLocalFalconGuardReport — view change history and metrics (calls, clicks, directions for OAuth-connected locations)When: User wants AI-powered review insights.
listLocalFalconReviewsAnalysisReports — check existing analysesgetLocalFalconReviewsAnalysisReport — full sentiment analysis, topics, competitor comparison| Business Type | Grid Size | Radius | Rationale |
|---|---|---|---|
| Coffee shop, salon, restaurant | 5×5 or 7×7 | 1-3 mi | Customers walk/drive short distances |
| Dentist, chiropractor, single-location medical | 7×7 or 9×9 | 3-7 mi | City-wide draw |
| HVAC, plumber, electrician | 9×9 or 11×11 | 7-15 mi | Wide service area |
| Hospital system, franchise chain | 13×13 or 15×15 | 10-20 mi | Regional coverage |
| Rural business | 7×7 or 9×9 | 15-30 mi | Large but sparse area |
Rule of thumb: Grid size should cover the realistic service area. Too small = misleading good results. Too big = misleading bad results.
viewLocalFalconAccountInformation| What You Got | Next Action | Skill |
|---|---|---|
| Scan results with ARP/ATRP/SoLV | Interpret the data and diagnose issues | geogrid-analysis |
| Competitor report data | Analyze what competitors do differently | local-competitor-analysis |
| Trend showing decline | Diagnose cause using decision trees | geogrid-analysis diagnostic trees |
| GBP changes detected via Guard | Review and revert unauthorized edits | gbp-optimization |
| Review analysis results | Build review strategy from insights | review-management |
Default next step: Never return raw scan numbers to the user. Always interpret through geogrid-analysis first.