1-1. Claude Code 설치 · API 키 발급
분석을 시작하려면 두 가지가 필요해요. 도구(Claude Code)와 데이터 접근권(API 키). 둘 다 하루면 끝나요. 한 번 세팅하면 다음 주제에도 그대로 씁니다.
1. 일반 원칙 — 환경은 한 번만
분석마다 환경을 새로 만들면 비효율적이에요. 한 번 세팅한 뒤 다음 주제로도 재사용하는 게 원칙. 그래서 처음에 약간 손이 가더라도 다음 주제부턴 "데이터 받아줘" 한 줄로 시작할 수 있어요.
2. Claude Code 설치
터미널에 공식 설치 명령 한 줄이면 돼요. 이 방식은 Node.js가 필요 없고, 설치한 뒤에는 알아서 최신 버전으로 업데이트됩니다. 내 컴퓨터에 맞는 줄 하나만 실행하세요.
# macOS · Linux · WSL
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell (프롬프트가 PS C:\ 로 시작)
irm https://claude.ai/install.ps1 | iex
# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
# 설치 확인 — 새 터미널 창을 열고
claude --version
# 작업 폴더 만들고 진입
mkdir my-analysis && cd my-analysis
# 시작
claude
처음 실행하면 Claude 계정 로그인을 요청해요. 브라우저 인증 한 번이면 끝. 무료 플랜에서는 Claude Code를 쓸 수 없어서 Pro 이상 구독이 필요합니다.
※ claude를 못 찾는다고 나오면 터미널을 완전히 닫았다가 다시 여세요. 그래도 안 되면 claude doctor로 점검합니다. Homebrew(brew install --cask claude-code)나 WinGet(winget install Anthropic.ClaudeCode)으로도 설치할 수 있고, 예전 방식인 npm 설치는 Node.js 22 이상이 필요합니다. 출처: Claude Code 공식 설치 문서
3. API 키 — 데이터 접근의 열쇠
공공·민간 데이터는 대부분 API로 받아요. 그러려면 발급받은 키가 필요. 이번 강의에서 쓸 핵심 3곳:
data.go.kr (공공데이터포털)
한국관광 데이터랩 · 코레일 등 정부 API의 관문. 키 1개로 여러 서비스 활용 신청.
NAVER API HUB
네이버 데이터랩 검색어 트렌드 + 블로그 검색. NCP 계정으로 신청, Client ID/Secret 한 쌍 발급.
(옵션) Apify
인스타·웹 스크래핑이 필요할 때. 무료 $5 크레딧.
4. data.go.kr 한국관광 데이터랩 신청
- data.go.kr 회원가입 / 로그인
- "한국관광공사 빅데이터 지역별 방문자수" 검색 → 활용신청
- 마이페이지에서 일반 인증키(Decoding) 복사 — 디코딩 키여야 함(인코딩 X)
- 같은 키로 코레일 카리지 통계도 활용신청해두면 좋아요
★ 주의. 한국 공공 API는 발급 직후 1~2시간 키 전파 지연이 있어요. 처음 호출에 403이 떠도 잠시 후 다시 시도.
공공데이터포털 API 호출 예시
아래 예시는 발급받은 일반 인증키로 지역별 방문자수 데이터를 조회하는 방법입니다. 내_인증키 자리에 본인 키를 넣으세요. 주소창에 직접 붙여 넣는 curl에서는 Encoding 키를, 파이썬 코드(.env)에서는 Decoding 키를 씁니다. (깨짐 방지를 위해 URL을 따옴표로 감싸 호출합니다)
curl -s "https://apis.data.go.kr/B551011/DataLabService/metcoRegnVisitrDDList?serviceKey=내_인증키&numOfRows=10&pageNo=1&MobileOS=ETC&MobileApp=AppTest&startYmd=20210513&endYmd=20210513"
응답 예시 (XML):
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response>
<header>
<resultCode>0000</resultCode>
<resultMsg>OK</resultMsg>
</header>
<body>
<items>
<item>
<areaCode>11</areaCode>
<areaNm>서울특별시</areaNm>
<daywkDivCd>4</daywkDivCd>
<daywkDivNm>목요일</daywkDivNm>
<touDivCd>1</touDivCd>
<touDivNm>현지인(a)</touDivNm>
<touNum>4828435.5</touNum>
<baseYmd>20210513</baseYmd>
</item>
</items>
<numOfRows>10</numOfRows>
<pageNo>1</pageNo>
<totalCount>51</totalCount>
</body>
</response>
5. NAVER API HUB — 검색·데이터랩 API 신청
네이버 개발자 센터(developers.naver.com)는 2026년 7월 31일부터 검색 · 검색어 트렌드 API의 신규 신청을 막았고, 기존 키도 2027년 6월 30일에 끝나요. 이제 네이버 클라우드 플랫폼(NCP) 계정으로 NAVER API HUB에서 신청합니다.
- NAVER API HUB 소개 페이지에서 [회원가입] → NCP 계정 생성(네이버 아이디로도 가입 가능)
- 콘솔 로그인 후 Menu → All Services → Application Services → NAVER API HUB 이동
- 좌측 Application 메뉴 → Application Management 화면에서 [등록] 클릭
- 사용 API에 '검색' + '데이터랩(검색어 트렌드)' 둘 다 체크 → 애플리케이션 이름 입력 → 완료
- 등록한 Application 선택 → [인증 정보]에서 Client ID · Client Secret 복사
★ 주의. 인증 헤더 이름이 바뀌었습니다 — 예전
X-Naver-Client-Id/X-Naver-Client-Secret대신X-NCP-APIGW-API-KEY-ID/X-NCP-APIGW-API-KEY를 씁니다. 엔드포인트 도메인도openapi.naver.com에서naverapihub.apigw.ntruss.com로 바뀌었어요. 아래 7번 예시가 새 방식입니다.
6. .env 파일 — 키 보관의 정석
키를 코드에 직접 넣으면 깃에 올릴 때 사고 나요. .env 파일에 모으고 코드에선 환경변수로 읽기가 원칙.
# 프로젝트 루트에 .env (gitignore에 추가!)
TOUR_API_KEY=발급받은_디코딩_키
NAVER_ID=클라이언트_ID
NAVER_SECRET=시크릿
APIFY_TOKEN=옵션
실행할 땐 한 줄:
set -a; source .env; set +a
# 이제 환경변수로 사용 가능
7. 첫 자연어 명령 — 확인
모든 게 잘 되었나 확인할 한 줄. Claude Code에서:
".env 파일이 잘 읽히나? 네이버 데이터랩 API로 '서울' 키워드 최근 한 달 검색 받아봐."
NAVER API HUB 검색어 트렌드 API 사용법
아래 예시는 NAVER API HUB 검색어 트렌드 API 를 활용하는 방법을 보여줍니다.
curl -s -X POST "https://naverapihub.apigw.ntruss.com/search-trend/v1/search" \
-H "X-NCP-APIGW-API-KEY-ID: YOUR_CLIENT_ID" \
-H "X-NCP-APIGW-API-KEY: YOUR_CLIENT_SECRET" \
-H "Content-Type: application/json" \
-d '{"startDate":"2026-05-01","endDate":"2026-05-31","timeUnit":"week","keywordGroups":[{"groupName":"서울","keywords":["서울"]}]}'
응답 예시:
{
"startDate": "2026-04-27",
"endDate": "2026-05-31",
"timeUnit": "week",
"results": [
{
"title": "서울",
"keywords": [
"서울"
],
"data": [
{
"period": "2026-04-27",
"ratio": 84.85883
},
{
"period": "2026-05-04",
"ratio": 71.07901
},
{
"period": "2026-05-11",
"ratio": 75.6752
},
{
"period": "2026-05-18",
"ratio": 78.27971
},
{
"period": "2026-05-25",
"ratio": 100
}
]
}
]
}
월별 숫자가 나오면 환경 세팅 완료. 안 되면 키 전파(2시간)·헤더(User-Agent) 누락을 의심.