seo-data-api

This MCP server provides access to SE Ranking’s SEO data and project management APIs via natural language commands. It exposes two categories of tools: Data API tools for keyword research, SERP and backlink analysis, domain visibility, site audits, and other SEO data; and Project API tools for managing projects, ranks, backlinks monitoring, and account management. After wiring the server through a compatible MCP client (such as Claude Desktop or Gemini CLI) using Docker, you can issue natural language requests and have the backend translate them into the appropriate API calls. Typical workflows include asking for keyword ideas, checking backlink status, running site audits, or updating project tasks and rank tracking data. Tools are prefixed with DATA_ for Data API endpoints and PROJECT_ for Project API endpoints, enabling clear scoping of access based on your tokens.

Prerequisites:

• A SE Ranking account to obtain API tokens
• Docker installed on your machine
• Optional: Git for cloning the repository

Option A: Docker (Recommended)

1. Ensure Docker is running on your machine.
2. Pull the MCP server image and run it with your tokens:

# Run the MCP server via Docker with required environment tokens
docker run -i --rm \
  -e DATA_API_TOKEN=<your-data-api-token-here> \
  -e PROJECT_API_TOKEN=<your-project-api-token-here> \
  se-ranking/seo-data-api-mcp-server

3. Verify the server starts and is reachable through the MCP client you are using.

Option B: Local Node.js Server (If you need to modify code) Note: This project is primarily deployed via Docker in production; use this path only if you are actively developing the MCP server.

1. Install dependencies and build:

npm install
npm run build

2. Start the server (environment variables required):

DATA_API_TOKEN=<your-data-api-token-here> \
PROJECT_API_TOKEN=<your-project-api-token-here> \
HOST=0.0.0.0 \
PORT=5000 \
npm run start-http

3. Access the server at the configured host/port (default http://0.0.0.0:5000/mcp).

Prerequisites recap:

• Docker (recommended) or Node.js 20+ if developing locally
• Tokens generated from SE Ranking API dashboard
• Ability to network the MCP client to the server endpoint

Tips and common issues:

• Environment variables DATA_API_TOKEN and PROJECT_API_TOKEN govern access. If you regenerate tokens, restart the MCP server.
• If you modify the Docker image or tokens, ensure you rebuild/restart to apply changes.
• To verify connectivity, use your MCP client’s test or sample request feature, and confirm that the seo-data-api-mcp server appears in your configured MCP server list.
• Token formats: DATA_API_TOKEN is a UUID, PROJECT_API_TOKEN is a 40-character hex string.
• If you run into rate limit issues, contact api@seranking.com to adjust quotas or consider pacing requests from your MCP client.
• You can override HOST and PORT via a .env file when using the local Node.js workflow.