@channel47/dataforseo-mcp-server
v1.0.0
Published
MCP server for keyword research via DataForSEO API - built for search and shopping media buyers
Downloads
9
Maintainers
Readme
DataForSEO Keywords MCP Server
A focused MCP (Model Context Protocol) server for keyword research and analysis via the DataForSEO API. Built specifically for search and shopping media buyers working with Google Ads and Bing Ads campaigns.
Overview
This MCP server enables LLMs like Claude to perform keyword research, analyze search volumes, explore trends, and gather competitive intelligence—all through natural language interactions. It's designed for media buyers who need quick access to keyword data for Google and Bing advertising campaigns.
The server uses stdio transport for easy integration with Claude Code, Claude Desktop, and other MCP-compatible platforms.
Features
- Google Ads keyword data - Search volumes, keyword suggestions, and competition metrics
- Bing Ads keyword data - Keyword research for Microsoft Advertising campaigns
- Google Trends integration - Explore keyword trends over time
- Location and language targeting - Filter data by geographic region and language
- Stdio transport for seamless LLM integration
- Type-safe tool definitions with Zod schemas
- Clear error reporting
Sign Up for DataForSEO
https://dataforseo.com/?aff=200885
Available Tools
Google Ads Keywords
| Tool | Description |
|------|-------------|
| keywords_google_ads_keywords_for_keyword | Get keyword suggestions based on a seed keyword |
| keywords_google_ads_keywords_for_site | Get keyword suggestions based on a domain or URL |
| keywords_google_ads_search_volume | Get search volume data for a list of keywords |
| keywords_google_ads_locations | List available geographic locations for targeting |
| keywords_google_ads_languages | List available languages for keyword data |
| keywords_google_ads_categories | List Google Ads keyword categories |
Google Trends
| Tool | Description |
|------|-------------|
| keywords_google_trends_explore | Explore keyword interest over time with date ranges and categories |
Bing Ads Keywords
| Tool | Description |
|------|-------------|
| keywords_bing_keywords_for_keywords | Get keyword suggestions from Bing Ads |
Installation
# Clone the repository
git clone https://github.com/Skobyn/dataforseo-mcp-server.git
# Change to the project directory
cd dataforseo-mcp-server
# Install dependencies
npm install
# Build the project
npm run buildConfiguration
Environment Variables
Set your DataForSEO API credentials:
export DATAFORSEO_LOGIN="your_login"
export DATAFORSEO_PASSWORD="your_password"Running the Server
npm startClaude Desktop Configuration
Add to your Claude Desktop config (claude_desktop_config.json):
{
"mcpServers": {
"dataforseo-keywords": {
"command": "node",
"args": ["/path/to/dataforseo-mcp-server/dist/index.js"],
"env": {
"DATAFORSEO_LOGIN": "your_login",
"DATAFORSEO_PASSWORD": "your_password"
}
}
}
}Usage Examples
Get search volume for keywords
Ask Claude: "What's the search volume for 'running shoes' and 'athletic footwear' in the US?"
The LLM will call keywords_google_ads_search_volume with:
{
"keywords": ["running shoes", "athletic footwear"],
"location_code": 2840,
"language_code": "en"
}Find keyword ideas for a competitor
Ask Claude: "What keywords is nike.com ranking for?"
The LLM will call keywords_google_ads_keywords_for_site with:
{
"target": "nike.com",
"location_code": 2840
}Explore keyword trends
Ask Claude: "Show me the trend for 'black friday deals' over the past year"
The LLM will call keywords_google_trends_explore with date range parameters.
Development
# Run in development mode
npm run devUse Cases for Media Buyers
- Campaign keyword research - Find high-volume, relevant keywords for Google/Bing campaigns
- Competitor analysis - Discover what keywords competitors are targeting
- Seasonal trend analysis - Identify trending keywords for timely campaigns
- Geographic targeting - Get keyword data filtered by location and language
- Shopping campaign optimization - Research product-related keywords for shopping ads
License
MIT

