1. 네이버 검색광고 API 키 발급 — 아래 "🔑 API 키 발급법" 펼쳐서 따라하기 (3분, 무료)
  2. Cloudflare Worker 만들기 — 아래 "🌐 워커 만드는 법" 펼쳐서 따라하기 (3분, 무료)
  3. 아래 ⚙️ 설정 칸에 4개 값 입력 — 한 번만 입력하면 다음부터 자동 기억됨
  4. 키워드 입력 → 조회 시작 — 끝!
💡 두 가지 다 무료입니다. 검색광고 API는 광고비 충전 없이 사용 가능하고, Cloudflare Worker는 하루 10만 요청까지 무료예요.
  1. 네이버 검색광고 가입
    👉 searchad.naver.com 접속 → 우측 상단 신규가입
    개인/사업자 둘 다 OK. 광고비 충전 불필요. 네이버 아이디로 간편가입.
  2. 광고시스템 접속
    👉 manage.searchad.naver.com 로그인
  3. 좌측 메뉴 「도구」 → 「API 사용 관리」 클릭
    처음이면 "네이버 검색광고 API 서비스 신청" 버튼이 보입니다. 클릭 → 약관 동의 → 신청 (즉시 승인).
  4. 3개 값 복사해두기
    📋 CUSTOMER_ID = 페이지 상단 "현재 접근 중인 광고계정: CUSTOMER_ID = 1234567" 의 숫자
    🔑 API_KEY (액세스라이선스) = 페이지에 표시된 긴 hex 문자열 (옆에 「복사」 버튼)
    🔐 SECRET_KEY (비밀키) = 페이지에 표시된 base64 문자열 (옆에 「복사」 버튼)
⚠️ 비밀키는 본인만 알아야 합니다. 다른 사람에게 알려주거나 공개 코드에 그대로 적지 마세요. 노출되면 "재발급" 버튼으로 새 키 생성.
📌 왜 필요한가?
브라우저에서 네이버 API를 직접 호출하면 CORS 정책에 막힙니다. Cloudflare Worker가 중간에서 대신 호출해주는 역할을 합니다. API 키는 Worker를 거치지 않고 본인 브라우저 안에서만 사용되니 안전합니다.
  1. dash.cloudflare.com 가입 (이메일만 있으면 가능, 무료)
  2. 로그인 후 좌측 메뉴 「Workers & Pages」 클릭
  3. 「Create application」「Create Worker」 클릭
  4. 이름 정하기 (예: my-naver-proxy) → 「Deploy」 클릭
  5. 배포 완료되면 「Edit code」 클릭 → 기존 코드 모두 삭제 후 아래 코드 붙여넣기
export default {
  async fetch(request) {
    // CORS preflight 처리
    if (request.method === 'OPTIONS') {
      return new Response(null, {
        headers: {
          'Access-Control-Allow-Origin': '*',
          'Access-Control-Allow-Methods': 'GET, POST, PUT, DELETE, OPTIONS',
          'Access-Control-Allow-Headers': '*',
          'Access-Control-Max-Age': '86400',
        }
      });
    }

    const url = new URL(request.url);
    const targetUrl = url.searchParams.get('url');
    if (!targetUrl) {
      return new Response('url 파라미터 필요', { status: 400 });
    }

    // 커스텀 헤더(X-Timestamp, X-API-KEY 등) 통과시키기
    const forwardHeaders = new Headers();
    for (const [key, value] of request.headers) {
      const lower = key.toLowerCase();
      if (lower.startsWith('x-') || lower === 'content-type' || lower === 'accept') {
        forwardHeaders.set(key, value);
      }
    }

    try {
      const response = await fetch(targetUrl, {
        method: request.method,
        headers: forwardHeaders,
        body: (request.method !== 'GET' && request.method !== 'HEAD') ? await request.text() : undefined
      });

      const newHeaders = new Headers(response.headers);
      newHeaders.set('Access-Control-Allow-Origin', '*');
      newHeaders.set('Access-Control-Expose-Headers', '*');

      return new Response(response.body, {
        status: response.status,
        headers: newHeaders
      });
    } catch (e) {
      return new Response('프록시 오류: ' + e.message, { status: 500 });
    }
  }
}
  1. 「Save and Deploy」 클릭 → 우측 상단 URL 복사 (예: my-naver-proxy.본인계정.workers.dev)
  2. 아래 ⚙️ 설정의 「Worker URL」에 그 주소 붙여넣기 → 끝!
A) 광고비를 충전해야 API를 쓸 수 있나요?
아니요. 광고비 충전 없이도 API 호출은 가능합니다. 무료로 검색량 조회만 사용할 수 있어요.
B) 키워드 1번 조회에 얼마나 걸리나요?
자동완성 + 연관키워드 + 검색량까지 → 평균 10~30초입니다. 한 번 조회에 키워드 100~1000개 정도가 나옵니다.
C) "401 Unauthorized" 또는 "권한 없음" 에러가 나요
API 키 또는 SECRET_KEY가 잘못 입력된 경우입니다.
✅ 앞뒤 공백 없는지 확인
✅ SECRET_KEY 끝의 ==까지 빠짐없이 복사했는지 확인
✅ 위 "🔑 API 키 발급법"의 검색광고 사이트에서 키 재확인
✅ 그래도 안 되면 검색광고 사이트에서 비밀키 「재발급」 후 다시 입력
D) "프록시 오류" 또는 "네트워크 오류"가 나요
Cloudflare Worker URL이 잘못됐거나, 워커 코드가 다른 코드로 되어 있는 경우입니다.
✅ Worker URL 입력 시 https:// 없이 xxx.workers.dev 형태로 입력 (자동으로 https 붙음)
✅ 위 "🌐 워커 만드는 법"의 코드와 본인 워커 코드가 동일한지 확인
✅ Cloudflare 대시보드에서 워커가 "Deployed" 상태인지 확인
E) 검색량이 "< 10" 으로 표시돼요
네이버 API가 월 검색량 10회 미만은 정확한 숫자를 공개하지 않아 "< 10" 으로 반환합니다. 엑셀에는 "10 미만"으로 저장됩니다.
F) 자동완성과 연관키워드의 차이가 뭐예요?
자동완성: 네이버 검색창에 입력 중 뜨는 추천어. 트렌드 반영이 빠르고 신선한 키워드 많음.
연관키워드 (검색광고 API): 검색량/클릭 데이터 기반의 통계적 연관성. 광고 데이터 풍부.
👉 두 가지를 합치면 광고 데이터 + 신선한 트렌드 키워드를 모두 얻을 수 있습니다.
G) 내 API 키가 다른 사람에게 노출되나요?
아니요. 입력하신 API 키는 본인 브라우저의 localStorage에만 저장됩니다. 서버나 외부로 전송되지 않습니다. Worker는 서명된 요청만 전달할 뿐 키 자체는 거치지 않습니다.
H) 결과가 너무 많아요. 일부만 보고 싶어요
결과 표의 헤더(예: "월 모바일")를 클릭하면 정렬됩니다. 또한 엑셀 다운로드 후 엑셀의 필터 기능으로 검색량 100 이상만 보기 등 자유롭게 필터링하세요.
I) 하루에 몇 번까지 조회 가능한가요?
검색광고 API: 분당 약 60회, 일 제한은 매우 큼 (실사용 부담 없음).
Cloudflare Worker 무료: 하루 100,000 요청.
일반 사용에서 한도 걸릴 일은 거의 없습니다.

⚙️ 설정 (한 번 입력 → 자동 저장)

🔎 키워드 조회

준비 중...
📊 조회 결과
# 키워드 월 PC ▼ 월 모바일 ▼ 월 합계 ▼ 경쟁 광고노출 출처