SEO Tools MCP 서버

SEO API를 위한 포괄적인 stdio MCP(Model Context Protocol) 서버입니다. 이 서버를 통해 LLM(거대 언어 모델)은 DataForSEO API 기능 및 기타 SEO 도구와 상호 작용할 수 있습니다.

개요

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

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

Related MCP server: DataForSEO MCP Server

기능

• DataForSEO API 엔드포인트에 대한 포괄적인 지원

• Local Falcon 및 기타 타사 SEO 도구와의 선택적 통합

• 쉬운 통합을 위한 Stdio 전송

• 인증 처리

• 상세한 오류 보고

• Zod 스키마를 사용한 타입 안전 도구 정의

• 새로운 API 통합 추가를 위한 확장 가능한 아키텍처

• 환경 변수를 통한 선택적 모듈 및 도구 필터링

Data for Seo 가입하기

https://dataforseo.com/?aff=200885

구현된 API 카테고리

DataForSEO API

1. SERP API - Google, Bing, Yahoo 등에서 제공하는 검색 엔진 결과 데이터

2. Keywords Data API - 키워드 조사, 제안 및 검색량 데이터

3. DataForSEO Labs API - 고급 SEO 분석, 도메인 비교 및 키워드 분석

4. Backlinks API - 백링크 프로필, 참조 도메인 및 앵커 텍스트 분석

5. OnPage API - 웹사이트 감사, 콘텐츠 분석 및 기술적 SEO 점검

6. Domain Analytics API - 기술 스택 탐지 및 도메인 데이터 분석

7. Content Analysis API - 콘텐츠 품질 평가 및 의미론적 분석

8. Content Generation API - AI 기반 콘텐츠 생성 도구

9. Merchant API - Amazon 및 Google Shopping의 전자상거래 데이터

10. App Data API - Google Play 및 App Store의 모바일 앱 데이터

11. Business Data API - Google My Business, Trustpilot 등의 비즈니스 리스팅 데이터

12. AI Optimization API - ChatGPT, Claude, Gemini 및 Perplexity의 LLM 응답, AI 스크레이퍼 및 AI 키워드 데이터

Local Falcon API (선택 사항)

1. Calculate Grid Points - 로컬 순위 분석을 위한 그리드 좌표 생성

2. Search GMB Locations - 쿼리를 통해 Google My Business 위치 찾기

3. Get Ranking at Coordinate - 특정 좌표에서의 비즈니스 순위 확인

4. Keyword Search at Coordinate - 특정 위치에서 검색어 테스트

5. Run Grid Search - 전체 그리드 기반 로컬 순위 분석 수행

설치

# Clone the repository
git clone https://github.com/Skobyn/dataforseo-mcp-server.git

# Change to the project directory
cd dataforseo-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

사용법

이 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

모듈 및 도구 필터링

서버는 기본적으로 수백 개의 도구를 노출합니다. LLM과 함께 사용할 경우 전체 도구 목록은 상당한 컨텍스트 창 공간을 차지합니다. 필요한 모듈이나 도구만 활성화하도록 환경 변수를 사용하여 노출되는 도구 수를 줄일 수 있습니다.

필터링을 하는 이유:

• 컨텍스트 사용량 감소

• LLM의 더 빠른 도구 검색

• 더 집중된 응답

모듈별 필터링

ENABLED_MODULES를 사용하여 특정 API 카테고리만 활성화합니다(쉼표로 구분, 대소문자 구분 안 함):

export ENABLED_MODULES="SERP,BUSINESS_DATA,LABS"

사용 가능한 모듈:

• SERP - 검색 엔진 결과

• KEYWORDS_DATA - 키워드 조사

• LABS 또는 DATAFORSEO_LABS - 고급 SEO 분석

• BACKLINKS - 백링크 분석

• ONPAGE - 웹사이트 감사

• DOMAIN_ANALYTICS - 도메인 데이터

• CONTENT_ANALYSIS - 콘텐츠 평가

• CONTENT_GENERATION - AI 콘텐츠 생성

• MERCHANT - 전자상거래 데이터

• APP_DATA - 모바일 앱 데이터

• BUSINESS_DATA - 비즈니스 리스팅

• AI_OPTIMIZATION - LLM 응답 및 AI 데이터

개별 도구별 필터링

특정 도구에 대한 세밀한 제어를 위해 ENABLED_TOOLS를 사용합니다(쉼표로 구분, 대소문자 구분 안 함):

export ENABLED_TOOLS="serp_google_maps_live,business_data_google_my_business_info"

두 변수 모두 설정되지 않은 경우, 기본적으로 모든 모듈과 도구가 활성화됩니다.

모듈 범위 구독 및 404 오류

DataForSEO 액세스 권한은 종종 단일 구독이 아닌 모듈별로 부여됩니다. 즉, 일부 엔드포인트는 작동하지만 다른 엔드포인트는 404를 반환할 수 있습니다.

중요한 해석 규칙:

• SERP, App Data, DataForSEO Labs App Store 또는 Content Generation과 같이 알려진 라이브 엔드포인트에서 발생하는 404는 해당 모듈이 현재 계정에 활성화되어 있지 않음을 의미할 수 있습니다.

• 이는 반드시 MCP 서버의 버그나 잘못된 엔드포인트 경로가 아닙니다.

• 위치나 언어와 같은 무료 검색 엔드포인트는 동일한 광범위한 영역 내의 유료 라이브 엔드포인트를 사용할 수 없는 경우에도 여전히 작동할 수 있습니다.

서버는 이제 알려진 모듈 범위의 404 응답을 더 명확한 메시지로 정규화합니다:

• DataForSEO module not enabled: <module> ...

이런 상황이 발생하면 DataForSEO 대시보드에서 모듈을 활성화하거나 현재 계정에서 이미 활성화된 모듈의 도구로 전환하십시오.

Claude 또는 기타 LLM과 함께 사용하기

이 서버는 LLM이 표준화된 방식으로 외부 시스템과 상호 작용할 수 있도록 하는 Model Context Protocol을 구현합니다. Claude와 함께 사용하려면 해당 LLM 플랫폼의 특정 MCP 구현에 따라 통합해야 합니다.

사용 예시는 examples 디렉토리를 참조하십시오.

개발

# Run in development mode with hot reloading
npm run dev

# Run tests
npm test

예시

SEO Tools 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 Data 도구

• 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 도구

• backlinks_summary - 도메인의 백링크 프로필 요약 가져오기

• backlinks_backlinks - 도메인의 백링크 목록 가져오기

• backlinks_referring_domains - 대상에 대한 참조 도메인 가져오기

• backlinks_history - 대상에 대한 과거 백링크 데이터 가져오기

• backlinks_timeseries_summary - 백링크에 대한 시계열 데이터 가져오기

• backlinks_bulk_new_lost_backlinks - 여러 대상에 대한 신규 및 손실 백링크 가져오기

• backlinks_bulk_new_lost_referring_domains - 여러 대상에 대한 신규 및 손실 참조 도메인 가져오기

• backlinks_bulk_pages_summary - 여러 대상에 대한 페이지 요약 가져오기

DataForSEO AI Optimization 도구

• ai_chatgpt_models - 사용 가능한 ChatGPT 모델 목록 가져오기

• ai_chatgpt_llm_responses_live - ChatGPT로부터 실시간 응답 가져오기

• ai_chatgpt_scraper_locations - ChatGPT 스크레이퍼에 사용 가능한 위치 가져오기

• ai_chatgpt_scraper_languages - ChatGPT 스크레이퍼에 사용 가능한 언어 가져오기

• ai_claude_models - 사용 가능한 Claude 모델 목록 가져오기

• ai_claude_llm_responses_live - Claude로부터 실시간 응답 가져오기

• ai_gemini_models - 사용 가능한 Gemini 모델 목록 가져오기

• ai_gemini_llm_responses_live - Gemini로부터 실시간 응답 가져오기

• ai_perplexity_models - 사용 가능한 Perplexity 모델 목록 가져오기

• ai_perplexity_llm_responses_live - Perplexity로부터 실시간 응답 가져오기

• ai_keyword_data_search_volume_live - AI 키워드 검색량 데이터 가져오기

• ai_keyword_data_locations_and_languages - AI 키워드 데이터에 사용 가능한 위치 및 언어 가져오기

Local Falcon 도구 (구성된 경우)

• localfalcon_calculate_grid_points - 기본 좌표 주변의 그리드 포인트 계산

• localfalcon_search_gmb_locations - Google My Business 위치 검색

• localfalcon_get_ranking_at_coordinate - 특정 좌표에서 비즈니스 순위 가져오기

• localfalcon_keyword_search_at_coordinate - 특정 위치에서 키워드 검색

• localfalcon_run_grid_search - 로컬 순위에 대한 전체 그리드 검색 실행

전체 도구 목록

사용 가능한 모든 도구와 해당 매개변수의 전체 목록은 src/api 디렉토리의 구현을 확인하십시오.

서버 확장

서버는 확장 가능하도록 설계되었습니다. 추가 SEO API에 대한 지원을 추가하려면:

1. 통합을 위해 src/api/에 새 디렉토리를 만듭니다.

2. 클라이언트 처리 및 도구 등록을 구현합니다.

3. src/index.ts에 통합을 추가합니다.

4. 인증을 위한 환경 변수 처리를 추가합니다.

템플릿은 src/api/localfalcon/의 Local Falcon 통합을 참조하십시오.

라이선스

MIT