🛠️ 사전 준비

자료실 & 사전 준비

원활한 라이브 워크숍 진행을 위해 강의 시작 전 본인 컴퓨터에 반드시 설치 및 가입해 두어야 하는 환경 설정 자료들입니다.

필수 설치 및 가입

강의 수강에 반드시 필요한 프로그램과 개발자 플랫폼 계정입니다.

공통 · macOS / Windows

핵심 API 및 데이터 서비스 계정

실제 데이터 수집 및 데이터베이스 저장을 위한 발급처 및 서비스 계정 목록입니다. (사전 가입 권장)

공공데이터포털 (data.go.kr) 회원가입
한국관광 데이터랩(지역별 방문자수 등)과 기상청 통계 등 정부 공공 API를 활용하기 위해 회원가입이 필요합니다.
가입하러 가기 →
한국관광 데이터랩 (datalab.visitkorea.or.kr) 회원가입
지역별 방문자·체류·숙박 데이터를 웹에서 CSV로 바로 다운로드할 수 있는 한국관광공사 서비스입니다. 모듈 2 전처리 실습(동해시 방문자 데이터)에서 사용합니다.
가입하러 가기 →
NAVER API HUB (ncloud.com) 신청
네이버 데이터랩 검색어 트렌드 API와 블로그 검색 API를 쓰려면 여기서 신청합니다. 네이버 개발자 센터(developers.naver.com)는 2026년 7월 31일부터 이 API들의 신규 신청을 막았어요 — 이제 네이버 클라우드 플랫폼(NCP) 계정으로 신청하고 Client ID/Secret을 발급받습니다.
신청하러 가기 →
서울 열린데이터광장 (data.seoul.go.kr) 회원가입
서울시 공공자전거 대여이력(따릉이 데이터) 등 서울시 특화 공공 데이터를 수집하기 위해 회원가입 및 API 인증키 발급이 필요합니다.
가입하러 가기 →
Apify (apify.com) 회원가입
인스타그램 해시태그나 웹 페이지의 데이터를 직접 스크래핑(Scraping)할 때 활용하는 클라우드 스크래퍼 서비스입니다. 무료 크레딧($5) 범위 내에서 실습합니다.
가입하러 가기 →
Supabase (supabase.com) 회원가입
분석한 정형 데이터나 가공된 결과를 저장하고 다루기 위한 클라우드 PostgreSQL 데이터베이스 서비스입니다. GitHub 계정으로 간편히 가입할 수 있어요. 무료 플랜은 실습용으로 충분하지만 프로젝트 2개, DB 500MB, 1주일 안 쓰면 일시정지 같은 제한이 있습니다.
가입하러 가기 →
Google Cloud Platform (GCP) 가입 및 프로젝트 생성
Gmail, Google Sheets, Google Drive, YouTube Data API 등 Google 서비스 연동 및 데이터 수집·자동화를 위해 계정 생성과 프로젝트 설정이 필요합니다.
가입하러 가기 →

강의 스킬 · CLAUDE.md 자료

강의에서 함께 쓰는 클로드 스킬 5종 — 분석 4단계 스킬(① 가설 · ② 수집 · ③ 의심 · ④ 정리)과 이 넷을 순서대로 굴리는 파이프라인 스킬 — 을 플러그인 하나로 묶어 배포했습니다(현재 v2.0.0). Claude Code에서 아래 두 줄이면 설치가 끝납니다.

추천 · 플러그인 설치

데이터팝콘 분석 플러그인 — 두 줄이면 끝

/plugin marketplace add team-datapopcorn/datapopcorn-analysis-plugin
/plugin install datapopcorn-analysis@datapopcorn
설치하면 /datapopcorn-analysis:2-collect처럼 이름으로 직접 부를 수도 있고, "CSV 전처리해줘"라고 말해도 알아서 꺼내 씁니다. "분석해줘"라고만 하면 data-analysis-pipeline이 ①부터 순서대로 굴려요.
예전 버전을 설치했다면 /plugin marketplace update datapopcorn으로 업데이트하세요. v2.0.0부터 이름이 바뀌었습니다 — work-analysis → 1-hypothesis, data-preprocess → 2-collect, popcorn-report → 4-report, 3-suspect는 새로 생겼어요. "전처리해줘", "popcorn-report 스타일로"처럼 부르던 말은 그대로 통합니다.
스킬 각각이 뭘 하는지는 모듈 2에서, 플러그인이 어떻게 만들어지는지는 6-1에서 다룹니다.
소스: github.com/team-datapopcorn/datapopcorn-analysis-plugin

스킬 하나만 열어보거나 CLAUDE.md 예시만 따로 복사하고 싶다면, 원문을 그대로 볼 수 있습니다. 전부 마크다운 텍스트 파일이라 — 원문을 열어 복사하면 그대로 여러분 것이 됩니다.

1-hypothesis — ① 가설 스킬
무엇을 분석할지 정해지지 않았을 때. 목표를 인터뷰해서 검증 가능한 가설 · 핵심/방어 지표 · 판정 기준을 hypothesis.md로 남깁니다. (예전 이름 work-analysis)
원문 보기 →
2-collect — ② 수집 스킬
데이터를 확보하고 인코딩 · 타입 · 결측 · 중복을 정리해 data/clean/과 preprocessing_report.html을 남깁니다. (예전 이름 data-preprocess)
원문 보기 →
3-suspect — ③ 의심 스킬 (v2.0.0 신규)
결론 내기 전에 데이터를 의심하는 단계. EDA + 함정 10개(공통 5 · 검증 5) 판정으로 eda_report.html과 traps_check.md를 남깁니다.
원문 보기 →
4-report — ④ 정리 스킬
분석 결과를 한 장짜리 매거진 톤 HTML 리포트로 만드는 데이터팝콘 표준 디자인. 헤드라인 · KPI · 인사이트 박스 · 액션 카드. (예전 이름 popcorn-report)
원문 보기 →
data-analysis-pipeline — 4단계 오케스트레이터
①~④를 순서대로 굴리고 진행 상황을 관리합니다. 단계마다 파일이 남아서 중간에 끊겨도 "어디까지 했지" · "다음 단계"로 이어 돌릴 수 있어요.
원문 보기 →
data-preprocess — 4-3 실습용 전처리 스킬 (직접 만드는 예시)
raw CSV를 다듬고 preprocessing_report.html을 남기는 5줄 규칙. 4-3에서 내 손으로 스킬을 만들어 보는 연습용 예시입니다. 플러그인의 2-collect가 이걸 확장한 버전이에요.
원문 보기 →
CLAUDE.md 예시 — 분석 프로젝트 규칙 파일
5-3 실습에서 작성하는 프로젝트 규칙 파일 예시. 복사해서 프로젝트 폴더 맨 위에 CLAUDE.md로 저장하면 모든 세션에 자동 적용됩니다. 내 업무 기준으로 규칙을 고쳐 쓰는 게 핵심.
원문 보기 →

실습 데이터

모듈 2·4 실습에서 쓰는 데이터입니다. 데이터랩 가입·다운로드가 늦어지면 여기 파일로 바로 따라오세요.

스킬 설치 방법

내 프로젝트에 넣는 방법 — 플러그인 vs 낱개

🔌 방법 1 — 플러그인 설치 (추천)
5종을 한 번에 받는 방법입니다. Claude Code에서:
/plugin marketplace add team-datapopcorn/datapopcorn-analysis-plugin
/plugin install datapopcorn-analysis@datapopcorn
두 줄이면 ① 가설 · ② 수집 · ③ 의심 · ④ 정리 스킬과 파이프라인 스킬이 한 번에 들어옵니다. 이미 설치했다면 /plugin marketplace update datapopcorn으로 최신 버전을 받으세요.
📋 방법 2 — 낱개로 복사해 넣기
스킬 하나만 필요하거나 내용을 고쳐 쓰고 싶을 때 씁니다.
1. 위 카드에서 원문을 열고 전체 복사합니다 (Ctrl/Cmd+A → C).
2. 프로젝트 폴더에 .claude/skills/스킬-이름/SKILL.md 파일을 만들어 붙여넣고 저장합니다.
3. Claude Code에서 "어떤 스킬을 쓸 수 있어?"라고 물어 목록에 나오면 끝 — 저장하면 재시작 없이 바로 적용됩니다.
※ 스킬이 뭔지부터 보려면 4-1 스킬이 뭔지 · 플러그인 구조는 6-1 플러그인 · 공식 문서: Claude를 skills로 확장하기
윈도우 & 맥 공통

Git (깃) OS별 상세 설치 방법

에이전트의 변경 사항 기록 및 연동을 위해 컴퓨터에 Git이 반드시 설치되어 있어야 합니다.

🖥️ Windows (윈도우) 환경 설치 방법
1. Git 공식 홈페이지에서 Windows용 설치 파일(64-bit Git for Windows Setup)을 다운로드하여 실행합니다.
2. 설치 과정 중 나타나는 설정 창에서는 기본 옵션을 모두 유지한 채 Next를 누르면 됩니다.
3. (권장) AI 에이전트 및 CLI 환경을 쾌적하게 활용하기 위해, 설치 후 윈도우 검색창에서 Git Bash를 열어 명령어를 입력하는 환경을 주로 활용하게 됩니다. Git for Windows가 있으면 Claude Code도 Git Bash로 명령을 실행하고, 없으면 PowerShell로 돌아갑니다.
🍏 macOS (맥) 환경 설치 방법
1. 화면 우상단 돋보기(Spotlight)를 클릭해 터미널(Terminal) 앱을 검색하여 실행합니다.
2. 터미널 창에 git --version을 입력하고 Enter를 누릅니다.
3. Git이 아직 설치되어 있지 않다면, macOS 시스템에서 "Xcode 명령줄 도구(Command Line Tools)를 설치하시겠습니까?"라는 팝업 알림이 뜹니다. [설치] 버튼을 눌러 진행하면 자동으로 완료됩니다.
4. (대안) 이미 개발용 패키지 관리자인 Homebrew를 사용 중이라면, 터미널에 brew install git을 실행해 간편히 설치할 수도 있습니다.
API 키 준비 팁

공공데이터포털 신청 팁

🔑 공공데이터포털 활용신청 팁
- 회원가입 후 "한국관광공사 빅데이터 지역별 방문자수"를 검색하여 [활용신청]을 승인받습니다.
- 마이페이지에서 일반 인증키 (Decoding) 값을 복사하여 보관해 두어야 강의 때 바로 로드할 수 있습니다.
- ⚠️ 발급 후 약 1~2시간의 키 전파 지연이 있을 수 있으니 강의 전에 미리 가입 및 신청을 해두는 것을 강력히 권장합니다.
API 키 발급 · NCP 콘솔

NAVER API HUB — 가입부터 사용까지

네이버 개발자 센터(developers.naver.com)는 2026년 7월 31일부터 검색 · 검색어 트렌드 API의 신규 신청을 막았고, 기존 키도 2027년 6월 30일에 끝납니다. 이제 네이버 클라우드 플랫폼(NCP) 계정으로 NAVER API HUB에서 신청합니다.

1️⃣ NCP 계정 가입
- NAVER API HUB 소개 페이지에서 [회원가입]으로 네이버 클라우드 플랫폼(NCP) 계정을 만듭니다 — 네이버 아이디로도 가입할 수 있습니다.
- 콘솔 로그인 후 우측 상단 [리전 & 플랫폼]은 기본값 그대로 두면 됩니다.
2️⃣ 애플리케이션 등록
- 콘솔 상단 Menu → All Services → Application Services → NAVER API HUB로 이동합니다.
- 왼쪽 Application 메뉴에서 Application Management 화면의 [등록] 버튼을 클릭합니다.
- 사용 API는 '검색'과 '데이터랩(검색어 트렌드)' 두 가지를 모두 체크해야 에이전트가 정상적으로 수집할 수 있습니다.
- 애플리케이션 이름을 입력하고 완료합니다.
3️⃣ Client ID / Secret 발급
- 등록한 Application을 선택하고 [인증 정보] 버튼을 눌러 Client ID와 Client Secret을 각각 복사합니다.
- 두 값을 텍스트 파일이나 .env에 보관해 두면 강의 때 바로 로드할 수 있습니다.
4️⃣ 달라진 점 — 호출 방식
- 인증 헤더 이름이 바뀌었습니다: 예전 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로 바뀌었습니다.
- 실제 호출 예시는 1-1 환경 세팅에서, 공식 문서는 NAVER API HUB 개요에서 확인하세요.
고급 연동 & DB 팁

Supabase & Apify & GCP 연동 팁

🗄️ Supabase 데이터베이스 생성 팁
- 가입 후 [New Project]를 생성할 때 지정하는 Database Password는 절대 잊어버리지 않게 안전한 곳에 기록해 두세요.
- 프로젝트 생성이 완료되면 Project Settings에서 Project URL과 API Keys 화면의 Publishable key(예전 이름 anon key) 값을 복사하여 보관해 둡니다. Secret key(service_role)는 코드나 화면에 노출하지 마세요.
- 무료 플랜은 1주일 동안 쓰지 않으면 프로젝트가 일시정지됩니다. 강의 전날 대시보드에서 한 번 열어 두세요.
🕸️ Apify API 토큰 팁
- 회원가입 후 우측 상단의 프로필 혹은 Settings -> Integrations에서 Personal API Token 값을 복사하여 활용합니다.
- 무료 가입 시 매달 제공되는 $5 상당의 무료 크레딧만으로도 인스타그램이나 네이버 지도 스크래핑 실습에 충분합니다.
☁️ Google Cloud Platform (GCP) API 활성화 팁
- GCP 콘솔에서 [프로젝트 생성]을 완료한 후, API 및 서비스 > 라이브러리에서 필요한 API(예: Google Sheets API, YouTube Data API v3 등)를 각각 검색하여 [사용] 버튼을 눌러 활성화해야 합니다.
- 사용자 인증 정보 메뉴에서 API 키를 생성하거나, 안전한 서버 간 연동을 위해 서비스 계정(Service Account) 키 파일(.json)을 생성해 작업 폴더에 보관하여 로드해 활용합니다.
위 설정을 모두 끝마쳤다면 강의 수강을 위한 기본 준비가 끝났습니다. 강의 첫 시간에는 1-1. 환경 세팅 & API 키 발급 단계부터 셋업을 시작해 나갑니다.