네이버 SERP 분석 MCP 서버

Model Context Protocol(MCP)을 구현한 네이버 검색 결과 분석 서버입니다.

기능

• 네이버 검색 결과 가져오기
• 웹페이지 HTML 분석

API

도구(Tools)

• search_naver

  • 네이버에서 키워드를 검색하고 상위 5개 검색 결과의 링크를 가져옵니다.
  • 입력: keyword (string)
  • 각 결과는 제목, URL, 간단한 설명을 포함합니다.

• analyze_urls

  • 주어진 URL 목록의 웹 페이지 내용을 분석합니다.
  • 입력: urls (string[])
  • 각 페이지의 제목, 헤딩, 문단 수, 단어 수, 키워드 밀도, 메타 설명 등을 추출합니다.

API 키 설정

이 서버는 두 개의 API 키를 사용합니다:

1. NAVER_API_KEY: 네이버 검색 API를 사용하기 위한 키
2. NAVER_API_SECRET_KEY: 콘텐츠 분석 API를 사용하기 위한 키

API 키는 다음 세 가지 방법으로 설정할 수 있습니다:

1. 환경 변수로 설정
2. 명령줄 인수로 전달
3. Docker 실행 시 환경 변수로 전달

사용법 (Claude Desktop)

claude_desktop_config.json에 다음을 추가하세요:

Docker 사용

{
  "mcpServers": {
    "server-naver-serp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "NAVER_API_KEY=your_naver_api_key_here",
        "-e",
        "NAVER_API_SECRET_KEY=your_naver_api_secret_key_here",
        "mcp/naver-serp"
      ]
    }
  }
}

NPX 사용 (인수로 API 키 전달)

{
  "mcpServers": {
    "server-naver-serp": {
      "command": "npx",
      "args": [
        "-y",
        "server-naver-serp",
        "your_naver_api_key_here",
        "your_naver_api_secret_key_here"
      ]
    }
  }
}

환경 변수 설정 (NPX 사용 시)

{
  "mcpServers": {
    "server-naver-serp": {
      "command": "npx",
      "args": ["-y", "server-naver-serp"],
      "env": {
        "NAVER_API_KEY": "your_naver_api_key_here",
        "NAVER_API_SECRET_KEY": "your_naver_api_secret_key_here"
      }
    }
  }
}

실제 구현 참고사항

이 서버는 기본 구조만 구현했으며, 다음 함수들은 실제 구현이 필요합니다:

1. searchNaver(keyword): 네이버 검색 결과 가져오기

   • 네이버 검색 API 사용 또는 웹 스크래핑으로 구현
   • 로봇 정책 준수 필요
   • 네이버 API 키 활용

2. analyzeUrls(urls): URL의 HTML 분석

   • axios로 HTML 가져오기
   • cheerio로 HTML 파싱 및 분석
   • 분석 API 키 활용

빌드

Docker 빌드:

docker build -t mcp/naver-serp .

라이센스

MIT 라이센스로 제공됩니다.