mcp-dataforseo

# DataForSEO MCP Server A stdio-based Model Context Protocol (MCP) server for DataForSEO API. ## Installation You can run directly with npx: ```bash npx @skobyn/mcp-dataforseo --config '{"username":"your_username","password":"your_password"}' ``` Or install globally: ```bash npm install -g @skobyn/mcp-dataforseo mcp-dataforseo --config '{"username":"your_username","password":"your_password"}' ``` ## Usage Send JSON requests to stdin and receive JSON responses from stdout: ```bash echo '{"type":"dataforseo_serp","keyword":"artificial intelligence"}' | npx @skobyn/mcp-dataforseo --config '{"username":"your_username","password":"your_password"}' ``` ## Supported Request Types ### SERP API ```json { "type": "dataforseo_serp", "keyword": "artificial intelligence", "location_code": 2840, "language_code": "en", "device": "desktop", "os": "windows" } ``` ### Keywords Data API ```json { "type": "dataforseo_keywords_data", "keywords": ["seo", "search engine optimization"], "location_code": 2840, "language_code": "en" } ``` ### Backlinks API ```json { "type": "dataforseo_backlinks", "target": "example.com", "limit": 100 } ``` ### On-Page API ```json { "type": "dataforseo_onpage", "url": "https://example.com", "check_spell": true, "enable_javascript": true } ``` ### Domain Analytics API ```json { "type": "dataforseo_domain_analytics", "domain": "example.com" } ``` ### App Data API ```json { "type": "dataforseo_app_data", "app_id": "com.example.app" } ``` ### Merchant API ```json { "type": "dataforseo_merchant", "keyword": "bluetooth speakers", "location_code": 2840, "language_code": "en" } ``` ### Business Data API ```json { "type": "dataforseo_business_data", "keyword": "pizza delivery", "location_code": 2840, "language_code": "en" } ``` ## Integration Example Here's how to use this MCP server in your Node.js code: ```javascript const { spawn } = require('child_process'); // Start the MCP server const server = spawn('npx', ['@skobyn/mcp-dataforseo', '--config', '{"username":"your_username","password":"your_password"}']); // Define the request const request = { type: 'dataforseo_serp', keyword: 'artificial intelligence' }; // Send the request server.stdin.write(JSON.stringify(request) + '\n'); server.stdin.end(); // Process the response server.stdout.on('data', (data) => { const response = JSON.parse(data.toString()); console.log(response); }); // Handle errors server.stderr.on('data', (data) => { console.error(`Error: ${data}`); }); ``` ## Environment Variables You can also use environment variables instead of the config: ```bash export DATAFORSEO_USERNAME=your_username export DATAFORSEO_PASSWORD=your_password npx @skobyn/mcp-dataforseo ``` ## Publishing To publish this package to npm: 1. Login to npm if not already logged in: ```bash npm login ``` 2. Publish the package: ```bash npm publish --access public ``` 3. To update the package later: ```bash npm version patch npm publish ```