{"_id":"@channel47/dataforseo-mcp-server","name":"@channel47/dataforseo-mcp-server","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@channel47/dataforseo-mcp-server","version":"1.0.0","description":"MCP server for keyword research via DataForSEO API - built for search and shopping media buyers","type":"module","main":"dist/index.js","bin":{"dataforseo-mcp-server":"dist/index.js"},"scripts":{"build":"tsc","prepublishOnly":"npm run build","start":"node dist/index.js","dev":"ts-node src/index.ts"},"keywords":["mcp","model-context-protocol","dataforseo","api","seo","keyword-research","google-ads","bing-ads"],"author":{"name":"channel47"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/channel47/dataforseo-mcp-server.git"},"homepage":"https://github.com/channel47/dataforseo-mcp-server#readme","bugs":{"url":"https://github.com/channel47/dataforseo-mcp-server/issues"},"engines":{"node":">=18"},"dependencies":{"@modelcontextprotocol/sdk":"^1.19.1","axios":"^1.6.7","zod":"^3.22.4"},"devDependencies":{"@types/node":"^20.11.19","ts-node":"^10.9.2","typescript":"^5.3.3"},"_id":"@channel47/dataforseo-mcp-server@1.0.0","gitHead":"bbcd2009be1f1b98f82cc70a135b88ed85449a8e","types":"./dist/index.d.ts","_nodeVersion":"24.1.0","_npmVersion":"11.3.0","dist":{"integrity":"sha512-A+zcHZduLSaX0jWaXzBEQfjKHcymKbYF8N78os9qbzVkmeMRLK2DzsJ0kX6tTzFyLqRIGifserncua5EDrQ1NA==","shasum":"8cdb638770094724ecd125527b90cbefc7ca605a","tarball":"https://registry.npmjs.org/@channel47/dataforseo-mcp-server/-/dataforseo-mcp-server-1.0.0.tgz","fileCount":54,"unpackedSize":215255,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIAV6nui/w3BaU2e7OH1KJXTaU14PWNFO4p8cmkWyCgvQAiBPeBBSbmpsHTEGY4UbCw3bzUyU4lXCbM2HL8uL9MVWBw=="}]},"_npmUser":{"name":"ctrlswing","email":"jacksondean.me@gmail.com"},"directories":{},"maintainers":[{"name":"ctrlswing","email":"jacksondean.me@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/dataforseo-mcp-server_1.0.0_1769106015853_0.8491159729313187"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-22T18:20:15.741Z","1.0.0":"2026-01-22T18:20:16.000Z","modified":"2026-01-22T18:20:16.584Z"},"maintainers":[{"name":"ctrlswing","email":"jacksondean.me@gmail.com"}],"description":"MCP server for keyword research via DataForSEO API - built for search and shopping media buyers","homepage":"https://github.com/channel47/dataforseo-mcp-server#readme","keywords":["mcp","model-context-protocol","dataforseo","api","seo","keyword-research","google-ads","bing-ads"],"repository":{"type":"git","url":"git+https://github.com/channel47/dataforseo-mcp-server.git"},"author":{"name":"channel47"},"bugs":{"url":"https://github.com/channel47/dataforseo-mcp-server/issues"},"license":"MIT","readme":"# DataForSEO Keywords MCP Server\n\n[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/skobyn-dataforseo-mcp-server-badge.png)](https://mseep.ai/app/skobyn-dataforseo-mcp-server)\n\nA 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.\n\n<a href=\"https://glama.ai/mcp/servers/@Skobyn/dataforseo-mcp-server\">\n  <img width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/@Skobyn/dataforseo-mcp-server/badge\" alt=\"DataForSEO Keywords MCP server\" />\n</a>\n\n## Overview\n\nThis 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.\n\nThe server uses stdio transport for easy integration with Claude Code, Claude Desktop, and other MCP-compatible platforms.\n\n## Features\n\n- **Google Ads keyword data** - Search volumes, keyword suggestions, and competition metrics\n- **Bing Ads keyword data** - Keyword research for Microsoft Advertising campaigns\n- **Google Trends integration** - Explore keyword trends over time\n- **Location and language targeting** - Filter data by geographic region and language\n- Stdio transport for seamless LLM integration\n- Type-safe tool definitions with Zod schemas\n- Clear error reporting\n\n## Sign Up for DataForSEO\n\nhttps://dataforseo.com/?aff=200885\n\n## Available Tools\n\n### Google Ads Keywords\n| Tool | Description |\n|------|-------------|\n| `keywords_google_ads_keywords_for_keyword` | Get keyword suggestions based on a seed keyword |\n| `keywords_google_ads_keywords_for_site` | Get keyword suggestions based on a domain or URL |\n| `keywords_google_ads_search_volume` | Get search volume data for a list of keywords |\n| `keywords_google_ads_locations` | List available geographic locations for targeting |\n| `keywords_google_ads_languages` | List available languages for keyword data |\n| `keywords_google_ads_categories` | List Google Ads keyword categories |\n\n### Google Trends\n| Tool | Description |\n|------|-------------|\n| `keywords_google_trends_explore` | Explore keyword interest over time with date ranges and categories |\n\n### Bing Ads Keywords\n| Tool | Description |\n|------|-------------|\n| `keywords_bing_keywords_for_keywords` | Get keyword suggestions from Bing Ads |\n\n## Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/Skobyn/dataforseo-mcp-server.git\n\n# Change to the project directory\ncd dataforseo-mcp-server\n\n# Install dependencies\nnpm install\n\n# Build the project\nnpm run build\n```\n\n## Configuration\n\n### Environment Variables\n\nSet your DataForSEO API credentials:\n\n```bash\nexport DATAFORSEO_LOGIN=\"your_login\"\nexport DATAFORSEO_PASSWORD=\"your_password\"\n```\n\n### Running the Server\n\n```bash\nnpm start\n```\n\n### Claude Desktop Configuration\n\nAdd to your Claude Desktop config (`claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"dataforseo-keywords\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/dataforseo-mcp-server/dist/index.js\"],\n      \"env\": {\n        \"DATAFORSEO_LOGIN\": \"your_login\",\n        \"DATAFORSEO_PASSWORD\": \"your_password\"\n      }\n    }\n  }\n}\n```\n\n## Usage Examples\n\n### Get search volume for keywords\n\nAsk Claude: *\"What's the search volume for 'running shoes' and 'athletic footwear' in the US?\"*\n\nThe LLM will call `keywords_google_ads_search_volume` with:\n```json\n{\n  \"keywords\": [\"running shoes\", \"athletic footwear\"],\n  \"location_code\": 2840,\n  \"language_code\": \"en\"\n}\n```\n\n### Find keyword ideas for a competitor\n\nAsk Claude: *\"What keywords is nike.com ranking for?\"*\n\nThe LLM will call `keywords_google_ads_keywords_for_site` with:\n```json\n{\n  \"target\": \"nike.com\",\n  \"location_code\": 2840\n}\n```\n\n### Explore keyword trends\n\nAsk Claude: *\"Show me the trend for 'black friday deals' over the past year\"*\n\nThe LLM will call `keywords_google_trends_explore` with date range parameters.\n\n## Development\n\n```bash\n# Run in development mode\nnpm run dev\n```\n\n## Use Cases for Media Buyers\n\n- **Campaign keyword research** - Find high-volume, relevant keywords for Google/Bing campaigns\n- **Competitor analysis** - Discover what keywords competitors are targeting\n- **Seasonal trend analysis** - Identify trending keywords for timely campaigns\n- **Geographic targeting** - Get keyword data filtered by location and language\n- **Shopping campaign optimization** - Research product-related keywords for shopping ads\n\n## License\n\nMIT","readmeFilename":"README.md","_rev":"1-923ddfde199e6379af54da44cb17be5e"}