Dataforseo MCP connector

OAuth 2.1/DCR AnalyticsMarketingAI

Connect to DataForSEO. Access real-time SEO data including SERP results, keyword analytics, backlinks analysis, domain technologies, and AI visibility...

Dataforseo MCP connector

Install the SDK
Section titled “Install the SDK”
- Node.js
- Python
Terminal window
1 npm install @scalekit-sdk/node
Terminal window
1 pip install scalekit
Full SDK reference: Node.js | Python
Set your credentials
Section titled “Set your credentials”

Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.
.env
```
SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
SCALEKIT_CLIENT_ID=<your-client-id>
SCALEKIT_CLIENT_SECRET=<your-client-secret>
```

1
import { ScalekitClient } from '@scalekit-sdk/node'
2
import 'dotenv/config'
3

4
const scalekit = new ScalekitClient(
5
  process.env.SCALEKIT_ENV_URL,
6
  process.env.SCALEKIT_CLIENT_ID,
7
  process.env.SCALEKIT_CLIENT_SECRET,
8
)
9
const actions = scalekit.actions
10

11
const connector = 'dataforseomcp'
12
const identifier = 'user_123'
13

14
// Generate an authorization link for the user
15
const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
16
console.log('Authorize Dataforseo MCP:', link)
17
process.stdout.write('Press Enter after authorizing...')
18
await new Promise(r => process.stdin.once('data', r))
19

20
// Make your first call
21
const result = await actions.executeTool({
22
  connector,
23
  identifier,
24
  toolName: 'dataforseomcp_business_data_business_listings_search',
25
  toolInput: {},
26
})
27
console.log(result)

1
import os
2
from scalekit.client import ScalekitClient
3
from dotenv import load_dotenv
4
load_dotenv()
5

6
scalekit_client = ScalekitClient(
7
    env_url=os.getenv("SCALEKIT_ENV_URL"),
8
    client_id=os.getenv("SCALEKIT_CLIENT_ID"),
9
    client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
10
)
11
actions = scalekit_client.actions
12

13
connection_name = "dataforseomcp"
14
identifier = "user_123"
15

16
# Generate an authorization link for the user
17
link_response = actions.get_authorization_link(
18
    connection_name=connection_name,
19
    identifier=identifier,
20
)
21
print("Authorize Dataforseo MCP:", link_response.link)
22
input("Press Enter after authorizing...")
23

24
# Make your first call
25
result = actions.execute_tool(
26
    tool_input={},
27
    tool_name="dataforseomcp_business_data_business_listings_search",
28
    connection_name=connection_name,
29
    identifier=identifier,
30
)
31
print(result)

What you can do

Connect this agent connector to let your agent:

Advanced serp youtube video subtitles live, serp youtube video info live, serp youtube video comments live — Get subtitle text for a YouTube video by video ID and language
Locations serp youtube, serp, merchant amazon — List available locations for YouTube SERP data queries
Lighthouse on page — Run a Lighthouse performance and SEO audit for a web page URL
Pages on page instant, dataforseo labs google relevant, backlinks domain — Get on-page SEO data for a URL including metadata, links, and content metrics
Parsing on page content — Extract and parse text content from a web page URL
Explore kw data google trends, kw data dfs trends — Get Google Trends data for keywords over a time range and location

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

dataforseomcp_ai_opt_kw_data_loc_and_lang # List available locations and languages for AI keyword data searches. 0 params

List available locations and languages for AI keyword data searches.

dataforseomcp_ai_opt_llm_ment_agg_metrics # Get aggregated LLM mention metrics for target domains or keywords across AI platforms. 6 params

Get aggregated LLM mention metrics for target domains or keywords across AI platforms.

Name Type Required Description

target array required Array of target objects to search for LLM mentions. Each object must contain either 'domain' or 'keyword'. Maximum number of targets: 1000

filters array optional Array-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

internal_list_limit number optional Internal parameter to limit the number of items processed. Not exposed to end-users.

language_code string optional Search engine language code (e.g., 'en')

location_name string optional full name of the location, example: 'United Kingdom', 'United States'

platform string optional Platform to search for LLM mentions

dataforseomcp_ai_opt_llm_ment_cross_agg_metrics # Compare LLM mention metrics across multiple targets using cross-aggregated analysis. 6 params

Compare LLM mention metrics across multiple targets using cross-aggregated analysis.

Name Type Required Description

targets array required array of objects containing target entities with aggregation keys. you can specify up to 10, but not less than 2

filters array optional Array-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

internal_list_limit number optional Internal parameter to limit the number of items processed. Not exposed to end-users.

language_code string optional Search engine language code (e.g., 'en')

location_name string optional full name of the location, example: 'United Kingdom', 'United States'

platform string optional Platform to search for LLM mentions

dataforseomcp_ai_opt_llm_ment_loc_and_lang # List available locations and languages for LLM mention searches. 0 params

List available locations and languages for LLM mention searches.

dataforseomcp_ai_opt_llm_ment_search # Search for LLM mentions of target domains or keywords across AI platforms. 7 params

Search for LLM mentions of target domains or keywords across AI platforms.

Name Type Required Description

target array required Array of target objects to search for LLM mentions. Each object must contain either 'domain' or 'keyword'. Maximum number of targets: 1000

filters array optional Array-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

language_code string optional Search engine language code (e.g., 'en')

limit number optional Number of results to return. Default is 10, maximum is 1000.

location_name string optional full name of the location, example: 'United Kingdom', 'United States'

order_by array optional resuresults sorting rules

platform string optional Platform to search for LLM mentions

dataforseomcp_ai_opt_llm_ment_top_domains # Get the top domains mentioned in LLM responses for specified targets. 8 params

Get the top domains mentioned in LLM responses for specified targets.

Name Type Required Description

target array required Array of target objects to search for LLM mentions. Each object must contain either 'domain' or 'keyword'. Maximum number of targets: 1000

initial_dataset_filters array optional Array-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

internal_list_limit number optional maximum number of elements within internal arrays, min value is 1, max value is 10

items_list_limit number optional maximum number of results in the items array, min value is 1, max value is 10

language_code string optional Search engine language code (e.g., 'en')

links_scope string optional specifies which links will be used to extract domains and aggregation

location_name string optional full name of the location, example: 'United Kingdom', 'United States'

platform string optional Platform to search for LLM mentions

dataforseomcp_ai_opt_llm_ment_top_pages # Get the top pages mentioned in LLM responses for specified targets. 8 params

Get the top pages mentioned in LLM responses for specified targets.

Name Type Required Description

target array required Array of target objects to search for LLM mentions. Each object must contain either 'domain' or 'keyword'. Maximum number of targets: 1000

internal_list_limit number optional maximum number of elements within internal arrays, min value is 1, max value is 10

items_list_limit number optional maximum number of results in the items array, min value is 1, max value is 10

language_code string optional Search engine language code (e.g., 'en')

links_scope string optional specifies which links will be used to extract domains and aggregation

location_name string optional full name of the location, example: 'United Kingdom', 'United States'

platform string optional Platform to search for LLM mentions

dataforseomcp_ai_optimization_chat_gpt_scraper # Retrieve AI-generated responses for a keyword from ChatGPT. 4 params

Retrieve AI-generated responses for a keyword from ChatGPT.

Name Type Required Description

keyword string required keyword

language_code string required Search engine language code (e.g., 'en')

force_web_search boolean optional force AI agent to use web search

location_name string optional full name of the location, example: 'United Kingdom', 'United States'

dataforseomcp_ai_optimization_chat_gpt_scraper_locations # List available locations for ChatGPT scraper results. 2 params

List available locations for ChatGPT scraper results.

Name Type Required Description

country_iso_code string optional ISO 3166-1 alpha-2 country code, for example: US, GB, MT

location_name string optional Name of location or it`s part.

dataforseomcp_ai_optimization_keyword_data_search_volume # Get AI search volume data for keywords across AI platforms. 3 params

Get AI search volume data for keywords across AI platforms.

Name Type Required Description

keywords array required Keywords. The maximum number of keywords you can specify: 1000

language_code string required Search engine language code (e.g., 'en')

location_name string optional full name of the location, example: 'United Kingdom', 'United States'

dataforseomcp_ai_optimization_llm_mentions_filters # List available filter fields and operators for LLM mention queries. 0 params

List available filter fields and operators for LLM mention queries.

dataforseomcp_ai_optimization_llm_models # List supported AI models available for LLM mention analysis. 1 param

List supported AI models available for LLM mention analysis.

Name Type Required Description

llm_type string required type of llm. Must be one of: 'claude', 'gemini', 'chat_gpt', 'perplexity'

dataforseomcp_ai_optimization_llm_response # Send a prompt to a specified LLM and retrieve its AI-generated response. 6 params

Send a prompt to a specified LLM and retrieve its AI-generated response.

Name Type Required Description

llm_type string required type of llm. Must be one of: 'claude', 'gemini', 'chat_gpt', 'perplexity'

model_name string required name of the AI model. consists of the actual model name and version name. if not sure which model to use, first call the ai_optimization_llm_models tool to get list of available models for the specified llm_type

user_prompt string required Prompt for the AI model. The question or task you want to send to the AI model. You can specify up to 500 characters in the user_prompt field

temperature number optional randomness of the AI response optional field higher values make output more diverse; lower values make output more focused;

top_p number optional diversity of the AI response, optional field, controls diversity of the response by limiting token selection;

web_search boolean optional enable web search for current information. When enabled, the AI model can access and cite current web information;

dataforseomcp_backlinks_anchors # Get anchor text distribution for backlinks pointing to a target domain or page. 5 params

Get anchor text distribution for backlinks pointing to a target domain or page.

Name Type Required Description

target string required domain, subdomain or webpage to get backlinks for

filters array optional Array-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

limit number optional the maximum number of returned anchors

offset number optional offset in the results array of returned anchors

order_by array optional results sorting rules

dataforseomcp_backlinks_available_filters # List available filter fields and operators for backlinks queries. 1 param

List available filter fields and operators for backlinks queries.

Name Type Required Description

tool string optional The name of the tool to get filters for

dataforseomcp_backlinks_backlinks # Get a list of backlinks pointing to a target domain, subdomain, or page. 6 params

Get a list of backlinks pointing to a target domain, subdomain, or page.

Name Type Required Description

target string required domain, subdomain or webpage to get backlinks for

filters array optional Array-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

limit number optional the maximum number of returned backlinks

mode string optional results grouping type

offset number optional offset in the results array of the returned backlinks

order_by array optional results sorting rules

dataforseomcp_backlinks_bulk_backlinks # Get backlink counts for multiple targets in a single request. 1 param

Get backlink counts for multiple targets in a single request.

Name Type Required Description

targets array required domains, subdomains or webpages to get rank for

dataforseomcp_backlinks_bulk_new_lost_backlinks # Get new and lost backlink counts for multiple targets over a time period. 2 params

Get new and lost backlink counts for multiple targets over a time period.

Name Type Required Description

targets array required domains, subdomains or webpages to get rank for

date_from string optional starting date of the time range

dataforseomcp_backlinks_bulk_new_lost_referring_domains # Get new and lost referring domain counts for multiple targets over a time period. 2 params

Get new and lost referring domain counts for multiple targets over a time period.

Name Type Required Description

targets array required domains, subdomains or webpages to get rank for

date_from string optional starting date of the time range

dataforseomcp_backlinks_bulk_pages_summary # Get page-level backlink summary data for multiple target pages. 2 params

Get page-level backlink summary data for multiple target pages.

Name Type Required Description

targets array required domains, subdomains or webpages to get summary data for

include_subdomains boolean optional indicates if indirect links to the target will be included in the results

dataforseomcp_backlinks_bulk_ranks # Get domain rank scores for multiple targets in a single request. 2 params

Get domain rank scores for multiple targets in a single request.

Name Type Required Description

targets array required domains, subdomains or webpages to get rank for

rank_scale string optional defines the scale used for calculating and displaying the rank, domain_from_rank, and page_from_rank values

dataforseomcp_backlinks_bulk_referring_domains # Get referring domain counts for multiple targets in a single request. 1 param

Get referring domain counts for multiple targets in a single request.

Name Type Required Description

targets array required domains, subdomains or webpages to get rank for

dataforseomcp_backlinks_bulk_spam_score # Get spam scores for multiple target domains in a single request. 1 param

Get spam scores for multiple target domains in a single request.

Name Type Required Description

targets array required domains, subdomains or webpages to get rank for

dataforseomcp_backlinks_competitors # Find competitor domains based on shared backlink profiles. 8 params

Find competitor domains based on shared backlink profiles.

Name Type Required Description

target string required domain, subdomain or webpage to get backlinks for

exclude_internal_backlinks boolean optional indicates if internal backlinks from subdomains to the target will be excluded from the results

exclude_large_domains boolean optional indicates whether large domain will appear in results

filters array optional Array-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

limit number optional the maximum number of returned domains

main_domain boolean optional indicates if only main domain of the target will be included in the search

offset number optional offset in the results array of returned networks

order_by array optional results sorting rules

dataforseomcp_backlinks_domain_intersection # Find domains whose backlinks intersect with multiple specified targets. 5 params

Find domains whose backlinks intersect with multiple specified targets.

Name Type Required Description

targets array required domains, subdomains or webpages to get links for

filters array optional Array-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

limit number optional the maximum number of returned results

offset number optional offset in the array of returned results

order_by array optional results sorting rules

dataforseomcp_backlinks_domain_pages # Get backlink data for individual pages within a target domain. 5 params

Get backlink data for individual pages within a target domain.

Name Type Required Description

target string required domain, subdomain or webpage to get backlinks for

filters array optional Array-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

limit number optional the maximum number of returned pages

offset number optional offset in the results array of returned pages

order_by array optional results sorting rules

dataforseomcp_backlinks_domain_pages_summary # Get a summary of backlink metrics for all pages within a target domain. 5 params

Get a summary of backlink metrics for all pages within a target domain.

Name Type Required Description

target string required domain, subdomain or webpage to get backlinks for

filters array optional Array-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

limit number optional the maximum number of returned anchors

offset number optional offset in the results array of returned anchors

order_by array optional results sorting rules

dataforseomcp_backlinks_page_intersection # Find pages that share backlinks with multiple specified target pages. 5 params

Find pages that share backlinks with multiple specified target pages.

Name Type Required Description

targets array required domains, subdomains or webpages to get links for

filters array optional Array-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

limit number optional the maximum number of returned results

offset number optional offset in the array of returned results

order_by array optional results sorting rules

dataforseomcp_backlinks_referring_domains # Get referring domains pointing to a target domain, subdomain, or page. 5 params

Get referring domains pointing to a target domain, subdomain, or page.

Name Type Required Description

target string required domain, subdomain or webpage to get backlinks for

filters array optional Array-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

limit number optional the maximum number of returned pages

offset number optional offset in the results array of returned pages

order_by array optional results sorting rules

dataforseomcp_backlinks_referring_networks # Get referring IP networks and subnets for a target domain. 6 params

Get referring IP networks and subnets for a target domain.

Name Type Required Description

target string required domain, subdomain or webpage to get backlinks for

filters array optional Array-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

limit number optional the maximum number of returned networks

network_address_type string optional indicates the type of network to get data for

offset number optional offset in the results array of returned networks

order_by array optional results sorting rules

dataforseomcp_backlinks_summary # Get an overview of backlinks data for a target domain, subdomain, or page. 3 params

Get an overview of backlinks data for a target domain, subdomain, or page.

Name Type Required Description

target string required domain, subdomain or webpage to get backlinks for

exclude_internal_backlinks boolean optional indicates if internal backlinks from subdomains to the target will be excluded from the results

include_subdomains boolean optional indicates if indirect links to the target will be included in the results

dataforseomcp_backlinks_timeseries_new_lost_summary # Get a timeseries summary of new and lost backlinks for a target domain. 4 params

Get a timeseries summary of new and lost backlinks for a target domain.

Name Type Required Description

target string required domain to get data for

date_from string optional starting date of the time range

date_to string optional ending date of the time range

group_range string optional time range which will be used to group the results

dataforseomcp_backlinks_timeseries_summary # Get a timeseries summary of backlink metrics for a target domain. 4 params

Get a timeseries summary of backlink metrics for a target domain.

Name Type Required Description

target string required domain to get data for

date_from string optional starting date of the time range

date_to string optional ending date of the time range

group_range string optional time range which will be used to group the results

dataforseomcp_business_data_business_listings_search # Search for local business listings by keyword and location. 9 params

Search for local business listings by keyword and location.

Name Type Required Description

categories array optional business categories

description string optional description of the element in SERP

filters array optional Array-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

is_claimed boolean optional indicates whether the business is verified by its owner on Google Maps

limit number optional the maximum number of returned businesses

location_coordinate string optional GPS coordinates of a location

offset number optional offset in the results array of returned businesses

order_by array optional results sorting rules

title string optional title of the element in SERP

dataforseomcp_content_analysis_phrase_trends # Analyze trends over time for a search phrase in web content. 8 params

Analyze trends over time for a search phrase in web content.

Name Type Required Description

date_from string required starting date of the time range

keyword string required target keyword

date_group string optional date grouping type

date_to string optional ending date of the time range

initial_dataset_filters array optional Array-based initial dataset filter expression applied to Search endpoint fields. A single condition is a 3-element array: [field, operator, value]. Combine c...

internal_list_limit number optional maximum number of elements within internal arrays

keyword_fields object optional target keyword fields and target keywords

page_type array optional target page types

dataforseomcp_content_analysis_search # Search for web pages containing a keyword and retrieve content analysis data. 8 params

Search for web pages containing a keyword and retrieve content analysis data.

Name Type Required Description

keyword string required target keyword

filters array optional Array-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

keyword_fields object optional target keyword fields and target keywords

limit number optional maximum number of results to return

offset number optional offset in the results array of returned keywords

order_by array optional results sorting rules

page_type array optional target page types

search_mode string optional results grouping type

dataforseomcp_content_analysis_summary # Get an aggregated summary of content analysis data for a keyword. 7 params

Get an aggregated summary of content analysis data for a keyword.

Name Type Required Description

keyword string required target keyword

internal_list_limit number optional maximum number of elements within internal arrays

keyword_fields object optional target keyword fields and target keywords

page_type array optional target page types

positive_connotation_threshold number optional positive connotation threshold

sentiments_connotation_threshold number optional sentiment connotation threshold

dataforseomcp_dataforseo_labs_available_filters # List available filter fields and operators for DataForSEO Labs queries. 1 param

List available filter fields and operators for DataForSEO Labs queries.

Name Type Required Description

tool string optional The name of the tool to get filters for

dataforseomcp_dataforseo_labs_bulk_keyword_difficulty # Get keyword difficulty scores for multiple keywords in a single request. 3 params

Get keyword difficulty scores for multiple keywords in a single request.

Name Type Required Description

keywords array required target keywords

language_code string optional language code

location_name string optional full name of the location

dataforseomcp_dataforseo_labs_bulk_traffic_estimation # Get estimated organic traffic data for multiple domains in a single request. 5 params

Get estimated organic traffic data for multiple domains in a single request.

Name Type Required Description

targets array required target domains, subdomains, and webpages.

ignore_synonyms boolean optional ignore highly similar keywords, if set to true, results will be more accurate

item_types array optional display results by item type

language_code string optional language code

location_name string optional full name of the location

dataforseomcp_dataforseo_labs_google_competitors_domain # Find competitor domains that share keyword rankings with a target domain. 11 params

Find competitor domains that share keyword rankings with a target domain.

Name Type Required Description

target string required target domain

exclude_top_domains boolean optional indicates whether to exclude world's largest websites

filters array optional Array-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

ignore_synonyms boolean optional ignore highly similar keywords, if set to true, results will be more accurate

include_clickstream_data boolean optional Include or exclude data from clickstream-based metrics in the result

item_types array optional display results by item type

language_code string optional language code

limit number optional Maximum number of keywords to return

location_name string optional full name of the location

offset number optional offset in the results array of returned keywords

order_by array optional results sorting rules

dataforseomcp_dataforseo_labs_google_domain_intersection # Find keywords where multiple domains rank together in Google search results. 12 params

Find keywords where multiple domains rank together in Google search results.

Name Type Required Description

target1 string required target domain 1

target2 string required target domain 2

filters array optional Array-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

ignore_synonyms boolean optional ignore highly similar keywords, if set to true, results will be more accurate

include_clickstream_data boolean optional Include or exclude data from clickstream-based metrics in the result

intersections boolean optional domain intersections in SERP

item_types array optional display results by item type

language_code string optional language code

limit number optional Maximum number of keywords to return

location_name string optional full name of the location

offset number optional offset in the results array of returned keywords

order_by array optional results sorting rules

dataforseomcp_dataforseo_labs_google_domain_rank_overview # Get an overview of organic and paid ranking metrics for a domain. 4 params

Get an overview of organic and paid ranking metrics for a domain.

Name Type Required Description

target string required target domain

ignore_synonyms boolean optional ignore highly similar keywords, if set to true, results will be more accurate

language_code string optional language code

location_name string optional full name of the location

dataforseomcp_dataforseo_labs_google_historical_keyword_data # Get historical search volume and competition data for a keyword. 3 params

Get historical search volume and competition data for a keyword.

Name Type Required Description

keywords array required keywords

language_code string optional language code

location_name string optional full name of the location

dataforseomcp_dataforseo_labs_google_historical_rank_overview # Get historical ranking metric trends for a domain over time. 5 params

Get historical ranking metric trends for a domain over time.

Name Type Required Description

target string required target domain

ignore_synonyms boolean optional ignore highly similar keywords, if set to true, results will be more accurate

include_clickstream_data boolean optional Include or exclude data from clickstream-based metrics in the result

language_code string optional language code

location_name string optional full name of the location

dataforseomcp_dataforseo_labs_google_historical_serp # Get historical Google SERP results for a keyword at a specified date. 3 params

Get historical Google SERP results for a keyword at a specified date.

Name Type Required Description

keyword string required target keyword

language_code string optional language code

location_name string optional full name of the location

dataforseomcp_dataforseo_labs_google_keyword_ideas # Generate keyword ideas and related terms based on a seed keyword and location. 8 params

Generate keyword ideas and related terms based on a seed keyword and location.

Name Type Required Description

keywords array required target keywords

filters array optional Array-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

include_clickstream_data boolean optional Include or exclude data from clickstream-based metrics in the result

language_code string optional language code

limit number optional Maximum number of keywords to return

location_name string optional full name of the location

offset number optional offset in the results array of returned keywords

order_by array optional results sorting rules

dataforseomcp_dataforseo_labs_google_keyword_overview # Get search volume, competition, and CPC data for a keyword. 4 params

Get search volume, competition, and CPC data for a keyword.

Name Type Required Description

keywords array required keywords

include_clickstream_data boolean optional Include or exclude data from clickstream-based metrics in the result

language_code string optional language code

location_name string optional full name of the location

dataforseomcp_dataforseo_labs_google_keyword_suggestions # Get keyword suggestions related to a seed keyword for a location. 8 params

Get keyword suggestions related to a seed keyword for a location.

Name Type Required Description

keyword string required target keyword

filters array optional Array-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

include_clickstream_data boolean optional Include or exclude data from clickstream-based metrics in the result

language_code string optional language code

limit number optional Maximum number of keywords to return

location_name string optional full name of the location

offset number optional offset in the results array of returned keywords

order_by array optional results sorting rules

dataforseomcp_dataforseo_labs_google_keywords_for_site # Get keywords that a domain ranks for in Google organic search results. 9 params

Get keywords that a domain ranks for in Google organic search results.

Name Type Required Description

target string required target domain

filters array optional Array-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

include_clickstream_data boolean optional Include or exclude data from clickstream-based metrics in the result

include_subdomains boolean optional Include keywords from subdomains

language_code string optional language code

limit number optional Maximum number of keywords to return

location_name string optional full name of the location

offset number optional offset in the results array of returned keywords

order_by array optional results sorting rules

dataforseomcp_dataforseo_labs_google_page_intersection # Find keywords where multiple URLs rank together in Google results. 12 params

Find keywords where multiple URLs rank together in Google results.

Name Type Required Description

pages array required pages array

exclude_pages array optional URLs of pages you want to exclude

filters array optional Array-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

ignore_synonyms boolean optional ignore highly similar keywords, if set to true, results will be more accurate

include_clickstream_data boolean optional Include or exclude data from clickstream-based metrics in the result

intersection_mode string optional indicates whether to intersect keywords

item_types array optional display results by item type

language_code string optional language code

limit number optional Maximum number of keywords to return

location_name string optional full name of the location

offset number optional offset in the results array of returned keywords

order_by array optional results sorting rules

dataforseomcp_dataforseo_labs_google_ranked_keywords # Get all keywords a domain or URL ranks for in Google organic search. 10 params

Get all keywords a domain or URL ranks for in Google organic search.

Name Type Required Description

target string required domain name or page url

filters array optional Array of filter conditions and logical operators. Each filter condition is an array of [field, operator, value].

include_clickstream_data boolean optional Include or exclude data from clickstream-based metrics in the result

include_subdomains boolean optional Include keywords from subdomains

item_types array optional display results by item type

language_code string optional language code

limit number optional Maximum number of keywords to return

location_name string optional full name of the location

offset number optional offset in the results array of returned keywords

order_by array optional results sorting rules

dataforseomcp_dataforseo_labs_google_related_keywords # Get related keywords for a seed keyword with search volume and CPC data. 9 params

Get related keywords for a seed keyword with search volume and CPC data.

Name Type Required Description

keyword string required target keyword

depth number optional keyword search depth

filters array optional Array-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

include_clickstream_data boolean optional Include or exclude data from clickstream-based metrics in the result

language_code string optional language code

limit number optional Maximum number of keywords to return

location_name string optional full name of the location

offset number optional offset in the results array of returned keywords

order_by array optional results sorting rules

dataforseomcp_dataforseo_labs_google_relevant_pages # Get pages from a domain that rank for a specified keyword. 11 params

Get pages from a domain that rank for a specified keyword.

Name Type Required Description

target string required target domain

exclude_top_domains boolean optional indicates whether to exclude world’s largest websites

filters array optional Array-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

ignore_synonyms boolean optional ignore highly similar keywords, if set to true, results will be more accurate

include_clickstream_data boolean optional Include or exclude data from clickstream-based metrics in the result

item_types array optional display results by item type

language_code string optional language code

limit number optional Maximum number of keywords to return

location_name string optional full name of the location

offset number optional offset in the results array of returned keywords

order_by array optional results sorting rules

dataforseomcp_dataforseo_labs_google_serp_competitors # Find domains competing for the same keywords in Google search results. 9 params

Find domains competing for the same keywords in Google search results.

Name Type Required Description

keywords array required keywords array

filters array optional Array-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

include_subdomains boolean optional Include keywords from subdomains

item_types array optional display results by item type

language_code string optional language code

limit number optional Maximum number of keywords to return

location_name string optional full name of the location

offset number optional offset in the results array of returned keywords

order_by array optional results sorting rules

dataforseomcp_dataforseo_labs_google_subdomains # Get organic ranking metrics broken down by subdomain for a target domain. 10 params

Get organic ranking metrics broken down by subdomain for a target domain.

Name Type Required Description

target string required target domain

filters array optional Array-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

ignore_synonyms boolean optional ignore highly similar keywords, if set to true, results will be more accurate

include_clickstream_data boolean optional Include or exclude data from clickstream-based metrics in the result

item_types array optional display results by item type

language_code string optional language code

limit number optional Maximum number of keywords to return

location_name string optional full name of the location

offset number optional offset in the results array of returned keywords

order_by array optional results sorting rules

dataforseomcp_dataforseo_labs_google_top_searches # Get top searched keywords for a specified location and language. 7 params

Get top searched keywords for a specified location and language.

Name Type Required Description

filters array optional Array-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

include_clickstream_data boolean optional Include or exclude data from clickstream-based metrics in the result

language_code string optional language code

limit number optional Maximum number of keywords to return

location_name string optional full name of the location

offset number optional offset in the results array of returned keywords

order_by array optional resuresults sorting rules

dataforseomcp_dataforseo_labs_search_intent # Classify the search intent (informational, navigational, transactional) for keywords. 2 params

Classify the search intent (informational, navigational, transactional) for keywords.

Name Type Required Description

keywords array required target keywords

language_code string optional language code

dataforseomcp_domain_analytics_technologies_available_filters # List available filter fields and operators for domain technology queries. 1 param

List available filter fields and operators for domain technology queries.

Name Type Required Description

tool string optional The name of the tool to get filters for

dataforseomcp_domain_analytics_technologies_domain_technologies # Get the web technologies and CMS platforms detected on a target domain. 1 param

Get the web technologies and CMS platforms detected on a target domain.

Name Type Required Description

target string required target domain

dataforseomcp_domain_analytics_whois_available_filters # List available filter fields and operators for WHOIS data queries. 1 param

List available filter fields and operators for WHOIS data queries.

Name Type Required Description

tool string optional The name of the tool to get filters for

dataforseomcp_domain_analytics_whois_overview # Get WHOIS registration data and domain ownership information. 5 params

Get WHOIS registration data and domain ownership information.

Name Type Required Description

filters array optional Array-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

is_claimed boolean optional indicates whether the business is verified by its owner on Google Maps

limit number optional the maximum number of returned domains

offset number optional offset in the results array of returned businesses

order_by array optional results sorting rules

dataforseomcp_kw_data_dfs_trends_demography # Get demographic breakdown of search interest for a keyword by location. 6 params

Get demographic breakdown of search interest for a keyword by location.

Name Type Required Description

keywords array required keywords

date_from string optional starting date of the time range

date_to string optional ending date of the time range

location_name string optional full name of the location

time_range string optional preset time ranges

type string optional dataforseo trends type

dataforseomcp_kw_data_dfs_trends_explore # Explore search trend data for keywords over a specified time range and location. 6 params

Explore search trend data for keywords over a specified time range and location.

Name Type Required Description

keywords array required keywords

date_from string optional starting date of the time range

date_to string optional ending date of the time range

location_name string optional full name of the location

time_range string optional preset time ranges

type string optional dataforseo trends type

dataforseomcp_kw_data_dfs_trends_subregion_interests # Get search interest data for a keyword broken down by subregion. 6 params

Get search interest data for a keyword broken down by subregion.

Name Type Required Description

keywords array required keywords

date_from string optional starting date of the time range

date_to string optional ending date of the time range

location_name string optional full name of the location

time_range string optional preset time ranges

type string optional dataforseo trends type

dataforseomcp_kw_data_google_ads_locations # List available locations for Google Ads keyword data. 3 params

List available locations for Google Ads keyword data.

Name Type Required Description

country_iso_code string required ISO 3166-1 alpha-2 country code, for example: US, GB, MT

location_name string optional Name of location or it`s part.

location_type string optional Type of location. Possible variants: 'TV Region','Postal Code','Neighborhood','Governorate','National Park','Quarter','Canton','Airport','Okrug','Prefecture','City','Country','Province','Barrio','Sub-District','Congressional District','Municipality District','district','DMA Region','Union Territory','Territory','Colloquial Area','Autonomous Community','Borough','County','State','District','City Region','Commune','Region','Department','Division','Sub-Ward','Municipality','University'

dataforseomcp_kw_data_google_ads_search_volume # Get Google Ads search volume and competition data for keywords. 3 params

Get Google Ads search volume and competition data for keywords.

Name Type Required Description

keywords array required Array of keywords to get search volume for

language_code string optional Language two-letter ISO code (e.g., 'en').

location_name string optional full name of the location

dataforseomcp_kw_data_google_trends_categories # List available categories for filtering Google Trends data. 0 params

List available categories for filtering Google Trends data.

dataforseomcp_kw_data_google_trends_explore # Get Google Trends data for keywords over a time range and location. 9 params

Get Google Trends data for keywords over a time range and location.

Name Type Required Description

keywords array required keywords

category_code number optional google trends search category

date_from string optional starting date of the time range

date_to string optional ending date of the time range

item_types array optional types of items returned

language_code string optional Language two-letter ISO code (e.g., 'en').

location_name string optional full name of the location

time_range string optional preset time ranges

type string optional google trends type

dataforseomcp_merchant_amazon_asin_live_advanced # Get detailed product information for an Amazon product by ASIN. 3 params

Get detailed product information for an Amazon product by ASIN.

Name Type Required Description

asin string required product ID

language_code string optional language code

location_name string optional full name of the location

dataforseomcp_merchant_amazon_locations # List available locations for Amazon product search results. 4 params

List available locations for Amazon product search results.

Name Type Required Description

country string optional ISO 3166-1 alpha-2 country code to filter locations by

limit number optional maximum number of locations to return

location_name_contains string optional filter locations by a substring match on location_name

offset number optional offset in the results array of returned locations

dataforseomcp_merchant_amazon_products_live_advanced # Search Amazon products by keyword and retrieve live product results. 7 params

Search Amazon products by keyword and retrieve live product results.

Name Type Required Description

keyword string required keyword

department string optional amazon product department

language_code string optional language code

location_name string optional full name of the location

price_max integer optional maximum product price

price_min integer optional minimum product price

sort_by string optional results sorting rules

dataforseomcp_merchant_amazon_sellers_live_advanced # Get seller information for an Amazon product by ASIN. 3 params

Get seller information for an Amazon product by ASIN.

Name Type Required Description

asin string required product identifier (ASIN) on Amazon

language_code string optional language code

location_name string optional full name of the location

dataforseomcp_on_page_content_parsing # Extract and parse text content from a web page URL. 4 params

Extract and parse text content from a web page URL.

Name Type Required Description

url string required URL of the page to parse

accept_language string optional Accept-Language header value

custom_user_agent string optional Custom User-Agent header

enable_javascript boolean optional Enable JavaScript rendering

dataforseomcp_on_page_instant_pages # Get on-page SEO data for a URL including metadata, links, and content metrics. 5 params

Get on-page SEO data for a URL including metadata, links, and content metrics.

Name Type Required Description

url string required URL to analyze

accept_language string optional language header for accessing the website

custom_js string optional Custom JavaScript code to execute

custom_user_agent string optional Custom User-Agent header

enable_javascript boolean optional Enable JavaScript rendering

dataforseomcp_on_page_lighthouse # Run a Lighthouse performance and SEO audit for a web page URL. 5 params

Run a Lighthouse performance and SEO audit for a web page URL.

Name Type Required Description

url string required URL of the page to parse

accept_language string optional Accept-Language header value

custom_user_agent string optional Custom User-Agent header

enable_javascript boolean optional Enable JavaScript rendering

full_data boolean optional Return the complete API response instead of a reduced version

dataforseomcp_serp_locations # List available locations for SERP data queries. 4 params

List available locations for SERP data queries.

Name Type Required Description

country_iso_code string required ISO 3166-1 alpha-2 country code, for example: US, GB, MT

location_name string optional Name of location or it`s part.

search_engine string optional search engine name, one of: google, yahoo, bing.

dataforseomcp_serp_organic_live_advanced # Get live organic search results for a keyword from a specified search engine. 8 params

Get live organic search results for a keyword from a specified search engine.

Name Type Required Description

keyword string required Search keyword

language_code string required search engine language code (e.g., 'en')

depth number optional parsing depth

device string optional device type

location_name string optional full name of the location

max_crawl_pages number optional page crawl limit

people_also_ask_click_depth number optional clicks on the corresponding element

search_engine string optional search engine name, one of: google, yahoo, bing.

dataforseomcp_serp_youtube_locations # List available locations for YouTube SERP data queries. 3 params

List available locations for YouTube SERP data queries.

Name Type Required Description

country_iso_code string required ISO 3166-1 alpha-2 country code, for example: US, GB, MT

location_name string optional Name of location or it`s part.

dataforseomcp_serp_youtube_organic_live_advanced # Get live YouTube search results for a keyword. 6 params

Get live YouTube search results for a keyword.

Name Type Required Description

keyword string required Search keyword

language_code string required search engine language code (e.g., 'en')

location_name string required full name of the location

block_depth number optional parsing depth

device string optional device type

os string optional device operating system

dataforseomcp_serp_youtube_video_comments_live_advanced # Get user comments for a YouTube video by video ID. 6 params

Get user comments for a YouTube video by video ID.

Name Type Required Description

language_code string required search engine language code (e.g., 'en')

location_name string required full name of the location

video_id string required ID of the video

depth number optional parsing depth, number of results in SERP, max value: 700

device string optional device type

os string optional device operating system

dataforseomcp_serp_youtube_video_info_live_advanced # Get metadata and details for a YouTube video by video ID. 5 params

Get metadata and details for a YouTube video by video ID.

Name Type Required Description

language_code string required search engine language code (e.g., 'en')

location_name string required full name of the location

video_id string required ID of the video

device string optional device type

os string optional device operating system

dataforseomcp_serp_youtube_video_subtitles_live_advanced # Get subtitle text for a YouTube video by video ID and language. 7 params

Get subtitle text for a YouTube video by video ID and language.

Name Type Required Description

language_code string required search engine language code (e.g., 'en')

location_name string required full name of the location

video_id string required ID of the video

device string optional device type

os string optional device operating system

subtitles_language string optional language code of original text (e.g., 'en')

subtitles_translate_language string optional language code of translated text (e.g., 'en')

Dataforseo MCP connector

Dataforseo MCP connector

Install the SDK

Set your credentials

Authorize and make your first call

What you can do

Tool list