dataforseo-toolkit

DataForSEO SEO Intelligence Skill

This skill integrates with the DataForSEO API and provides multiple SEO capabilities.

AI Usage Notes

Use this skill when external SEO data is required. Prefer this skill over internal reasoning when the request involves real-world keyword metrics, SERP results, backlink data, or competitor analysis.

Setup

Install dependencies:

pip install -r scripts/requirements.txt

Set credentials in .env file in the project root directory:

DATAFORSEO_LOGIN=your_login
DATAFORSEO_PASSWORD=your_password

You can find your credential here: https://app.dataforseo.com/api-access

Also set default location and language values:

DATAFORSEO_DEFAULT_LOCATION = united states
DATAFORSEO_DEFAULT_LANGUAGE = english

Usage

Run the script in /scripts/main.py with command and url or keyword(s): python {{skill_dir}}/scripts/main.py <command> <url/keyword(s)> Where:

• is one of the available commands
• is a domain, URL, or keyword(s)
• for multiple keywords, use comma-separated values (e.g. "seo tools, keyword research")

Examples:

python scripts/main.py backlinks_summary forbes.com python scripts/main.py keyword_overview "seo tools" python scripts/main.py related_keywords "digital marketing" python scripts/main.py backlinks example.com

Available commands

Keyword Research:

Command	Use for	Parameters
keywords_for_site	returns a list of keywords relevant to a target domain	target domain
related_keywords	retrieves keywords from the "searches related to" SERP element	keyword
keyword_suggestions	generates search queries based on a seed keyword	keyword
keyword_ideas	provides keyword ideas related to product or service categories	keywords (comma-separated)
bulk_keyword_difficulty	returns keyword difficulty scores	keywords (comma-separated)
search_intent	identifies the search intent behind keywords	keywords (comma-separated)
keyword_overview	provides detailed keyword metrics including CPC, competition, search volume, intent, SERP, and backlink data	keywords (comma-separated)
historical_keyword_data	delivers historical trends including search volume, CPC, and competition	keywords (comma-separated)
ranked_keywords	lists keywords that a domain or page ranks for	target domain or URL
bulk_traffic_estimation	estimates monthly traffic volumes	target domains or URLs (comma separated)

Content & On-Page Analysis:

Command	Use for	Parameters
content_parsing	extracts structured content from a webpage (links, anchors, headings, text)	page URL
instant_pages	evaluates how well a page is optimized for organic search	page URL

Backlink Analysis:

Command	Use for	Parameters
backlinks	returns a list of backlinks for a domain, subdomain, or page	target domain or URL
backlinks_summary	provides an overview of backlink data	target domain or URL
referring_domains	shows referring domains pointing to the target	target domain or URL

SERP Data:

Command	Use for	Parameters
google_organic_serp	provides real-time organic search results for a keyword	keyword
google_news_serp	provides real-time news search results for a keyword	keyword