SEO Intelligence MCP Server

Unified MCP Server for comprehensive SEO intelligence - Orchestrates DataForSEO, LocalFalcon, and SERPApi actors for AI assistant integration.

Built by John Rippy | johnrippy.link

---

Overview

This MCP (Model Context Protocol) Server provides a unified interface for AI assistants to access comprehensive SEO intelligence capabilities. It orchestrates multiple specialized Apify actors:

• DataForSEO: SERP rankings, keyword research, on-page audits, backlink analysis
• LocalFalcon: Local ranking grid scans
• SERPApi: Real-time SERP snapshots

Available Tools

Tool	Description	Data Source
serp_rankings	Track keyword positions in search results	DataForSEO
keyword_research	Find keyword opportunities with volume/difficulty	DataForSEO
onpage_audit	Comprehensive on-page SEO analysis	DataForSEO
backlink_analysis	Analyze backlink profile and referring domains	DataForSEO
local_grid_scan	Run local ranking grid scans	LocalFalcon
realtime_serp	Get real-time SERP snapshots	SERPApi
competitor_analysis	Multi-source competitor analysis	Combined
full_audit	Complete SEO audit across all categories	Combined

Input Parameters

Required for Production

• apifyToken - Your Apify API token (for running sub-actors)
• API credentials for the specific tool:
  • DataForSEO: dataForSeoLogin, dataForSeoPassword
  • LocalFalcon: localFalconApiKey
  • SERPApi: serpApiKey

Common Parameters

Parameter	Type	Description
tool	string	The SEO intelligence tool to execute
domain	string	Target domain for analysis
keywords	array	Keywords to track or research
location	string	Geographic location (e.g., "Saint Louis, MO")
competitors	array	Competitor domains to compare
webhookUrl	string	URL to receive results when complete
demoMode	boolean	Run with sample data (no API calls)

Example Usage

SERP Rankings Tracking

{
  "tool": "serp_rankings",
  "domain": "example.com",
  "keywords": ["digital marketing", "seo services", "local seo"],
  "location": "Saint Louis, MO",
  "dataForSeoLogin": "your-login",
  "dataForSeoPassword": "your-password",
  "apifyToken": "your-apify-token"
}

Local Grid Scan

{
  "tool": "local_grid_scan",
  "toolInput": {
    "businessName": "Joe's Plumbing",
    "keyword": "plumber near me",
    "gridSize": 9,
    "radiusMiles": 10
  },
  "location": "Saint Louis, MO",
  "localFalconApiKey": "your-localfalcon-key",
  "apifyToken": "your-apify-token"
}

Real-Time SERP Snapshot

{
  "tool": "realtime_serp",
  "toolInput": {
    "query": "best marketing agency",
    "engine": "google",
    "device": "mobile"
  },
  "location": "New York, NY",
  "serpApiKey": "your-serpapi-key",
  "apifyToken": "your-apify-token"
}

Full SEO Audit

{
  "tool": "full_audit",
  "domain": "example.com",
  "location": "Chicago, IL",
  "dataForSeoLogin": "your-login",
  "dataForSeoPassword": "your-password",
  "localFalconApiKey": "your-localfalcon-key",
  "apifyToken": "your-apify-token"
}

Output Format

All tools return a standardized result format:

{
  "tool": "serp_rankings",
  "status": "success",
  "timestamp": "2025-12-27T12:00:00.000Z",
  "summary": "Tracked 5 keywords for example.com - Avg position: 4.2",
  "data": {
    // Tool-specific data
  }
}

MCP Integration

This actor exposes MCP tools via the Key-Value Store:

// Fetch MCP tools definition
const kvStore = await client.keyValueStore(runId);
const mcpTools = await kvStore.getRecord('MCP_TOOLS');

// Get the latest result
const output = await kvStore.getRecord('OUTPUT');

Pricing

Pay-per-event pricing based on tool usage:

Event	Description
mcp-tool-call	Base charge per tool execution
serp_rankings	SERP ranking check
keyword_research	Keyword research query
onpage_audit	On-page audit scan
backlink_analysis	Backlink analysis
local_grid_scan	Local grid scan
realtime_serp	Real-time SERP snapshot
competitor-analysis	Multi-source competitor analysis
full-audit	Complete SEO audit

Demo Mode

Set demoMode: true to test with sample data without consuming API credits or running sub-actors.

Webhook Support

Configure webhookUrl to receive results via HTTP POST when the run completes. Perfect for Zapier, Make, or n8n integrations.

Related Actors

This MCP Server orchestrates these specialized actors:

• localhowl~dataforseo-serp - SERP and keyword data
• localhowl~dataforseo-onpage - On-page SEO audits
• localhowl~dataforseo-backlinks - Backlink analysis
• localhowl~localfalcon-grid - Local ranking grids
• localhowl~serpapi-realtime - Real-time SERP snapshots

Support

• GitHub: Report issues
• LinkedIn: John Rippy
• Website: johnrippy.link