This repository contains implementation of an MCP server that allows to connect SE Ranking Data API with modern agentic flows
概览
Before you begin, please ensure you have the following software and accounts ready: - : You will need an active SE Ranking account to generate an API token. If you don’t have one, you can sign up here. - : A platform for developing, shipping, and running applications in containers. If you don’t have it, you can download it from the official Docker website. - : The Docker Compose plugin is a Docker CLI plugin that provides a command-line interface (CLI) for Docker Compose. To build the Docker image, you need to have Docker Compose installed. - : A free and open-source distributed version control system. You can download it from the official Git website. - : You will need either the Claude Desktop App or the Gemini CLI installed and configured on your machine. Follow these steps to install the SEO-MCP server on your local machine. - Open your terminal (or Command Prompt/PowerShell on Windows). - Clone the project repository from GitHub.
README
以下为原文 README 节选，完整内容请查看原文。
MCP Server
Installation
Prerequisites
Before you begin, please ensure you have the following software and accounts ready:
- SE Ranking Account: You will need an active SE Ranking account to generate an API token. If you don’t have one, you can sign up here.
- Docker: A platform for developing, shipping, and running applications in containers. If you don’t have it, you can download it from the official Docker website.
- Docker Compose Plugin: The Docker Compose plugin is a Docker CLI plugin that provides a command-line interface (CLI) for Docker Compose. To build the Docker image, you need to have Docker Compose installed.
- Git: A free and open-source distributed version control system. You can download it from the official Git website.
- AI Assistant: You will need either the Claude Desktop App or the Gemini CLI installed and configured on your machine.
Installation Steps
Follow these steps to install the SEO-MCP server on your local machine.
- Open your terminal (or Command Prompt/PowerShell on Windows).
- Clone the project repository from GitHub. This command downloads the necessary files to your machine.
git clone https://github.com/seranking/seo-data-api-mcp-server.git
- Navigate into the new directory in your terminal:
cd seo-data-api-mcp-server
Build the Docker Image
Make sure you’re in the seo-data-api-mcp-server repository directory, and run:
docker compose build
# Check that the image is built and named `se-ranking/seo-data-api-mcp-server`:
docker image ls
Note: don’t worry about the warnings, this is normal when building the image:
WARN[0000] The "SERANKING_API_TOKEN" variable is not set. Defaulting to a blank string.
How to Update SEO-MCP
To ensure you have the latest features and improvements, you should update the tool periodically.
- Navigate to your
seo-data-api-mcp-serverdirectory in the terminal. - Pull the latest changes from the GitHub repository.
git pull origin main
Connect to Claude Desktop
Claude Desktop reads its configuration from claude_desktop_config.json.
- Click on the Claude menu and select Settings….
- In the Settings window, navigate to the Developer tab in the left sidebar.
- Click the Edit Config button to open the configuration file. This action creates a new configuration file if one doesn’t exist or opens your existing configuration.
The file is located at:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%AppData%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
Example of Claude Desktop configuration for MCP server
JSON Configuration Template:
安装
docker run -i --rm -e SERANKING_API_TOKEN se-ranking/seo-data-api-mcp-server配置
{
"mcpServers": {
"seo-data-api-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SERANKING_API_TOKEN",
"se-ranking/seo-data-api-mcp-server"
],
"env": {
"SERANKING_API_TOKEN": "<your-api-token-here>"
}
}
}
}