About dataforseo-skill-claude

DataForSEO API skill for Claude Code - Complete SEO data integration

n

Published by

nikhilbhansali

Visit View Profile

README.md

View on GitHub

DataForSEO Skill for Claude Code

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

Copy the dataforseo folder to ~/.agents/skills/:
```
cp -r dataforseo ~/.agents/skills/
```

Create symlink in Claude skills directory:

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

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.

dataforseo-skill-claude