SEO 도구 MCP 서버

SEO API를 위한 포괄적인 stdio MCP(모델 컨텍스트 프로토콜) 서버입니다. 이 서버를 통해 LLM(대규모 언어 모델)이 DataForSEO API 함수 및 기타 SEO 도구와 상호 작용할 수 있습니다.

개요

SEO 도구 MCP 서버는 Claude와 같은 LLM과 다양한 SEO API 간의 원활한 통합을 가능하게 하여 자연어 상호 작용을 통해 SEO 분석, 키워드 조사, 백링크 분석 및 기타 여러 SEO 관련 작업을 직접 수행할 수 있습니다.

이 구현은 모든 주요 DataForSEO API 엔드포인트를 MCP 도구로 노출하여 LLM이 특정 SEO 데이터를 검색하기 위해 호출할 수 있도록 합니다. 서버는 stdio를 전송 계층으로 사용하여 다양한 LLM 플랫폼과 쉽게 통합할 수 있습니다.

특징

DataForSEO API 엔드포인트에 대한 포괄적인 범위
Local Falcon 및 기타 타사 SEO 도구와의 선택적 통합
간편한 통합을 위한 Stdio 전송
인증 처리
자세한 오류 보고
Zod 스키마를 사용한 유형 안전 도구 정의
새로운 API 통합을 추가하기 위한 확장 가능한 아키텍처

구현된 API 카테고리

DataForSEO API

SERP API - Google, Bing, Yahoo 등의 검색 엔진 결과 데이터
키워드 데이터 API - 키워드 조사, 제안 및 검색 볼륨 데이터
DataForSEO Labs API - 고급 SEO 분석, 도메인 비교 및 키워드 분석
백링크 API - 백링크 프로필, 참조 도메인 및 앵커 텍스트 분석
OnPage API - 웹사이트 감사, 콘텐츠 분석 및 기술적 SEO 점검
도메인 분석 API - 기술 스택 감지 및 도메인 데이터 분석
콘텐츠 분석 API - 콘텐츠 품질 평가 및 의미 분석
콘텐츠 생성 API - AI 기반 콘텐츠 생성 도구
판매자 API - Amazon 및 Google 쇼핑의 전자 상거래 데이터
앱 데이터 API - Google Play 및 App Store의 모바일 앱 데이터
비즈니스 데이터 API - Google 내 비즈니스, Trustpilot 등의 비즈니스 목록 데이터

로컬 Falcon API(선택 사항)

그리드 포인트 계산 - 로컬 순위 분석을 위한 그리드 좌표 생성
GMB 위치 검색 - 쿼리로 Google 내 비즈니스 위치 찾기
좌표에서 순위 확인 - 특정 좌표에서 비즈니스 순위 확인
Coordinate에서 키워드 검색 - 특정 위치에서 검색어 테스트
그리드 검색 실행 - 전체 그리드 기반 로컬 순위 분석 수행

설치

지엑스피1

용법

이 MCP 서버를 사용하려면 사용하려는 서비스에 대한 API 자격 증명이 필요합니다.

DataForSEO로 서버 실행

# Set environment variables for DataForSEO authentication
export DATAFORSEO_LOGIN="your_login"
export DATAFORSEO_PASSWORD="your_password"

# Run the server
npm start

DataForSEO 및 Local Falcon을 사용하여 서버 실행

# Set environment variables for all API authentications
export DATAFORSEO_LOGIN="your_login"
export DATAFORSEO_PASSWORD="your_password"
export LOCALFALCON_API_KEY="your_localfalcon_api_key"
# Optional: Set custom Local Falcon API URL if needed
# export LOCALFALCON_API_URL="https://custom-localfalcon-url.com/api"

# Run the server
npm start

Claude 또는 다른 LLM과 함께 사용

이 서버는 LLM이 표준화된 방식으로 외부 시스템과 상호 작용할 수 있도록 하는 모델 컨텍스트 프로토콜(MCP)을 구현합니다. Claude와 함께 사용하려면 해당 MCP 구현 방식에 따라 LLM 플랫폼과 통합해야 합니다.

사용 예는 예제 디렉토리를 참조하세요.

개발

# Run in development mode with hot reloading
npm run dev

예시

SEO 도구 MCP 서버를 사용하는 방법을 보여주는 샘플 코드는 examples 디렉토리에서 확인하세요.

기본 예제는 다음을 보여줍니다.

서버 시작
클라이언트에서 연결
다양한 API 엔드포인트에 대한 호출 만들기
결과 처리

사용 가능한 도구

이 서버는 모든 통합 API 범주에 걸쳐 수백 개의 도구를 제공합니다. 가장 일반적으로 사용되는 도구의 몇 가지 예는 다음과 같습니다.

DataForSEO SERP API 도구

serp_google_organic_live - Google 자연 검색 결과 받기
serp_google_organic_task_post - Google 유기적 검색 작업 만들기
serp_google_maps_live - Google 지도 검색 결과 받기

DataForSEO 키워드 데이터 도구

keywords_google_ads_search_volume - 키워드에 대한 검색 볼륨을 가져옵니다.
keywords_google_ads_keywords_for_site - 도메인에 대한 키워드 제안 받기
keywords_google_trends_explore - 시간 경과에 따른 키워드 동향 살펴보기

DataForSEO Labs 도구

labs_google_keyword_ideas - 시드 키워드를 기반으로 키워드 아이디어를 얻으세요
labs_google_related_keywords - 관련 키워드 가져오기
labs_google_domain_rank_overview - 도메인 순위 개요 보기

DataForSEO 백링크 도구

backlinks_summary - 도메인의 백링크 프로필 요약을 가져옵니다.
backlinks_backlinks - 도메인에 대한 백링크 목록을 가져옵니다.
backlinks_referring_domains - 타겟에 대한 참조 도메인을 가져옵니다.

로컬 Falcon Tools(구성된 경우)

localfalcon_calculate_grid_points - 기준 좌표를 중심으로 그리드 포인트를 계산합니다.
localfalcon_search_gmb_locations - Google 내 비즈니스 위치 검색
localfalcon_get_ranking_at_coordinate - 특정 좌표의 사업체 순위를 가져옵니다.
localfalcon_keyword_search_at_coordinate - 특정 위치에서 키워드 검색
localfalcon_run_grid_search - 지역 순위에 대한 전체 그리드 검색을 실행합니다.

전체 도구 목록

사용 가능한 모든 도구와 매개변수의 전체 목록을 보려면 src/api 디렉토리에서 구현을 확인하세요.

서버 확장

이 서버는 확장 가능하도록 설계되었습니다. 추가 SEO API 지원을 추가하려면 다음을 수행하세요.

통합을 위해 src/api/ 에 새 디렉토리를 만듭니다.
클라이언트 처리 및 도구 등록 구현
src/index.ts 에 통합을 추가하세요
인증을 위한 환경 변수 처리 추가

템플릿은 src/api/localfalcon/ 에 있는 Local Falcon 통합을 참조하세요.

특허

MIT

SEO Tools MCP Server

Integrations