dataforseo

A Claude Code skill that provides complete DataForSEO API integration for SEO data and analysis.

Features

• Keyword Research: Search volume, CPC, competition, keyword ideas
• SERP Analysis: Google, Bing, YouTube organic results
• Backlink Analysis: Profile overview, referring domains, anchors
• Competitor Analysis: Domain intersection, keyword gap, competing domains
• Technical SEO: Page audits, Lighthouse scores, technology detection
• Content Analysis: Brand mentions, sentiment analysis
• Trends: Google Trends data
• And more: Business data, merchant data, app store data, AI optimization

Installation

Option 1: Using skills.sh (Recommended)

npx skills.sh install nikhilbhansali/dataforseo-skill-claude

Option 2: Manual Install

1. Copy the dataforseo folder to ~/.agents/skills/:

   cp -r dataforseo ~/.agents/skills/
   

2. Create symlink in Claude skills directory:

   ln -sf ../../.agents/skills/dataforseo ~/.claude/skills/dataforseo
   

3. Restart Claude Code

Setup API Credentials

Before first use, configure your DataForSEO API credentials:

import sys, os
sys.path.insert(0, os.path.expanduser('~/.agents/skills/dataforseo/scripts'))
from dataforseo_client import save_credentials, verify_credentials

# Get your credentials from https://app.dataforseo.com/
login = "[email protected]"
password = "your_api_password"

if verify_credentials(login, password):
    save_credentials(login, password)
    print("Credentials saved!")

Credentials are stored securely at ~/.dataforseo_config.json with restricted permissions.

Quick Start

import sys, os
sys.path.insert(0, os.path.expanduser('~/.agents/skills/dataforseo/scripts'))
from dataforseo_client import keywords_search_volume, extract_results, to_csv

# Get search volume for keywords
response = keywords_search_volume(
    keywords=["seo tools", "keyword research"],
    location_name="United States"
)
results = extract_results(response)
csv_path = to_csv(results, "keyword_volumes")
print(f"Results saved to: {csv_path}")

API Function Reference

Use Case	Function
Search volume, CPC, competition	keywords_search_volume()
Keyword ideas/suggestions	labs_keyword_ideas()
Keywords a site ranks for	labs_ranked_keywords()
SERP results for keyword	serp_google_organic()
Local/Maps rankings	serp_google_maps()
YouTube rankings	serp_youtube()
Backlink profile	backlinks_summary()
List of backlinks	backlinks_list()
Referring domains	backlinks_referring_domains()
Domain authority/rank	backlinks_bulk_ranks()
Competing domains	labs_competitors_domain()
Keyword gap analysis	labs_domain_intersection()
Link gap analysis	backlinks_domain_intersection()
Technical page audit	onpage_instant_pages()
Lighthouse scores	lighthouse_live()
Technology stack	domain_technologies()
Brand mentions	content_search()
Google Trends	google_trends()

Output

All results export to CSV at ~/dataforseo_outputs/. Files are auto-named with timestamps.

Documentation

• API Reference - Complete endpoint documentation
• Use Cases - Ready-to-use code recipes

Requirements

• Python 3.9+
• DataForSEO API account (free trial available)
• Claude Code CLI

License

MIT License - see LICENSE file.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.