무료 SEO MCP 도구 세트를 개발했습니다

Ahrefs 데이터를 기반으로 한 MCP(Model Control Protocol) SEO 도구 서비스입니다. 백링크 분석, 키워드 연구, 트래픽 추정 등의 기능을 포함합니다.

개요

이 서비스는 Ahrefs에서 SEO 데이터를 가져오는 API를 제공합니다. 캡차 해결, 인증 및 데이터 검색을 포함한 전체 프로세스를 처리합니다. 결과는 성능 향상과 API 비용 절감을 위해 캐시됩니다.

이 MCP 서비스는 학습 목적으로만 사용되며, 오용하지 마십시오. 이 프로젝트는 @哥飞 커뮤니티에서 영감을 받았습니다.

기능

• 🔍 백링크 분석

  • 모든 도메인의 상세 백링크 데이터 획득
  • 도메인 평가, 앵커 텍스트 및 링크 속성 확인
  • 교육 및 정부 도메인 필터링

• 🎯 키워드 연구

  • 시드 키워드에서 키워드 아이디어 생성
  • 키워드 난이도 점수 획득
  • 검색 볼륨 및 트렌드 확인

• 📊 트래픽 분석

  • 웹사이트 트래픽 추정
  • 트래픽 기록 및 트렌드 확인
  • 인기 페이지 및 국가 분포 분석
  • 키워드 순위 추적

• 🚀 성능 최적화

  • CapSolver를 사용한 자동 캡차 해결
  • 응답 캐싱

설치

필수 조건

• Python 3.10 이상
• CapSolver 계정 및 API 키(여기서 등록)

PyPI에서 설치

pip install seo-mcp

또는 uv를 사용하세요:

uv pip install seo-mcp

수동 설치

1. 저장소 클론:

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

2. 의존성 설치:

   pip install -e .
   # 또는
   uv pip install -e .

3. CapSolver API 키 설정:

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

사용 방법

서비스 실행

다음 방법으로 서비스를 실행할 수 있습니다:

Cursor IDE에서 사용

Cursor 설정에서 MCP 탭으로 이동, +Add new global MCP server 버튼 클릭 후 다음 내용 입력:

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

또한 프로젝트 루트에 .cursor/mcp.json 파일을 생성하고 위 내용을 입력할 수 있습니다.

API 참조

이 서비스는 다음 MCP 도구를 제공합니다:

get_backlinks_list(domain: str)

도메인의 백링크를 가져옵니다.

매개변수:

• domain（문자열）：분석할 도메인（예: "example.com"）

반환:

{
  "overview": {
    "domainRating": 76,
    "backlinks": 1500,
    "refDomains": 300
  },
  "backlinks": [
    {
      "anchor": "예시 링크",
      "domainRating": 76,
      "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")

키워드 아이디어를 생성합니다.

매개변수:

• keyword（문자열）：시드 키워드
• country（문자열）：국가 코드（기본값: "us"）
• search_engine（문자열）：검색 엔진（기본값: "Google"）

반환:

[
  {
    "keyword": "예시 키워드",
    "volume": 1000,
    "difficulty": 45,
    "cpc": 2.5
  }
]

get_traffic(domain_or_url: str, country: str = "None", mode: str = "subdomains")

트래픽 추정을 가져옵니다.

매개변수:

• domain_or_url（문자열）：분석할 도메인 또는 URL
• country（문자열）：국가 필터링（기본값: "None"）
• mode（문자열）：분석 모드（"subdomains" 또는 "exact"）

반환:

{
  "traffic_history": [...],
  "traffic": {
    "trafficMonthlyAvg": 50000,
    "costMontlyAvg": 25000
  },
  "top_pages": [...],
  "top_countries": [...],
  "top_keywords": [...]
}

keyword_difficulty(keyword: str, country: str = "us")

키워드 난이도 점수를 가져옵니다.

매개변수:

• keyword（문자열）：분석할 키워드
• country（문자열）：국가 코드（기본값: "us"）

반환:

{
  "difficulty": 45,
  "serp": [...],
  "related": [...]
}

개발

개발 시:

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

작동 원리

1. 사용자가 MCP로 요청
2. 서비스가 CapSolver를 사용하여 Cloudflare Turnstile 캡차 해결
3. Ahrefs에서 인증 토큰 검색
4. 요청된 SEO 데이터 검색
5. 형식화된 결과 처리 및 반환

장애 해결

• CapSolver API 키 오류：CAPSOLVER_API_KEY 환경 변수 확인
• 속도 제한：요청 빈도 감소
• 결과 없음：도메인이 Ahrefs에 포함되지 않을 수 있음
• 기타 문제：GitHub 저장소 참조

Home：https://www.claudemcp.com/ko/servers/seo-mcp