--- title: "blog-seo" description: "네이버 SearchAd API로 블로그 SEO용 블루키워드를 발굴하는 스킬입니다. \"블루키워드 찾아줘\", \"경쟁 적은 키워드 분석해줘\", \"블로그 키워드 포화지수 확인해줘\"처럼 말하면 됩니다. 포화지수·KEI 계산과 S~D 등급 분류를 제공합니다." pack: itda-doc slug: blog-seo status: active tags: ["SEO", "KEI", "blue keyword", "keyword analysis", "naver", "blog seo", "saturation index"] --- 네이버 검색광고 API로 블로그 글감이 될 블루키워드를 발굴하는 스킬입니다. **아래처럼 `/blog-seo` 뒤에 키워드를 붙여 입력하면 됩니다** — 자연어로 말해도 동작합니다. 포화지수·KEI·등급(S~D)이 담긴 리포트를 돌려줍니다. --- ## 처음 설정하기 키워드 분석에는 네이버 API 키 두 종류(5개 값)가 필요합니다. 각각 한 번만 발급하면 이후에는 자동으로 사용됩니다. 발급받은 키는 **`.env` 파일에 넣습니다 (권장)** — 작업 폴더(Cowork 연결 폴더 / Claude Code 프로젝트 루트)(연결한 폴더가 여러 개면 아무 폴더나) 루트에 `.env` 파일을 만들고 아래 5줄을 넣어 두면 스킬이 자동으로 찾아 읽습니다. 점(`.`)으로 시작하는 파일을 만들기 어렵다면 **`환경변수.txt`** 라는 이름으로 만들어도 똑같이 읽힙니다(메모장이 `.txt` 를 붙여 `.env.txt` 가 되어도 됩니다). ```dotenv NAVER_SEARCHAD_ACCESS_KEY=검색광고_API키 NAVER_SEARCHAD_SECRET_KEY=검색광고_시크릿키 NAVER_SEARCHAD_CUSTOMER_ID=광고주_고객ID NAVER_CLIENT_ID=네이버앱_클라이언트ID NAVER_CLIENT_SECRET=네이버앱_클라이언트시크릿 ``` Claude Desktop의 "Claude 지침"(설정 → 일반)에 같은 내용을 적는 방식도 동작하지만, 대화 컨텍스트에 값이 노출되므로 `.env` 파일을 권장합니다. > 개발자라면 셸 환경변수로 넣어도 됩니다. 서비스 이름을 누르면 발급 페이지가 열립니다. 상세 절차는 아래 1·2번을 참고하세요. :::cards - [네이버 검색광고](https://manage.searchad.naver.com) — 광고주 계정 필요 (아래 1번 절차) → `NAVER_SEARCHAD_ACCESS_KEY` · `NAVER_SEARCHAD_SECRET_KEY` · `NAVER_SEARCHAD_CUSTOMER_ID` - [네이버 오픈 API](https://developers.naver.com) — 일반 네이버 계정으로 발급 (아래 2번 절차) → `NAVER_CLIENT_ID` · `NAVER_CLIENT_SECRET` ::: ### 1. 네이버 검색광고 API (3개 키) > 광고주 계정이 있어야 발급됩니다. 1. [ads.naver.com](https://ads.naver.com) 접속 후 광고주 가입 2. [manage.searchad.naver.com](https://manage.searchad.naver.com) 로그인 3. 상단 **도구 → API 사용 관리**에서 Access License(`NAVER_SEARCHAD_ACCESS_KEY`)와 Secret Key(`NAVER_SEARCHAD_SECRET_KEY`) 복사 4. 같은 페이지 URL의 숫자(`/customers/숫자/`)가 `NAVER_SEARCHAD_CUSTOMER_ID` ### 2. 네이버 오픈 API (2개 키) > 일반 네이버 계정으로 발급 가능합니다. 1. [developers.naver.com](https://developers.naver.com) 로그인 2. **Application → 애플리케이션 등록** 클릭 3. 사용 API에서 **검색** + **데이터랩(검색어트렌드)** 체크 ("데이터랩(쇼핑인사이트)"는 불필요) 4. **WEB 설정 → Callback URL**에 `https://example.com` 입력 후 등록 5. 등록 후 Client ID와 Client Secret 복사 > **⚠️ 신규 발급 안내 (2026-07-31부터)**: 네이버가 이 API들을 네이버클라우드의 **NAVER API HUB**로 옮기고 있어요. 2026-07-30까지는 위 절차대로 발급되지만, 그 이후에 새로 발급하려면 NAVER API HUB에서 신청해야 합니다. 이미 발급받은 키는 2027-06-30까지 그대로 쓸 수 있습니다. > 더 자세한 절차·주의사항(한도, 흔한 인증 오류 등)은 [네이버 오픈API](https://itda.work/credentials/naver-openapi/) · [네이버 검색광고](https://itda.work/credentials/naver-searchad/) 발급 가이드를 참고하세요. --- ## 빠른 시작 ``` /blog-seo 파이썬 독학 블루키워드 찾아줘 ``` ``` /blog-seo 경쟁 적은 키워드 분석해줘 ``` ``` /blog-seo 블로그 키워드 포화지수 확인해줘 ``` --- ## 활용 시나리오 ### 블로그 주제 추천 시드 키워드 몇 개로 관련 키워드를 확장해 글감을 추려냅니다. ``` /blog-seo "파이썬 독학"으로 쓸 만한 블로그 주제 추천해줘 ``` ### 블루키워드만 골라서 보기 경쟁이 적고 검색량이 보장된 키워드만 보고 싶을 때는 "A등급 이상만"처럼 등급을 말해주세요. ``` /blog-seo 파이썬 관련 블루키워드(A등급 이상)만 골라줘 ``` 등급 기준은 아래와 같습니다. | 등급 | 포화지수 | 레이블 | |------|---------|--------| | S | 10% 미만 | 블루키워드 | | A | 10~20% | 유망 키워드 | | B | 20~40% | 기회 있음 | | C | 40~60% | 경쟁 치열 | | D | 60% 초과 | 레드키워드 | ### 트렌드 분석 포함 최근 트렌드(계절성·상승세)를 함께 보고 싶을 때 "트렌드도 같이"라고 말하세요. ``` /blog-seo 파이썬 독학 키워드의 최근 트렌드까지 확인해줘 ``` > ⚠️ 트렌드 조회는 키워드 1개당 데이터랩 API 1회를 소모합니다. 하루 1,000회 한도가 있으므로 필터링된 키워드에만 사용하세요. ### 결과를 CSV로 받기 엑셀이나 구글 시트에 붙여넣고 싶을 때는 "CSV 파일로 저장해줘"라고 말하세요. ``` /blog-seo 파이썬 키워드 분석 결과 CSV 파일로 저장해줘 ``` --- ## 팁 - **두 단계 실행 패턴**: 먼저 트렌드 없이 넓게 탐색해 유망 키워드를 추리고, 그 결과에만 "트렌드도 봐줘"로 재실행하세요. 데이터랩 한도를 크게 절약합니다. - **시드 키워드는 최대 5개**: 한 번에 5개 이상의 키워드를 넣으면 잘리거나 오류가 납니다. 쉼표로 구분해 5개 이하로 요청하세요. - **캐시 활용**: 같은 작업 폴더에서 1시간 이내 동일 키워드를 다시 조회하면 블로그 문서수 API를 다시 호출하지 않아 빠르게 결과가 나옵니다. - ⚠️ **API 키 5개 모두 필요**: 검색광고 API 3개와 오픈 API 2개가 모두 설정돼 있어야 지표 계산이 가능합니다. 하나라도 없으면 실행되지 않습니다. - ⚠️ **트렌드 남용 주의**: 시드 키워드가 많은데 트렌드까지 요청하면 하루 1,000회 한도가 한 번에 소진될 수 있습니다. 1차 필터링 후에만 사용하세요.