네이버 블로그 MCP로 검색 결과에서 무엇을 얻을 수 있나요?

블로그 포스트 제목, 작성자, 발행일, 요약 본문, 링크 URL을 구조화된 형태로 받을 수 있습니다. Claude가 이를 해석해 요약·비교·인사이트 도출까지 자동화할 수 있습니다.

한국어 블로그 검색 결과의 맞춤법이나 문장이 어색하면 어떻게 하나요?

한국어 맞춤법 검사 MCP(mcp-korean-spell)를 함께 연동하면 Claude가 검색 결과를 정리하거나 요약할 때 자동으로 맞춤법을 교정할 수 있습니다.

네이버 블로그를 Claude에 MCP로 연결하기 — 오픈API와 API 키 없는 두 가지 방법

Q: 네이버 블로그 검색 API는 무료인가요?

네이버 오픈API의 블로그 검색은 하루 25,000건까지 무료로 이용할 수 있습니다. 초과 시 유료 플랜이 필요하며, 개인 개발자가 일반적으로 쓰기에는 무료 한도로 충분합니다.

Q: AgentWebSearch-MCP는 API 키 없이 정말 네이버 검색이 되나요?

네. AgentWebSearch-MCP는 Chrome CDP(Chrome DevTools Protocol)를 사용해 실제 브라우저처럼 네이버를 검색합니다. API 키가 필요 없는 대신 로컬 머신에 Chrome이 설치되어 있어야 합니다.

Q: Claude Code나 Cursor에서도 같은 방법으로 사용할 수 있나요?

네. MCP 프로토콜을 지원하는 Claude Code, Cursor, Zed 등 모든 클라이언트에서 동일한 mcpServers 설정 방식으로 연결할 수 있습니다.

Q: Claude Desktop 설정 파일 경로는 어디에 있나요?

macOS는 ~/Library/Application Support/Claude/claude_desktop_config.json, Windows는 %APPDATA%\Claude\claude_desktop_config.json 입니다.

네이버 블로그 검색을 MCP로 Claude에 연결하면 “제주도 카페 블로그 리뷰 최근 10개만 표로 정리해줘” 한 줄로 검색·요약·비교까지 끝납니다. 이 가이드는 두 가지 경로를 다룹니다. 하나는 네이버 오픈API 공식 키를 쓰는 방식, 다른 하나는 키 없이 Chrome CDP로 검색하는 에이전트웹서치 MCP 방식입니다. 어느 쪽이든 준비물만 갖추면 15~30분 안에 설정을 마칠 수 있습니다.

먼저 어느 방식이 맞는지부터 정한 뒤, 해당 섹션만 따라가면 됩니다.

어떤 방식을 골라야 하나

두 방식은 신뢰도와 시작 난이도에서 트레이드오프가 분명합니다. 자동화·대량 검색이 목적이면 오픈API, 키 발급 없이 바로 테스트하고 싶으면 CDP 방식이 낫습니다.

항목	네이버 오픈API 방식	AgentWebSearch-MCP (CDP)
API 키 필요	필요 (무료 발급)	불필요
일일 호출 한도	25,000건	브라우저 제한 (사실상 무제한)
결과 신뢰도	공식 API 응답 (안정적 스키마)	실제 브라우저 렌더링 결과
설치 난이도	보통 (MCP 서버 직접 구성)	다소 복잡 (Chrome 필요)
적합한 사용	자동화·대량 검색	빠른 테스트·API 키 없이 시작

동작 구조 한눈에 보기

어느 방식이든 Claude는 MCP 서버를 거쳐 네이버에 닿습니다. Claude 본체에 API 키가 직접 노출되지 않고, 환경 변수로 키를 관리하는 MCP 서버가 중간에서 통신을 처리한다는 점이 핵심입니다.

[Claude Desktop / Claude Code]
         │  MCP 도구 호출 (stdio)
         ▼
[MCP 서버 (로컬 프로세스)]
         │  HTTPS 요청
         ▼
[네이버 검색 API 또는 Chrome CDP]
         │  JSON 응답 / HTML 파싱
         ▼
[MCP 서버가 결과 파싱 → Claude로 전달]

방법 A: 네이버 오픈API 공식 키 방식

1단계: 애플리케이션 등록과 키 발급

네이버 블로그 검색 API 키는 네이버 개발자 센터에서 무료로 발급합니다.

developers.naver.com에 네이버 계정으로 로그인합니다.
상단 메뉴 Application → 애플리케이션 등록을 클릭합니다.
애플리케이션 이름을 입력하고 사용 API 항목에서 검색을 선택합니다.
환경은 WEB을 선택하고, 비로그인 오픈 API 서비스 환경에 localhost를 입력합니다.
등록 후 Client ID와 Client Secret을 복사해 안전한 곳에 보관합니다.

발급한 키 하나로 블로그·뉴스·카페·웹 문서 등 네이버 검색 API 전반을 호출할 수 있습니다. 일일 기본 한도는 25,000건입니다.

2단계: curl로 API 먼저 검증하기

MCP 설정으로 넘어가기 전에, 키가 제대로 동작하는지 curl로 확인하면 이후 디버깅이 훨씬 쉬워집니다. YOUR_CLIENT_ID와 YOUR_CLIENT_SECRET 자리에 발급받은 값을 넣으세요.

curl -H "X-Naver-Client-Id: YOUR_CLIENT_ID" \
     -H "X-Naver-Client-Secret: YOUR_CLIENT_SECRET" \
     "https://openapi.naver.com/v1/search/blog.json?query=제주도+카페&display=5&sort=date"

정상 응답이면 items 배열에 블로그 포스트 목록이 담겨 옵니다. 이 스키마가 곧 MCP 도구가 Claude에 넘기는 데이터이므로, 어떤 필드가 오는지 미리 봐두면 좋습니다.

{
  "lastBuildDate": "...",
  "total": 1234567,
  "start": 1,
  "display": 5,
  "items": [
    {
      "title": "제주도 카페 추천 ...",
      "link": "https://blog.naver.com/...",
      "description": "블로그 발췌문...",
      "bloggername": "여행블로거",
      "bloggerlink": "https://blog.naver.com/...",
      "postdate": "20260710"
    }
  ]
}

응답 필드 정리:

title / description — 포스트 제목과 발췌문 (HTML 태그가 섞여 올 수 있음)
link / bloggerlink — 포스트 URL과 블로거 홈 URL
bloggername — 작성자
postdate — YYYYMMDD 형식 발행일
total — 전체 검색 결과 수 (페이징 판단용)

3단계: MCP 서버 구성과 Claude Desktop 연결

네이버 블로그 검색 API를 전용으로 래핑한 공개 MCP 서버는 현재 활발히 개발 중입니다. 지금 시점에 공식 오픈API를 Claude Desktop에 붙이려면, tools/call 요청을 받아 위 curl과 동일한 HTTP 요청을 네이버에 보내는 MCP 서버를 직접 구현하거나, 범용 HTTP 호출 도구를 제공하는 MCP 서버를 활용하는 두 갈래가 있습니다. 어느 쪽이든 아래 설정 골격은 동일합니다.

Claude Desktop 설정 파일 위치

운영체제	경로
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`

키는 코드에 적지 말고 env 블록에 넣어 MCP 서버가 NAVER_CLIENT_ID·NAVER_CLIENT_SECRET 환경 변수로 읽도록 구성합니다.

{
  "mcpServers": {
    "naver-blog-search": {
      "command": "node",
      "args": ["/절대경로/your-naver-mcp-server/index.js"],
      "env": {
        "NAVER_CLIENT_ID": "여기에_발급받은_CLIENT_ID",
        "NAVER_CLIENT_SECRET": "여기에_발급받은_CLIENT_SECRET"
      }
    }
  }
}

args의 경로는 반드시 절대 경로여야 합니다. 직접 만든 MCP 서버를 연결했다면 MCP모아에 서버를 제출해 공유해 주세요.

방법 B: API 키 없이 AgentWebSearch-MCP로 검색

키 발급 단계를 건너뛰고 싶다면 에이전트웹서치 MCP를 씁니다. Chrome CDP(Chrome DevTools Protocol)로 실제 브라우저처럼 네이버를 검색하므로 별도 키가 필요 없습니다. 대신 로컬에 Chrome이 떠 있어야 합니다.

1단계: 사전 준비

Python 3.10 이상 — python.org
Chrome 또는 Chromium 브라우저 — 로컬 설치 필수 (CDP 대상)
Git — 저장소 클론용
Claude Desktop — claude.ai/download

2단계: 저장소 클론과 의존성 설치

git clone https://github.com/insung8150/AgentWebSearch-MCP
cd AgentWebSearch-MCP
pip install -r requirements.txt

설치가 끝나면 Claude에 붙이기 전에 로컬에서 직접 한 번 띄워 오류가 없는지 확인합니다.

python server.py

오류 없이 실행되면 Ctrl+C로 종료한 뒤 다음 단계로 넘어갑니다. 여기서 에러가 나면 Claude 설정을 만져도 동작하지 않으므로, 이 단계에서 먼저 잡는 것이 중요합니다.

3단계: Claude Desktop 설정 편집

설정 파일을 열어 mcpServers에 아래를 추가합니다. /절대경로/AgentWebSearch-MCP/는 실제 클론한 경로로 바꾸세요.

{
  "mcpServers": {
    "agentwebsearch": {
      "command": "python",
      "args": ["/절대경로/AgentWebSearch-MCP/server.py"]
    }
  }
}

macOS에서 python이 인식되지 않으면 python3으로 바꾸거나, which python3으로 확인한 절대 경로를 command 값에 넣으세요.

4단계: 재시작과 동작 확인

Claude Desktop을 완전히 종료(macOS는 메뉴바 트레이까지)하고 다시 실행합니다. 그다음 아래처럼 요청해 보세요.

“네이버에서 ‘제주도 카페 추천’ 블로그 검색해줘”
“네이버 블로그에서 ‘다이어트 식단’ 최신 글 5개 요약해줘”
“네이버와 구글에서 ‘MCP 서버 한국어’ 검색 결과 비교해줘”

Claude가 AgentWebSearch-MCP 도구를 호출해 실시간 결과를 가져오면 연동 성공입니다.

흔한 오류와 해결

네이버 API 401 인증 오류 (방법 A)

키 입력 실수가 대부분입니다. 개발자 센터에서 복사할 때 앞뒤 공백이 끼지 않았는지 확인하고, 애플리케이션에서 검색 API 사용 신청이 완료됐는지 다시 보세요. 신청 직후 수 분간 사용이 제한될 수 있습니다.

Chrome을 찾을 수 없다는 오류 (방법 B)

CDP 방식은 로컬 Chrome/Chromium이 필수입니다. macOS라면 /Applications/Google Chrome.app 존재 여부를 확인하세요. Chrome 경로를 환경 변수나 설정으로 지정하는 옵션은 저장소 README를 참고합니다.

MCP 도구가 Claude에 안 보이는 경우

설정 파일 JSON 문법 오류가 1순위 원인입니다. 쉼표 위치, 따옴표 누락, 중괄호 짝을 JSONLint로 검사하세요. 그다음 command에 적은 실행 파일(node, python 등)이 그 경로에 실제로 있는지 터미널에서 직접 실행해 확인합니다.

API 응답에 결과가 없는 경우 (방법 A)

검색어에 특수문자나 잘못된 인코딩이 섞이면 빈 결과가 올 수 있습니다. query 파라미터가 URL 인코딩됐는지 확인하고, 동일 쿼리를 개발자 센터의 API 테스트 도구로 먼저 돌려 보세요.

함께 쓰면 좋은 MCP 서버

한국어 맞춤법 검사 MCP

한국어 맞춤법 검사 MCP는 네이버 맞춤법 검사기를 활용해, Claude가 블로그 검색 결과를 정리·요약할 때 문장 오류를 자동 교정합니다. API 키 없이 npx 한 줄로 실행됩니다.

npx -y @winterjung/mcp-korean-spell

GitHub 저장소: https://github.com/winterjung/mcp-korean-spell

네이웍스 MCP 서버

네이웍스 MCP 서버는 LINE WORKS(NAVER WORKS) 업무 플랫폼을 Claude에 연결합니다. 블로그 검색 결과를 LINE WORKS 채널·메시지로 자동 공유하는 워크플로에 쓸 수 있습니다. API 키는 developers.worksmobile.com에서 발급합니다.

npx nworks mcp

GitHub 저장소: https://github.com/yjcho9317/nworks

카카오·네이버 카테고리에서 네이버·카카오 API를 활용하는 더 많은 MCP 서버를 볼 수 있습니다.

자주 묻는 질문

네이버 블로그 검색 API는 무료인가요?

네이버 오픈API의 블로그 검색은 하루 25,000건까지 무료입니다. 초과 시 유료 플랜이 필요하지만, 개인 개발자라면 무료 한도로 대개 충분합니다.

AgentWebSearch-MCP는 API 키 없이 정말 네이버 검색이 되나요?

네. Chrome CDP(Chrome DevTools Protocol)로 실제 브라우저처럼 네이버를 검색합니다. 키는 필요 없지만 로컬에 Chrome이 설치돼 있어야 합니다.

검색 결과에서 무엇을 얻을 수 있나요?

블로그 포스트의 제목, 작성자, 발행일, 발췌 본문, 링크 URL을 구조화된 형태로 받습니다. Claude가 이를 해석해 요약·비교·인사이트 도출까지 자동화합니다.

Claude Code나 Cursor에서도 같은 방법으로 쓸 수 있나요?

네. MCP를 지원하는 Claude Code, Cursor, Zed 등 모든 클라이언트에서 동일한 mcpServers 설정 방식으로 연결됩니다.

검색 결과의 맞춤법이나 문장이 어색하면 어떻게 하나요?

한국어 맞춤법 검사 MCP를 함께 연동하면 Claude가 결과를 정리·요약할 때 맞춤법을 자동 교정합니다.

Claude Desktop 설정 파일 경로는 어디인가요?

macOS는 ~/Library/Application Support/Claude/claude_desktop_config.json, Windows는 %APPDATA%\Claude\claude_desktop_config.json입니다.

다음 단계

연동을 마쳤다면 활용 범위를 넓혀 보세요.

맞춤법 자동 교정 추가: 한국어 맞춤법 검사 MCP로 검색 결과를 더 깔끔하게 정리합니다.
업무 자동화 연계: 네이웍스 MCP로 검색 결과를 LINE WORKS 채팅·캘린더에 연결합니다.
카카오·네이버 API 탐색: 카카오·네이버 카테고리에서 한국 주요 플랫폼 API 서버 목록을 확인합니다.
전체 MCP 서버 목록: MCP모아 서버 목록에서 국내외 서버를 검색해 기능을 추가합니다.