Agent skill

Local Falcon Tool

by garrettjsmith in garrettjsmith/localseoskills

When the user wants to run a geogrid scan, check existing scan reports, track ranking trends over time, monitor GBP changes via Falcon Guard, or analyze reviews.

MITAuto-check passedMarketing & SEO

Install Local Falcon Tool

skills CLI
$ npx skills add garrettjsmith/localseoskills --skill local-falcon-tool -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install garrettjsmith/localseoskills local-falcon-tool --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/garrettjsmith/localseoskills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/local-falcon-tool .claude/skills/local-falcon-tool && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
local-falcon-tool
GitHub stars
120
Token cost
~1.8k tokens
SKILL.md length
741 words
Files
1
Skills in repo
38
Repo updated
First seen
Licence
MIT

At a glance

When the user wants to run a geogrid scan, check existing scan reports, track ranking trends over time, monitor GBP changes via Falcon Guard, or analyze reviews.

  • Works in 6 steps: Find the business:… → Confirm scan parameters with user → Run: runLocalFalconScan — returns… → …
  • Wants to run a geogrid scan
  • SKILL.md covers When to Use Local Falcon vs…, Before Running Any Scan, Core Workflows and Grid Size Selection, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Local Falcon Tool is an agent skill from garrettjsmith/localseoskills. When the user wants to run a geogrid scan, check existing scan reports, track ranking trends over time, monitor GBP changes via Falcon Guard, or analyze reviews. Also use when the user says "run a scan," "check my rankings," "Local Falcon," "how am I ranking," "ranking heatmap," or "scan this keyword." This is the execution tool — for interpreting results, also load geogrid-analysis.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering Local SEO. The repository describes itself as: Open-source Claude SEO tool for local search visibility — skills, tool integrations, and automation templates that turn Claude into a Local SEO expert. The licence is MIT.

When your agent uses it

  • Wants to run a geogrid scan
  • Check existing scan reports
  • Track ranking trends over time
  • Monitor GBP changes via Falcon Guard

Example prompts

  • “run a scan,”
  • “check my rankings,”
  • “Local Falcon,”
  • “/local-falcon-tool”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Find the business: listAllLocalFalconLocations — search by name or address
  2. Confirm scan parameters with user
  3. Run: runLocalFalconScan — returns immediately with "submitted"
  4. Poll: listLocalFalconScanReports (filter by placeId) — check every 30 seconds
  5. Retrieve: getLocalFalconReport with fieldmask for analysis
  6. Interpret: Use geogrid-analysis skill to diagnose results

What it can do on your machine

Read from SKILL.md and the folder at commit 405ce20. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Local Falcon Tool loads about 1.8k tokens when it runs. Until then it costs about 101 tokens; SKILL.md has 741 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~101
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from garrettjsmith/localseoskills at commit 405ce20, republished under its MIT licence (© garrettjsmith). 741 words, ~1,826 tokens.

Download SKILL.mdSave it as .claude/skills/local-falcon-tool/SKILL.md (or your agent's skills folder).
name
local-falcon-tool
description
When the user wants to run a geogrid scan, check existing scan reports, track ranking trends over time, monitor GBP changes via Falcon Guard, or analyze reviews. Also use when the user says "run a scan," "check my rankings," "Local Falcon," "how am I ranking," "ranking heatmap," or "scan this keyword." This is the execution tool — for interpreting results, also load geogrid-analysis.
metadata.version
1.0.0
metadata.author
Garrett Smith

Local Falcon Tool

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

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.

When to Use Local Falcon vs Other Tools

You NeedUse Local FalconUse Instead
Rankings across a geographic area✅ Geogrid scans—
Rankings at one specific point✅ Can do it but overkillSerpAPI 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

Before Running Any Scan

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

Core Workflows

Run a New Ranking Scan

When: User wants to know how a business ranks for a keyword across a geographic area.

  1. Find the business: listAllLocalFalconLocations — search by name or address
    • If not found: searchForLocalFalconBusinessLocation → saveLocalFalconBusinessLocationToAccount
  2. Confirm scan parameters with user:
    • Keyword (what customers search)
    • Grid size (see grid table below)
    • Radius (see radius table below)
    • Platform: google, apple, gaio, chatgpt, gemini, grok, aimode
    • AI analysis: yes/no (Google only, recommended)
  3. Run: runLocalFalconScan — returns immediately with "submitted"
  4. Poll: listLocalFalconScanReports (filter by placeId) — check every 30 seconds
  5. Retrieve: getLocalFalconReport with fieldmask for analysis
  6. Interpret: Use geogrid-analysis skill to diagnose results

Recommended 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

Check Existing Reports

When: User asks about current/recent rankings, or you need baseline data.

  1. listLocalFalconScanReports with filters (placeId, keyword, date range)
  2. Use fieldmask: report_key,date,keyword,location.name,arp,atrp,solv,grid_size,platform
  3. If multiple reports exist for same keyword: getLocalFalconTrendReport for the trend view

When: User wants to see if rankings are improving or declining.

  1. listLocalFalconTrendReports (filter by placeId and keyword)
  2. getLocalFalconTrendReport — returns historical ARP, ATRP, SoLV per scan date
  3. Compare metrics across dates and correlate with optimization actions

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

Run a Campaign (Recurring Scans)

When: User wants automated regular scanning.

  1. listLocalFalconCampaignReports — check existing campaigns first
  2. createLocalFalconCampaign — set up keyword(s), location(s), frequency, grid size
  3. Campaign runs automatically on schedule
  4. getLocalFalconCampaignReport — retrieve aggregated results

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

Show full SKILL.md (297 more words)Show less
Competitive Analysis

When: User wants to know who's beating them.

  1. Every scan auto-generates a competitor report
  2. getLocalFalconCompetitorReports — list available reports
  3. getLocalFalconCompetitorReport — top competitors with ARP, ATRP, SoLV, reviews, ratings
  4. Use fieldmask: date,keyword,grid_size,radius,businesses.*.name,businesses.*.place_id,businesses.*.arp,businesses.*.atrp,businesses.*.solv,businesses.*.reviews,businesses.*.rating
Monitor GBP for Changes (Falcon Guard)

When: User wants to protect their GBP from unauthorized edits.

  1. listLocalFalconGuardReports — see what's currently monitored
  2. addLocationsToFalconGuard — add locations to monitoring
  3. getLocalFalconGuardReport — view change history and metrics (calls, clicks, directions for OAuth-connected locations)
Review Analysis

When: User wants AI-powered review insights.

  1. listLocalFalconReviewsAnalysisReports — check existing analyses
  2. getLocalFalconReviewsAnalysisReport — full sentiment analysis, topics, competitor comparison

Grid Size Selection

Business TypeGrid SizeRadiusRationale
Coffee shop, salon, restaurant5×5 or 7×71-3 miCustomers walk/drive short distances
Dentist, chiropractor, single-location medical7×7 or 9×93-7 miCity-wide draw
HVAC, plumber, electrician9×9 or 11×117-15 miWide service area
Hospital system, franchise chain13×13 or 15×1510-20 miRegional coverage
Rural business7×7 or 9×915-30 miLarge but sparse area

Rule of thumb: Grid size should cover the realistic service area. Too small = misleading good results. Too big = misleading bad results.

Credit Awareness

  • Always check credits before running scans: viewLocalFalconAccountInformation
  • Larger grids cost more credits
  • Campaigns multiply: locations × keywords × frequency
  • AI analysis adds cost per scan
  • Never re-run a scan without checking if results already exist

What to Do Next

What You GotNext ActionSkill
Scan results with ARP/ATRP/SoLVInterpret the data and diagnose issuesgeogrid-analysis
Competitor report dataAnalyze what competitors do differentlylocal-competitor-analysis
Trend showing declineDiagnose cause using decision treesgeogrid-analysis diagnostic trees
GBP changes detected via GuardReview and revert unauthorized editsgbp-optimization
Review analysis resultsBuild review strategy from insightsreview-management

Default next step: Never return raw scan numbers to the user. Always interpret through geogrid-analysis first.

© garrettjsmith, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/local-falcon-tool of garrettjsmith/localseoskills.

Open the folder on GitHubat commit 405ce20

Compare with similar skills

Local Falcon Tool next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Local Falcon Tool compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Local Falcon Tool this skillgarrettjsmith/localseoskills120—~1.8kAutomated safety check: PassMIT
FLOW SEO FrameworkAgriciDaniel/claude-seo19k2 repos~1.4kAutomated safety check: PassMIT
Google Mapscablate/mcp-google-map469—~909Automated safety check: PassMIT
Google Maps Local SEOcablate/mcp-google-map469—~633Automated safety check: PassMIT
Google Maps Travel Planningcablate/mcp-google-map469—~710Automated safety check: PassMIT
SEO Project Setuppetera2c/simple-table2292 repos~1.5kAutomated safety check: PassMIT

Similar skills

  • FLOW SEO Framework

    AgriciDaniel/claude-seo

    Brings the FLOW framework's stage-specific SEO prompts into the agent, from keyword discovery through backlinks, on-page work and conversion to local SEO, loaded on demand.

    19k GitHub starsUsed in 2 repos~1.4k tokens
    Marketing & SEOAuto-check passed
  • Google Maps

    cablate/mcp-google-map

    Search places, resolve addresses, compare routes, inspect neighborhoods, and retrieve geographic or environmental facts through the standalone @cablate/mcp-google-map CLI.

    469 GitHub stars~909 tokensUpdated 12 days ago
    Marketing & SEOAuto-check passed
  • Google Maps Local SEO

    cablate/mcp-google-map

    Analyze Google Business Profile visibility, geographic grid rankings, local search keywords, and nearby competitors through the standalone Google Maps CLI.

    469 GitHub stars~633 tokensUpdated 12 days ago
    Marketing & SEOAuto-check passed
  • Google Maps Travel Planning

    cablate/mcp-google-map

    Build evidence-backed day trips, multi-day itineraries, and efficient stop sequences with Google Maps data through the standalone CLI.

    469 GitHub stars~710 tokensUpdated 12 days ago
    Marketing & SEOAuto-check passed
  • SEO Project Setup

    petera2c/simple-table

    Set up a durable local SEO workspace with project context, notes, goals, positioning, preferences, MCP checks, and Search Console data intake.

    229 GitHub starsUsed in 2 repos~1.5k tokens
    Marketing & SEOAuto-check passed
  • Universal SEO Analysis

    AgriciDaniel/claude-seo

    Hub for site-wide SEO work: audits, technical checks, schema, content quality, local, hreflang and AI-search readiness, run through slash commands.

    19k GitHub stars~4.9k tokensUpdated 4 days ago
    Marketing & SEOAuto-check passed

More from garrettjsmith/localseoskills

All 38 skills in this repo
  • Gbp API Automation

    garrettjsmith/localseoskills

    When the user wants to programmatically manage Google Business Profiles at scale via API, automate GBP updates, build GBP management tools, or integrate GBP data into their systems.

    120 GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Gbp Posts

    garrettjsmith/localseoskills

    When the user wants to create, schedule, or optimize Google Business Profile posts.

    120 GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Local Content Briefs

    garrettjsmith/localseoskills

    Generate complete semantic content briefs for local SEO content — location pages, service pages, blog posts, FAQ content, and pillar pages.

    120 GitHub stars~3.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Brief

    garrettjsmith/localseoskills

    Manages persistent work state (briefs) for local SEO engagements.

    120 GitHub stars~1.9k tokensUpdated 1 mo ago
    Auto-check: warnings
  • Local Content Strategy

    garrettjsmith/localseoskills

    Build a complete local content strategy from keyword research output.

    120 GitHub stars~2.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Local Keyword Research

    garrettjsmith/localseoskills

    When the user wants to research keywords for a local business, find local search opportunities, build a keyword map for location pages, or understand local search intent.

    120 GitHub stars~4.7k tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about Local Falcon Tool

What does Local Falcon Tool do?

When the user wants to run a geogrid scan, check existing scan reports, track ranking trends over time, monitor GBP changes via Falcon Guard, or analyze reviews. Local Falcon Tool is an agent skill from garrettjsmith/localseoskills. When the user wants to run a geogrid scan, check existing scan reports, track ranking trends over time, monitor GBP changes via Falcon Guard, or analyze reviews.

When should I use Local Falcon Tool?

Local Falcon Tool fits situations like: wants to run a geogrid scan; check existing scan reports; track ranking trends over time; monitor GBP changes via Falcon Guard.

How do I install Local Falcon Tool in Claude Code?

Run `npx skills add garrettjsmith/localseoskills --skill local-falcon-tool -a claude-code`. Or copy the skill folder (skills/local-falcon-tool in garrettjsmith/localseoskills) into .claude/skills/local-falcon-tool in your project. Claude Code loads it when a task matches its description.

How do I install Local Falcon Tool in Codex?

Run `npx skills add garrettjsmith/localseoskills --skill local-falcon-tool -a codex`. Or copy the skill folder (skills/local-falcon-tool in garrettjsmith/localseoskills) into .agents/skills/local-falcon-tool in your project. Codex loads it when a task matches its description.

Can I use Local Falcon Tool in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add garrettjsmith/localseoskills --skill local-falcon-tool -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/local-falcon-tool, .gemini/skills/local-falcon-tool, .github/skills/local-falcon-tool and .opencode/skills/local-falcon-tool in your project.

What does Local Falcon Tool need to run?

SKILL.md names no scripts, command-line tools or credentials: Local Falcon Tool is instructions for the agent only.

Does Local Falcon Tool access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Local Falcon Tool safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Local Falcon Tool use?

Local Falcon Tool is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Local Falcon Tool use?

About 1.8k tokens (SKILL.md is roughly 7.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Local Falcon Tool?

Skills that share tags, products or a category with Local Falcon Tool: FLOW SEO Framework (AgriciDaniel/claude-seo, 19k stars), Google Maps (cablate/mcp-google-map, 469 stars), Google Maps Local SEO (cablate/mcp-google-map, 469 stars) and Google Maps Travel Planning (cablate/mcp-google-map, 469 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Local Falcon Tool?

garrettjsmith (a GitHub user) maintains it in garrettjsmith/localseoskills, which has 120 GitHub stars. The repository holds 38 skills in this directory. The repository was last updated on August 15, 2026.

Source: garrettjsmith/localseoskills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.