Local Falcon Tool

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

Before Running Any Scan

Always check existing reports first. Scans cost credits. Don't duplicate work.

Copy code
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

Track Ranking Trends

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.

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

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

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