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 |