Ahrefs 데이터를 기반으로 한 MCP(모델 제어 프로토콜) SEO 도구 서비스입니다. 백링크 분석, 키워드 조사, 트래픽 추정 등 다양한 기능을 포함합니다.

中文

개요

이 서비스는 Ahrefs에서 SEO 데이터를 가져올 수 있는 API를 제공합니다. CAPTCHA 해결, 인증, 데이터 검색 등 전체 과정을 처리합니다. 결과는 캐시되어 성능 향상과 API 비용 절감을 위해 이루어집니다.

이 MCP 서비스는 교육 목적으로만 사용됩니다. 악용하지 말아 주세요. 이 프로젝트는 @哥飞社群에서 영감을 받았습니다.

특징

• 🔍 백링크 분석

• 모든 도메인에 대한 상세한 백링크 데이터 제공

• 도메인 등급, 앵커 텍스트, 링크 속성 보기

• 교육 및 정부 도메인 필터링

• 🎯 키워드 연구

• 시드 키워드로부터 키워드 아이디어 생성

• 키워드 난이도 점수 얻기

• 검색 볼륨 및 추세 보기

• 📊 교통 분석

• 웹사이트 트래픽 추정

• 교통 이력 및 추세 보기

• 인기 페이지 및 국가별 분포 분석

• 트랙 키워드 순위

• 🚀 성능 최적화

• 캡차를 자동으로 푸는 CapSolver 사용

• 응답 캐싱

설치

전제 조건

• 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.