dataforseo

Query live SERP data from Google, Bing, and YouTube via DataForSEO. See exactly what search results look like right now — organic results, featured snippets, knowledge graphs, AI overviews, local pack

SKILL.md

GitHub

DataForSEO SERP Analysis Skill

Query live search engine results pages via MCP tools. See real-time rankings, SERP features, and competitive positions across Google, Bing, and YouTube.

Quick Start

# Full Google SERP (all elements)
mcp__dataforseo-serp__google_serp_live(keyword="your keyword", location_code=2840)

# Quick organic-only results (cheaper)
mcp__dataforseo-serp__google_serp_regular(keyword="your keyword", location_code=2840)

# Find location codes
mcp__dataforseo-serp__google_locations(query="London")

# YouTube rankings
mcp__dataforseo-serp__youtube_serp_live(keyword="your keyword")

# Bing comparison
mcp__dataforseo-serp__bing_serp_live(keyword="your keyword", location_code=2840)

Tool Reference

google_serp_live — Full SERP

All SERP elements: organic, paid, featured snippets, knowledge graph, AI overview, local pack, people also ask, images, videos.

Param Type Required Default Description
keyword string Yes — Search query
location_code number No — Location code (use google_locations to find)
location_name string No — Alt: location name (e.g. "United States")
language_code string No "en" Language code
device string No "desktop" "desktop" or "mobile"
depth number No 10 Results count (10-100)

google_serp_regular — Quick Organic

Organic + paid results only. ~60% cheaper than advanced.

Same parameters as google_serp_live.

google_locations — Location Lookup

Param Type Required Description
query string No Location name to search
country string No Filter by country ISO code

google_languages — Language Codes

No parameters. Returns all available language codes.

bing_serp_live — Bing SERP

Same parameters as google_serp_live (except no device).

youtube_serp_live — YouTube Rankings

Same parameters as google_serp_live (except no device, default depth 20).

Common Location Codes

Code Location
2840 United States
2826 United Kingdom
2276 Germany
2250 France
2392 Japan
2036 Australia
2124 Canada
2356 India
2076 Brazil
2724 Spain

Workflows

1. Competitive SERP Analysis

mcp__dataforseo-serp__google_serp_live(keyword="your target keyword", location_code=2840, depth=20)

2. Cross-Engine Comparison

mcp__dataforseo-serp__google_serp_live(keyword="your keyword", location_code=2840)
mcp__dataforseo-serp__bing_serp_live(keyword="your keyword", location_code=2840)

3. Mobile vs Desktop

mcp__dataforseo-serp__google_serp_live(keyword="your keyword", location_code=2840, device="desktop")
mcp__dataforseo-serp__google_serp_live(keyword="your keyword", location_code=2840, device="mobile")

4. Local SERP Check

mcp__dataforseo-serp__google_locations(query="San Francisco")
mcp__dataforseo-serp__google_serp_live(keyword="coffee shops", location_code=1014221)

5. YouTube Video Research

mcp__dataforseo-serp__youtube_serp_live(keyword="your topic", depth=20)

Integration with Other SEO Tools

Combine DataForSEO SERP data with:

  • Ahrefs: Backlinks, DR, keyword difficulty
  • SE Ranking: Keyword tracking over time
  • Search Console: Your actual click/impression data

Pricing

Endpoint Cost per Request
Google SERP Advanced ~$0.0025
Google SERP Regular ~$0.001
Bing SERP ~$0.002
YouTube SERP ~$0.002
Locations/Languages Free

New accounts get $1 free credit at dataforseo.com.