Сервис SEO-инструмента MCP (Model Control Protocol) на основе данных Ahrefs. Включает такие функции, как анализ обратных ссылок, исследование ключевых слов, оценка трафика и многое другое.

中文

Обзор

Этот сервис предоставляет API для получения SEO-данных из Ahrefs. Он отвечает за весь процесс, включая решение CAPTCHA, аутентификацию и поиск данных. Результаты кэшируются для повышения производительности и снижения затрат на API.

Этот сервис MCP предназначен исключительно для образовательных целей. Пожалуйста, не используйте его неправильно. Этот проект вдохновлён @哥飞社群.

Особенности

• 🔍 Анализ обратных ссылок

• Получить подробные данные о обратных ссылках для любого домена

• Просмотр рейтинга домена, текста анкоря и атрибутов ссылок

• Фильтрация образовательных и государственных доменов

• 🎯 Исследование ключевых слов

• Генерировать идеи для ключевых слов из исходного ключевого слова

• Получить балл сложности по ключевым словам

• Просмотр объёма поиска и тенденций

• 📊 Анализ трафика

• Оценка трафика на сайте

• Просмотр истории и тенденций трафика

• Анализ популярных страниц и распределения по странам

• Рейтинги ключевых слов отслеживания

• 🚀 Оптимизация производительности

• Использовать CapSolver для автоматического решения CAPTCHA

• Кэширование отклика

Установка

Требования

• Python 3.10 или выше

SEO MCP

A MCP (Model Control Protocol) SEO tool service based on Ahrefs data. Includes features such as backlink analysis, keyword research, traffic estimation, and more.

中文

Overview

This service provides an API to retrieve SEO data from Ahrefs. It handles the entire process, including solving the CAPTCHA, authentication, and data retrieval. The results are cached to improve performance and reduce API costs.

This MCP service is for educational purposes only. Please do not misuse it. This project is inspired by @哥飞社群.

Features

• 🔍 Backlink Analysis

  • Get detailed backlink data for any domain
  • View domain rating, anchor text, and link attributes
  • Filter educational and government domains

• 🎯 Keyword Research

  • Generate keyword ideas from a seed keyword
  • Get keyword difficulty score
  • View search volume and trends

• 📊 Traffic Analysis

  • Estimate website traffic
  • View traffic history and trends
  • Analyze popular pages and country distribution
  • Track keyword rankings

• 🚀 Performance Optimization

  • Use CapSolver to automatically solve CAPTCHA
  • Response caching

Installation

Prerequisites

• Python 3.10 or higher
• CapSolver account and API key (register here)

Install from PyPI

pip install seo-mcp

Or use uv:

uv pip install seo-mcp

Manual Installation

1. Clone the repository:

   git clone https://github.com/cnych/seo-mcp.git
   cd seo-mcp
   

2. Install dependencies:

   pip install -e .
   # Or
   uv pip install -e .
   

3. Set the CapSolver API key:

   export CAPSOLVER_API_KEY="your-capsolver-api-key"
   

Usage

Run the service

You can run the service in the following ways:

Use in Cursor IDE

In the Cursor settings, switch to the MCP tab, click the +Add new global MCP server button, and then input:

{
  "mcpServers": {
    "SEO MCP": {
      "command": "uvx",
      "args": ["--python", "3.10", "seo-mcp"],
      "env": {
        "CAPSOLVER_API_KEY": "CAP-xxxxxx"
      }
    }
  }
}

You can also create a .cursor/mcp.json file in the project root directory, with the same content.

API Reference

The service provides the following MCP tools:

get_backlinks_list(domain: str)

Get the backlinks of a domain.

Parameters:

• domain (string): The domain to analyze (e.g. “example.com”)

Returns:

{
  "overview": {
    "domainRating": 76,
    "backlinks": 1500,
    "refDomains": 300
  },
  "backlinks": [
    {
      "anchor": "Example link",
      "domainRating": 76,
      "title": "Page title",
      "urlFrom": "https://referringsite.com/page",
      "urlTo": "https://example.com/page",
      "edu": false,
      "gov": false
    }
  ]
}

keyword_generator(keyword: str, country: str = "us", search_engine: str = "Google")

Generate keyword ideas.