Naver Powerlink Budget Estimator MCP Server

네이버 파워링크 광고의 입찰가와 성과를 예측하는 Model Context Protocol (MCP) 서버입니다.

기능

• 입찰가 조회: 특정 키워드와 순위에 대한 예상 입찰가를 조회
• 성과 예측: 키워드와 입찰가로 예상 노출수, 클릭수, 비용을 예측
• 일괄 처리: 여러 키워드의 PC/모바일 데이터를 한번에 조회

설치 방법

npm에서 설치 (권장)

npm install -g naver-powerlink-budget-estimator

또는 소스코드에서 빌드

git clone https://github.com/pango-gy/Naver-Powerlink-Budget-Estimator.git
cd Naver-Powerlink-Budget-Estimator
npm install
npm run build

Claude Desktop 설정

Claude Desktop의 MCP 설정 파일에 다음을 추가하세요:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

npm 패키지로 설치한 경우 (권장):

{
  "mcpServers": {
    "naver-powerlink": {
      "command": "npx",
      "args": ["-y", "naver-powerlink-budget-estimator"],
      "env": {
        "NAVER_API_KEY": "your_api_key_here",
        "NAVER_SECRET_KEY": "your_secret_key_here",
        "NAVER_CUSTOMER_ID": "your_customer_id_here"
      }
    }
  }
}

로컬에서 빌드한 경우:

{
  "mcpServers": {
    "naver-powerlink": {
      "command": "node",
      "args": ["/path/to/your/Naver-Powerlink-Budget-Estimator/build/index.js"],
      "env": {
        "NAVER_API_KEY": "your_api_key_here",
        "NAVER_SECRET_KEY": "your_secret_key_here",
        "NAVER_CUSTOMER_ID": "your_customer_id_here"
      }
    }
  }
}

⚠️ 중요: env 객체의 API 키, SECRET 키, CUSTOMER ID를 네이버 검색광고에서 발급받은 실제 값으로 변경하세요!

설정을 적용한 후 Claude Desktop을 재시작하면 Claude가 네이버 파워링크 API를 사용할 수 있습니다.

사용 가능한 도구

1. get_average_position_bid

특정 키워드와 순위에 대한 예상 입찰가를 조회합니다.

키워드 "강아지 사료"의 PC 1순위 입찰가를 알려줘

2. estimate_performance

키워드와 입찰가로 예상 성과를 예측합니다.

키워드 "강아지 간식"에 1000원 입찰하면 예상 성과가 어떻게 돼?

3. process_keywords_bulk

여러 키워드를 일괄 처리합니다.

다음 키워드들의 PC 2순위, 모바일 3순위 입찰가와 성과를 분석해줘:
- 강아지 사료
- 고양이 간식
- 펫 용품

개발

# 빌드
npm run build

# 개발 모드 (watch)
npm run watch

# 테스트 실행
npm run dev

API 키 발급

네이버 검색광고 API 키는 네이버 검색광고 센터에서 발급받을 수 있습니다.

라이선스

MIT