LocalSEOData Tool

You have direct access to LocalSEOData via MCP. This is the default data source for LocalSEOSkills. Check here first before routing to other tools.

MCP Server: https://mcp.localseodata.com/mcp
Docs: https://localseodata.com/docs

When to Use LocalSEOData vs Other Tools

LocalSEOData covers most local SEO data needs in one place. Only use other tools when LocalSEOData genuinely can't do the job.

You Need	LocalSEOData	Use Instead
Local pack rankings	✅ local_pack	—
Full SERP with all features	✅ organic_serp	—
Google Maps results	✅ maps	—
Local Finder results	✅ local_finder	—
Geogrid ranking scan	✅ geogrid_scan	Local Falcon for trends, campaigns, Falcon Guard
Business profile data	✅ business_profile	—
Google reviews	✅ google_reviews	—
Multi-platform reviews	✅ multi_platform_reviews	—
Review velocity trends	✅ review_velocity	—
Citation audit (NAP consistency)	✅ citation_audit	—
Full local SEO audit	✅ local_audit	—
Reputation audit	✅ reputation_audit	—
Profile health check	✅ profile_health	—
On-page SEO audit	✅ page_audit	Screaming Frog for site-wide crawls
Competitor gap analysis	✅ competitor_gap	—
Keyword opportunities	✅ keyword_opportunities	—
Keyword suggestions	✅ keyword_suggestions	—
Search volume data	✅ search_volume	—
Keyword trends	✅ keyword_trends	—
Keywords a site ranks for	✅ keywords_for_site	—
Backlink summary	✅ backlink_summary	Ahrefs for deep link analysis
Backlink gap analysis	✅ backlink_gap	Ahrefs for detailed link profiles
AI Overview detection	✅ ai_overview	—
AI Mode response	✅ ai_mode	—
AI mentions across platforms	✅ ai_mentions	—
AI visibility scoring	✅ ai_visibility	—
AI top cited sources	✅ ai_top_sources	—
Local Services Ads data	✅ local_services_ads	LSA Spy for market-level tracking over time
Competitor ad intelligence	✅ competitor_ads	—
Brand mentions	✅ brand_mentions	—
Q&A from GBP	✅ qa	—
Local authority score	✅ local_authority	—
Ranking trends over time	❌	Local Falcon trend reports
GBP change monitoring	❌	Local Falcon (Falcon Guard)
Recurring scan campaigns	❌	Local Falcon campaigns
Deep backlink analysis (anchors, lost links)	❌	Ahrefs
Full site crawl (technical SEO)	❌	Screaming Frog
Actual traffic/conversion data	❌	Google Analytics
Real click/impression data	❌	Google Search Console
LSA market tracking over time	❌	LSA Spy

Location Resolution

Many endpoints require a location string. For best results:

• Use "City, State" format: "Buffalo, NY" or "Orchard Park, NY"
• If results seem off, use location_search first to resolve the exact DataForSEO location name
• location_search is free (0 credits)

---

Core Workflows

Full Local SEO Audit (One Call)

When: User says "audit this business," "check my local SEO," or "what's wrong with my rankings."

Use: local_audit

business_name: "Ace Plumbing"
location: "Buffalo, NY"

Returns local pack position, organic rankings, profile completeness, review velocity, and competitors in a single call. 5 credits.

This replaces manually combining data from 3-4 different tools.

Geogrid Ranking Scan

When: User wants to see how a business ranks across a geographic area.

Use: geogrid_scan

business: "Ace Plumbing"
keyword: "plumber near me"
location: "Buffalo, NY"
grid_size: "7x7"    # 5x5 (default), 7x7, or 9x9
radius_miles: 3     # default 3

This is an async operation — the tool polls until results are ready. Returns a rank grid, average rank, and coverage stats.

Credit costs: 5x5 = 5 credits, 7x7 = 10 credits, 9x9 = 18 credits.

For interpretation: Load the geogrid-analysis strategy skill.

Limitations vs Local Falcon:

• No trend reports (can't compare scans over time)
• No campaigns (no recurring automated scans)
• No Falcon Guard (no GBP change monitoring)
• No AI platform scans (GAIO, ChatGPT, Gemini — use ai_visibility endpoints instead)

Use LocalSEOData geogrid for one-time scans and audits. Use Local Falcon for ongoing monitoring.

Business Profile Pull

When: Need GBP data for audit, optimization, or reporting.

Use: business_profile

business_name: "Ace Plumbing"
location: "Buffalo, NY"

Returns: name, rating, reviews, address, phone, website, hours, categories, attributes, photos count, description, verification status. 2 credits.

Review Intelligence

When: User wants review data, sentiment analysis, or velocity tracking.

Multiple endpoints depending on need:

Need	Endpoint	Credits
Read recent reviews	google_reviews	1 per 10 reviews
Reviews across platforms	multi_platform_reviews	6
Review velocity over time	review_velocity	6
Full reputation audit	reputation_audit	30

review_velocity is the most useful for ongoing clients — shows reviews/month, rating trend, reply rate, sentiment themes.

reputation_audit is the heavy hitter — reputation score, sentiment analysis, response rate, and recommendations. Use for new client onboarding or quarterly reviews.

Citation Audit

When: User wants to check NAP consistency across directories.

Use: citation_audit

business_name: "Ace Plumbing"
address: "123 Main St, Buffalo, NY 14201"
phone: "(716) 555-1234"

Checks 20 major directories (Yelp, BBB, Facebook, YellowPages, etc.). Returns consistency score and per-directory details. 5 credits.

Note: Requires all three fields (name, address, phone) for NAP comparison.

Keyword Research

When: User needs keyword ideas, search volumes, or competitive keyword data.

Need	Endpoint	Credits
Keyword ideas for a business	keyword_opportunities	4
Suggestions from a seed keyword	keyword_suggestions	2
Search volume for specific keywords	search_volume	1
Related keywords	related_keywords	2
Keywords a domain ranks for	keywords_for_site	3
Keyword trends over time	keyword_trends	1

Start with keyword_opportunities — it finds keywords based on the business category and location, shows difficulty, current rank, and volume. Best starting point for strategy.

Use keyword_suggestions when the user has a specific seed keyword and wants variations.

Competitor Analysis

When: User wants to understand competitive landscape.

Use: competitor_gap

business_name: "Ace Plumbing"
location: "Buffalo, NY"
keyword: "plumber"
competitors: 5

Returns ranking gaps, review count differences, and rating advantages vs competitors. 10 credits.

For ad intelligence: competitor_ads shows Google Ads campaigns from a competitor domain. 2 credits.

For backlink gaps: backlink_gap compares your domain against up to 5 competitors for link opportunities. 5 credits.

AI Visibility

When: User asks about AI search visibility, AI Overviews, ChatGPT mentions, or GEO.

Need	Endpoint	Credits
Does Google show an AI Overview?	ai_overview	1
What does Google AI Mode say?	ai_mode	2
Where does AI mention this keyword?	ai_mentions	3
Which sites do AI models cite?	ai_top_sources	3
How visible is a domain across AI?	ai_visibility	5

Start with ai_overview to check if AIO exists for the keyword, then use ai_visibility for domain-level scoring across multiple keywords.

SERP Data

When: User wants to see what Google shows for a search.

Need	Endpoint	Credits
Full SERP (organic + local + ads + PAA + AIO)	organic_serp	1
Local pack only	local_pack	1
Google Maps results	maps	1
Local Finder results	local_finder	1
Local Services Ads	local_services_ads	1

organic_serp is the most complete — returns everything on the page in one call.

On-Page Audit

When: User wants to check a specific URL for SEO issues.

Use: page_audit

url: "https://aceplumbing.com/services/drain-cleaning"

Checks 50+ factors: title, meta, headings, images, Core Web Vitals, schema, mobile-friendliness. 2 credits.

For site-wide crawls across many pages, use Screaming Frog instead.

Local Authority Score

When: User wants a single score representing local search authority.

Use: local_authority

business_name: "Ace Plumbing"
location: "Buffalo, NY"
keyword: "plumber"

Returns 0-100 score with component breakdown (rankings, reviews, profile completeness, citations) and percentile ranking. 10 credits.

Great for client reporting and tracking improvement over time.

---

Credit Cost Reference

Endpoint	Credits
ping	0
location_search	0
local_pack	1
organic_serp	1
local_services_ads	1
local_finder	1
maps	1
ai_overview	1
search_volume	1
keyword_trends	1
google_reviews	1 per 10 reviews
business_profile	2
profile_health	2
page_audit	2
ai_mode	2
keyword_suggestions	2
related_keywords	2
backlink_summary	2
competitor_ads	2
ai_mentions	3
ai_top_sources	3
keywords_for_site	3
brand_mentions	3
keyword_opportunities	4
local_audit	5
citation_audit	5
ai_visibility	5
backlink_gap	5
geogrid_scan (5x5)	5
multi_platform_reviews	6
review_velocity	6
business_listings	10 per 50 results
competitor_gap	10
local_authority	10
geogrid_scan (7x7)	10
geogrid_scan (9x9)	18
reputation_audit	30

---

Combining Endpoints for Common Workflows

New Client Onboarding

1. local_audit — overall picture (5 credits)
2. business_profile — GBP details (2 credits)
3. citation_audit — NAP consistency (5 credits)
4. review_velocity — review health (6 credits)
5. keyword_opportunities — keyword strategy (4 credits)
6. competitor_gap — competitive landscape (10 credits)
   Total: 32 credits for a complete new client assessment.

Monthly Report Data Pull

1. local_pack for target keywords — ranking check (1 credit each)
2. review_velocity — monthly review trends (6 credits)
3. local_authority — authority score tracking (10 credits)
4. ai_overview for target keywords — AI visibility check (1 credit each)

Quick Rank Check

1. local_pack — who's in the 3-pack (1 credit)
   Done.

Prospecting / Sales Research

1. business_profile — pull their GBP data (2 credits)
2. profile_health — find gaps to pitch on (2 credits)
3. google_reviews — review situation (1 credit)
   Total: 5 credits to build a pitch.