https://github.com/skobyn/mcp-dataforseo
Model Context Protocol server for DataForSEO API
https://github.com/skobyn/mcp-dataforseo
Last synced: 2 months ago
JSON representation
Model Context Protocol server for DataForSEO API
- Host: GitHub
- URL: https://github.com/skobyn/mcp-dataforseo
- Owner: Skobyn
- Created: 2025-03-19T19:03:09.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-06-17T04:26:41.000Z (4 months ago)
- Last Synced: 2025-06-17T13:11:35.940Z (4 months ago)
- Language: JavaScript
- Size: 579 KB
- Stars: 6
- Watchers: 2
- Forks: 5
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# DataForSEO MCP Server
A stdio-based Model Context Protocol (MCP) server for DataForSEO API.
# Sign up for Data for Seo
https://dataforseo.com/?aff=200885
## 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
```