네이버 검색광고 API 연동, 개발자 없이 Claude·ChatGPT 로 5분 만에
Docca 팀 | 2026-10-27 | 8분
네이버 검색광고 API 를 쓰면 광고 성과를 원하는 대로 뽑아 보고, 키워드를 끄거나 입찰가를 바꾸는 일까지 광고주센터에 들어가지 않고 할 수 있어요. 다만 코드로 요청마다 서명을 만들고 기간도 나눠 불러야 해서 지금까지는 개발자가 있는 팀만 쓰던 기능이었죠.
Claude 나 ChatGPT 에 연결하면 코드 없이 5분이면 연동되고, 연동한 뒤에는 대화로 묻고 답하면서 광고를 관리하게 돼요. 연동하면 무엇이 되는지 저희 계정의 실제 대화부터 보고, 연동하는 방법은 그다음에 차례대로 적었어요.
연동하면 이렇게 대화로 광고를 관리해요
먼저 지난 7일 성과를 물어봤어요.
Docca 로 내 네이버 검색광고 지난 7일 성과를 키워드별로 보여 줘. 비용 많이 쓴 순으로 10개만, 클릭은 났는데 전환이 없는 키워드는 따로 짚어 줘.
이번에는 기간을 30일로 늘리고 조금 더 막연하게 물어봤어요.
Docca 로 내 네이버 검색광고 지난 30일을 봐 줘. 돈만 쓰고 성과 없는 키워드를 찾아서 각각 어떻게 할지 추천해 줘. 계정은 아직 바꾸지 마.Claude 는 캠페인, 키워드, 실제 검색어 리포트를 차례로 읽고 아래처럼 답했어요.
검색어 1,667개를 하나씩 훑어 구직자 검색을 골라내려면 손으로는 한참 걸리는데 여기서는 질문 한 번으로 끝났어요.
추천이 마음에 들면 "좋아, 적용해 줘" 라고 답하면 돼요. Claude 가 계정을 바로 바꾸는데, 한 번에 두 개 이상 바꿀 때는 바꾸기 전과 후를 확인 창에 보여 준 뒤 승인을 받아요.
바꾼 내역은 Docca 광고 앱의 변경 내역에 한 묶음으로 남고, 누가 언제 왜 바꿨는지와 얼마에서 얼마가 됐는지가 함께 보여요.
키워드를 새로 고를 때도 키워드 목록만 주면 검색량과 순위별 입찰가를 한 표로 받아요.
Docca 로 이 키워드들의 네이버 월 검색량, 구글 월 검색량, 모바일·PC 1위와 3위 예상 입찰가를 표로 정리해 줘.
네이버검색광고API, 네이버광고API, 네이버API, 네이버키워드도구, 네이버자동입찰, 클로드MCP| 키워드 | 네이버 검색량 | 구글 검색량 | 모바일 1위 / 3위 | PC 1위 / 3위 |
|---|---|---|---|---|
| 네이버검색광고API | 20 미만 | 390 | 70 / 70 | 70 / 70 |
| 네이버광고API | 20 미만 | 210 | 70 / 70 | 70 / 70 |
| 네이버API | 3,220 | 1,900 | 70 / 70 | 70 / 70 |
| 네이버키워드도구 | 5,000 | 1,000 | 1,010 / 550 | 3,410 / 990 |
| 네이버자동입찰 | 310 | 90 | 21,310 / 4,830 | 81,590 / 7,780 |
| 클로드MCP | 1,440 | 1,000 | 1,920 / 1,460 | 1,870 / 1,160 |
구글 검색량은 Docca 에 구글 광고 계정도 연결했을 때 같이 나와요.
API 로 하던 일, 이렇게 물어보세요
검색광고 API 로 많이 하는 일은 아래처럼 물어보면 돼요.
| 하려던 일 (API) | 이렇게 물어보기 |
|---|---|
| 일별 성과 받기 (/stats) | "지난달 캠페인별 비용과 전환을 주 단위로 정리해 줘" |
| 연관 키워드·검색량 (/keywordstool) | "'디자인 외주' 연관 키워드를 월 검색량 순으로 20개 보여 줘" |
| 순위별 입찰가 (/estimate) | "이 키워드로 모바일 3위에 오르려면 입찰가가 얼마야?" |
| 검색어·시간대 보고서 (/stat-reports) | "지난 30일 실제 검색어 중 비용만 쓰고 전환이 없는 걸 골라 줘" |
| 입찰가 바꾸기 (/ncc/keywords) | "전환 없는 키워드 입찰가를 20% 낮춰 줘" |
5분 만에 연동하는 방법
API 키를 받아 Docca 에 넣고 Claude 나 ChatGPT 에 Docca 를 연결하면 끝인데, 키는 광고 계정마다 하나씩 나오고 따로 심사도 없어요.
https://api.usedocca.com/v1/mcp
몇 초 뒤에 위에서 본 것 같은 답이 오는데, 키는 Docca 서버에만 있어서 대화에는 나오지 않아요.
코드로 직접 부르고 싶다면
직접 프로그램을 짜신다면 주소는 https://api.searchad.naver.com 이고 요청마다 헤더 네 개를 붙이는데, 그중 서명은 비밀키로 매번 새로 만들어야 해요.
X-Timestamp: 1761400000000 (밀리초)
X-API-KEY: 엑세스라이선스
X-Customer: 고객번호
X-Signature: base64( HMAC-SHA256( 비밀키, "{timestamp}.{method}.{path}" ) )아래 코드는 별도 설치 없이 파이썬 기본 모듈만으로 서명을 만들어 연관 키워드와 월 검색량을 받아요. 세 값만 바꿔 넣으면 바로 돌아가요.
import base64, hashlib, hmac, json, time, urllib.parse, urllib.request
API_KEY = "엑세스라이선스"
SECRET_KEY = "비밀키"
CUSTOMER_ID = "고객번호"
def call(method, path, params=None):
ts = str(int(time.time() * 1000))
msg = f"{ts}.{method}.{path}" # 서명에는 쿼리스트링을 넣지 않아요
sig = base64.b64encode(hmac.new(SECRET_KEY.encode(), msg.encode(), hashlib.sha256).digest()).decode()
url = "https://api.searchad.naver.com" + path
if params:
url += "?" + urllib.parse.urlencode(params)
req = urllib.request.Request(url, method=method, headers={
"X-Timestamp": ts, "X-API-KEY": API_KEY, "X-Customer": CUSTOMER_ID, "X-Signature": sig,
})
with urllib.request.urlopen(req) as r:
return json.load(r)
# 연관 키워드와 월 검색량(PC, 모바일)
res = call("GET", "/keywordstool", {"hintKeywords": "네이버검색광고API", "showDetail": 1})
for k in res["keywordList"][:10]:
print(k["relKeyword"], k["monthlyPcQcCnt"], k["monthlyMobileQcCnt"])성과를 받으려면 서명 말고도 지킬 규칙이 많아요. 성과 조회는 한 번에 92일까지이고, 일별 숫자는 키워드 하나씩만 받을 수 있고, 검색어·시간대 숫자는 보고서 작업을 만들어 파일로 내려받아야 해요. 자세한 내용은 네이버 검색광고 API, 이것 모르고 쓰면 분석이 틀어집니다와 네이버의 검색광고 API 공식 문서에 있어요.
자주 묻는 것
키는 어디에 보관하나요? 암호화해 저장하고 저장한 뒤에는 화면에도 다시 보여 주지 않아요. 네이버에서 숫자를 받아 오는 일은 서버가 하기 때문에 키가 대화창이나 브라우저를 거치지 않아요.
물어보기만 해도 광고 설정이 바뀌나요? 아니요, 조회 질문은 읽기만 하고 바꾸라고 말했을 때만 바꾸는데 두 개 이상이면 위처럼 승인을 받아요.
직접 짠 프로그램이 있어도 되나요? 네, 정해진 시각에 돌아가는 자동화는 코드로 두고 그때그때 궁금한 건 Claude 에 묻는 식으로 같이 쓰면 돼요.
API 로 받은 전환이 0 으로만 나온다면 전환추적부터 확인하는 글을 읽어 보세요.
