API 키 및 커넥터 연결 방법

• 크롬 계열 브라우저 — 크롬, 엣지, 웨일, 브레이브. (Safari, Firefox는 지원하지 않습니다)
• 네이버 검색광고 계정 — 월간 검색량·경쟁도 조회에 필요. 광고를 집행하지 않아도 계정만 있으면 됩니다.
• 네이버 클라우드 계정(NAVER API HUB, 선택) — 검색 추이·사입 타이밍 예측에 필요. 검색광고 키만으로 먼저 시작하고 나중에 추가해도 됩니다. 개발자센터에서 예전에 받은 데이터랩 키가 있으면 그것도 쓸 수 있습니다.
• 생성형 AI API 키(선택, 맥스 플랜) — Claude·OpenAI(GPT)·Gemini 중 하나. 맥스 플랜에서 월 AI 한도를 다 쓴 뒤에도 AI 수입 체크를 이어서 쓰고 싶을 때만 필요합니다. 다른 플랜은 AI 키 없이 팔릴까 AI로 씁니다.

전체 과정은 처음 한 번만 하면 되고, 보통 10~15분 걸립니다.

커넥터는 크롬 확장 프로그램입니다. 설치하면 사이트 오른쪽 위 배지가 커넥터 미설치에서 API 키 설정 필요로 바뀝니다.

1. 크롬 주소창에 chrome://extensions 입력 → 오른쪽 위 개발자 모드를 켭니다.
2. 압축해제된 확장 프로그램을 로드합니다 클릭 → 전달받은 커넥터 폴더(extension/dist)를 선택합니다.
3. 설치 후 팔릴까 페이지를 새로고침하면 배지가 바뀝니다.

키워드별 월간 검색량, 클릭수, 경쟁도, 연관 키워드를 가져오는 데 씁니다. CUSTOMER_ID, 액세스라이선스, 비밀키 세 가지 값이 필요합니다.

1. searchad.naver.com에 로그인하고 광고시스템으로 들어갑니다.
2. 오른쪽 위 도구 메뉴 → API 사용 관리를 엽니다.
3. API 라이선스 발급(또는 신청) 버튼을 누릅니다. 발급되면 화면에 액세스라이선스와 비밀키가 표시됩니다.
4. 같은 화면(또는 오른쪽 위 계정 정보)에 있는 CUSTOMER_ID(숫자)를 함께 복사합니다.

검색어 트렌드(기간별 검색량 추이)와 쇼핑인사이트(쇼핑 분야·키워드별 클릭 추이)를 가져오는 데 씁니다. 네이버는 2026년 7월 31일부터 데이터랩 API 신규 발급을 NAVER API HUB(네이버 클라우드)로 옮겼습니다.

A. NAVER API HUB (ncloud.com)

1. ncloud.com에 네이버 클라우드 계정으로 로그인 → 콘솔로 들어갑니다.
2. Services에서 NAVER API HUB를 찾아 왼쪽 Subscription에서 이용 신청합니다.
3. Application 등록 → 이름 입력(예: 팔릴까) → 사용할 API에서 검색어 트렌드와 쇼핑 인사이트를 선택하고 등록합니다.
4. 등록한 Application의 인증 정보에서 Client ID와 Client Secret을 복사합니다.

B. 네이버 개발자센터 — 기존 키가 있는 경우

예전에 developers.naver.com에서 데이터랩을 추가한 애플리케이션이 있다면, 그 Client ID와 Client Secret을 2027년 6월 30일까지 그대로 쓸 수 있습니다. 새 애플리케이션 등록은 더 이상 받지 않습니다.

1. 브라우저 오른쪽 위 확장 프로그램(퍼즐 모양) 아이콘 → 팔릴까 커넥터를 클릭하면 설정 페이지가 열립니다. (이 페이지 위 ‘내 연결 상태’의 커넥터 설정 열기로도 열립니다)
2. 네이버 검색광고 API 칸에 CUSTOMER_ID, 액세스라이선스, 비밀키를 붙여넣고 연결 테스트를 누릅니다. ‘연결 성공’이 보이면 됩니다.
3. 네이버 데이터랩 API 칸에서 발급처(NAVER API HUB / 개발자센터 기존 키)를 고르고 Client ID, Client Secret을 붙여넣은 뒤 연결 테스트를 누릅니다.
4. (선택 · 맥스 플랜) 생성형 AI API 키 칸에서 Claude·OpenAI(GPT)·Gemini 중 하나를 고르고 키를 넣습니다. 자세한 방법은 5단계를 보세요.
5. 맨 아래 저장을 누릅니다. 팔릴까로 돌아오면 배지가 커넥터 연결됨으로 바뀝니다.

이제 키워드 분석에서 조회할 수 있습니다.

AI 수입 체크와 프로 도구는 모든 플랜에서 AI 키 없이 팔릴까 AI로 요금제별 월 한도만큼 씁니다. 맥스 플랜은 여기에 더해 Claude · OpenAI(GPT) · Gemini 중 원하는 AI의 API 키를 커넥터에 넣어 두면, 월 한도를 다 쓴 뒤에도 AI 수입 체크를 내 키로 이어서 분석할 수 있습니다. 네이버 키와 마찬가지로 키는 커넥터 안에만 저장되고, AI 호출도 회원님 브라우저에서 그 회사로 바로 갑니다. AI에는 상품 키워드만 보냅니다. 무료·베이직·프로 플랜은 이 단계를 건너뛰어도 됩니다.

키 발급 (고른 회사 하나만)

• Claude — console.anthropic.com 가입 → Billing에서 크레딧 충전 → API Keys에서 키 생성 (sk-ant-로 시작)
• OpenAI (GPT) — platform.openai.com 가입 → Billing에서 크레딧 충전 → API keys에서 키 생성 (sk-로 시작)
• Gemini — aistudio.google.com에서 Google 계정으로 로그인 → Get API key (AIza로 시작). 사용량에 따라 Google Cloud 결제 설정이 필요할 수 있습니다.

어느 회사든 콘솔에서 월 사용 한도를 걸어 두면 예상보다 많이 쓰일 걱정이 없습니다.

커넥터에 넣기

1. 커넥터 설정 페이지의 생성형 AI API 키 칸에서 회사(Claude / OpenAI (GPT) / Gemini)를 고릅니다.
2. API 키를 붙여넣고 연결 테스트를 누르면, 그 키로 쓸 수 있는 모델 목록이 나오고 추천 모델이 선택됩니다.
3. 원하면 다른 모델을 고른 뒤 저장을 누릅니다. 가벼운 모델일수록 저렴하고 빠르며, 큰 모델일수록 판단이 꼼꼼합니다.

맥스 플랜에서 이번 달 한도를 다 쓰면 AI 수입 체크에 내 OpenAI 키로 이어서 분석처럼 고른 AI로 계속하는 버튼이 나타납니다. 요금제는 요금제 페이지에서 비교할 수 있습니다.

Q. 배지가 계속 '커넥터 미설치'로 나와요

설치 후 페이지를 새로고침했는지 확인하세요. Safari·Firefox에서는 동작하지 않습니다. 확장 프로그램 관리 화면에서 팔릴까 커넥터가 사용 중인지도 확인하세요.

Q. 'API 키 설정 필요'가 사라지지 않아요

설정 페이지에서 입력만 하고 저장을 누르지 않은 경우가 많습니다. 저장 후 팔릴까 페이지로 돌아오면 자동으로 다시 확인합니다.

Q. 검색광고 연결 테스트가 실패해요

세 값을 복사할 때 앞뒤 공백이 들어가지 않았는지, CUSTOMER_ID가 숫자만인지 확인하세요. 비밀키를 재발급했다면 새 값으로 다시 저장해야 합니다.

Q. 데이터랩에서 'subscription to the API is required'가 나와요

커넥터 설정에서 발급처가 키를 받은 곳과 맞는지 확인하세요(NAVER API HUB 키는 반드시 NAVER API HUB 선택). 그래도 같으면 API HUB의 Application에 검색어 트렌드·쇼핑 인사이트가 선택되어 있는지 3-A의 3번을 확인하세요.

Q. 데이터랩에서 '인증에 실패했습니다'가 나와요

발급처를 반대로 고른 경우가 가장 많습니다. 또 NAVER API HUB에서는 계정 인증키(ncp_iam_…)가 아닌 Application의 Client ID / Client Secret을 넣어야 합니다.

Q. 생성형 AI 연결 테스트가 실패해요

고른 회사와 키가 맞는지(Claude 키로 OpenAI를 고르지 않았는지), 키 앞뒤에 공백 없이 전체 값을 넣었는지 확인하세요. 연결은 되는데 AI 수입 체크가 실패하면 그 회사 콘솔에서 크레딧이 남아 있는지, 월 사용 한도에 걸리지 않았는지, 고른 모델을 쓸 수 있는 계정인지 확인하세요.

Q. 데이터랩 조회가 갑자기 안 돼요

개발자센터 기존 키는 애플리케이션당 하루 호출 한도(약 1,000회)가 있어 다음 날 다시 시도해야 합니다. NAVER API HUB는 사용량 기반 과금이라, 네이버 클라우드 콘솔에서 사용량과 한도 설정을 확인하세요.

• 키는 회원님 브라우저의 확장 프로그램 저장소에만 저장됩니다. 팔릴까 서버에는 키가 전달되지 않고, 조회 결과만 페이지에 표시됩니다.
• 설정 페이지에서 값을 지우고 저장하거나, 확장 프로그램을 제거하면 키도 함께 삭제됩니다.
• 다른 PC나 브라우저에서 쓰려면 그곳에서 커넥터를 설치하고 키를 다시 입력해야 합니다.