🔌 API 연동 — 외부 데이터 활용 — 클로드 코드 무료 학습

API란?

API는 쉽게 말하면 식당 주문서와 같아요. 식당에 가면 메뉴판을 보고 주문서에 적어서 주방에 전달하잖아요? 그러면 요리사가 음식을 만들어서 내보내죠.

API도 똑같아요. 우리가 “요청”을 보내면, 서버가 “데이터”를 돌려줘요. 예를 들어 “삼성전자 공시 목록 줘”라고 요청하면, 금감원 서버가 공시 데이터를 보내주는 거예요.

식당	API
메뉴판	API 문서 (어떤 요청이 가능한지)
주문서	API 요청 (URL + 파라미터)
주방	서버 (데이터를 처리하는 곳)
음식	응답 데이터 (JSON, HTML 등)
멤버십 카드	API 키 (인증용 열쇠)

핵심은 이거예요 — 다른 사람이 만들어둔 기능을 가져다 쓰는 것. Google이 AI 모델을 만들었으면, 우리는 API로 그 AI를 불러서 쓸 수 있어요. 금감원이 공시 데이터를 정리했으면, API로 그 데이터를 가져올 수 있고요.

API	용도	가격
Gemini	Google AI (텍스트/이미지/영상 생성)	무료 티어 (일 한도 있음)
DART	금감원 공시자료 조회	무료
Naver Search	네이버 검색 결과 수집	무료
공공데이터포털	정부 공공 데이터 (날씨, 교통 등)	무료
한국수출입은행	환율 정보	무료

AI에게 공식 문서 알려주기

API를 쓸 때 가장 중요한 건 공식 문서예요. AI가 아무리 똑똑해도, 공식 문서 없이는 정확한 API 호출 방법을 모를 수 있거든요. 특히 파라미터 이름이나 인증 방식 같은 건 문서를 봐야 정확해요.

AI에게 공식 문서를 알려주는 방법은 4가지가 있어요.

방법 1: 문서를 파일로 저장

Claude Code에 이렇게 말하세요

DART API 공식 문서를 dart-api-docs.md로 저장해줘.
그리고 그 문서를 참고해서 코드를 작성해줘.

Claude Code가 공식 사이트에서 문서를 가져와서 파일로 저장하고, 그 파일을 참고해서 코드를 작성해요. 한번 저장해두면 나중에도 계속 참고할 수 있어서 편해요.

방법 2: URL 직접 전달

Claude Code에 이렇게 말하세요

이 문서를 참고해서 만들어줘:
https://opendart.fss.or.kr/guide/main.do

방법 3: context7 활용

Claude Code에 이렇게 말하세요

use context7
Google Gemini API로 이미지를 생성하는 코드를 만들어줘.

프롬프트에 “use context7”을 넣으면, Claude Code가 최신 라이브러리 문서를 자동으로 찾아서 참고해요. 특히 업데이트가 빈번한 라이브러리에 유용해요.

방법 4: CLAUDE.md에 기록

CLAUDE.md에 추가

## API 정보
- DART API 문서: https://opendart.fss.or.kr/guide/main.do
- Gemini API 문서: https://ai.google.dev/docs
- API 키는 .env 파일에서 읽기

CLAUDE.md에 API 정보를 기록해두면, 매번 설명할 필요 없이 Claude Code가 자동으로 참고해요. 프로젝트에서 자주 쓰는 API가 있다면 꼭 기록해두세요.

왜 공식 문서가 중요한가요?

AI는 학습 데이터를 기반으로 답변하기 때문에, 최신 API 변경사항을 모를 수 있어요. 공식 문서를 함께 전달하면 환각(hallucination) 없이 정확한 코드를 생성할 확률이 크게 높아져요.

API = 레고 블록

블록을 조합할수록 만들 수 있는 것이 무궁무진해져요.

Gemini API로 콘텐츠 생성

Google의 Gemini API는 텍스트, 이미지, 영상을 모두 다룰 수 있는 강력한 AI API예요. 무료 티어가 있어서 개인 프로젝트 수준에서는 충분히 쓸 수 있거든요. 다만 분당 요청 횟수에 제한이 있고, 대량 사용 시에는 유료 전환이 필요해요.

API 키 발급

aistudio.google.com/apikey 접속

Google AI Studio 사이트로 이동

Google 계정으로 로그인

기존 구글 계정 사용

"Create API Key" 클릭

API 키가 바로 생성됨

키를 .env 파일에 저장

코드에 직접 넣지 않기!

.env 파일에 저장

GEMINI_API_KEY=your-api-key-here

텍스트 생성 예시

Claude Code에 이렇게 말하세요

Gemini API를 사용해서
"직장인 바이브코딩" 주제로
60초 쇼츠 대본을 만들어줘.
씬별 나레이션 + 화면 설명 + 자막 포함.
API 키는 .env에서 읽어줘.

Claude Code가 Gemini API를 호출하는 코드를 작성하고 실행해서, 대본 파일을 바로 만들어줘요. 여러분은 결과만 확인하면 돼요.

Gemini가 할 수 있는 것들

기능	설명	활용 예시
텍스트 생성	대본, 요약, 번역, 분류	쇼츠 대본, 블로그 초안 — 무료
이미지 생성	Gemini 모델로 이미지 생성	썸네일, 카드뉴스 — 무료 제한적
이미지 분석	이미지를 보고 설명/분석	영수증 인식, 차트 해석 — 무료
영상 생성 (Veo)	프롬프트로 영상 클립 생성	쇼츠 배경 영상 — 유료만

API 키 보안 주의

API 키를 코드에 직접 쓰면 안 돼요! 반드시 .env 파일에 저장하고,.gitignore에 .env를 추가해서 외부에 노출되지 않도록 하세요. API 키가 유출되면 다른 사람이 여러분 계정으로 API를 사용할 수 있어요.

DART 공시 자동 수집

DART는 금융감독원이 운영하는 전자공시시스템이에요. 상장 기업의 사업보고서, 분기보고서, 주요사항보고서 등 모든 공시자료를 무료로 제공하거든요.

수동으로 DART 사이트에 들어가서 하나씩 클릭하는 대신, API로 한번에 가져올 수 있어요.

API 키 발급

opendart.fss.or.kr 접속

DART Open API 사이트

회원가입 (무료)

공인인증서 없이 이메일로 가입

인증키 신청

"Open API 이용 신청" 메뉴에서 신청

이메일로 키 수신

보통 바로 발급됨

.env 파일에 저장

DART_API_KEY=your-api-key-here

공시 자료 수집 + 분석

Claude Code에 이렇게 말하세요

DART API로 삼성전자 최근 3개월
공시를 가져와서 중요한 것만 골라
분석 보고서를 report.html로 만들어줘.
API 키는 .env에서 읽어줘.

Claude Code가 DART API를 호출해서 공시 목록을 가져오고, 중요도를 판단해서 핵심 공시만 골라서 예쁜 HTML 보고서로 만들어줘요. 투자 리서치에 매일 2시간 쓰던 작업이 2분이면 끝나요.

이런 것도 가능해요

재무제표 비교 분석
“삼성전자와 SK하이닉스의 최근 3년 매출/영업이익을 비교 차트로 만들어줘”
공시 알림 시스템
“관심 종목 10개의 신규 공시를 매일 아침 체크해서 요약해줘”
사업보고서 핵심 추출
“이 회사 사업보고서에서 리스크 요인과 신규 사업만 뽑아서 정리해줘”

DART API 무료 한도

DART API는 하루 10,000건까지 무료로 호출할 수 있어요. 개인 투자 리서치 용도로는 충분한 양이에요. 단, API 키 하나당 하루 한도이므로, 대량 수집이 필요하면 호출 횟수를 체크하세요.

쇼츠 자동화 파이프라인

지금까지 배운 API들을 조합하면 놀라운 걸 만들 수 있어요. 바로 쇼츠(Shorts) 콘텐츠 자동 제작 파이프라인이에요. 대본부터 영상까지, 전체 과정을 자동화할 수 있거든요.

전체 파이프라인

대본 생성 (Claude Code)

주제를 주면 60초 분량의 씬별 대본 + 나레이션 + 자막을 자동 작성

이미지 소스 (Gemini API / Imagen)

각 씬에 맞는 배경 이미지나 일러스트를 AI로 생성

영상 클립 (Veo 3)

이미지를 기반으로 짧은 영상 클립 생성 (동적 효과 포함)

TTS + 편집 (최종 완성)

AI 음성으로 나레이션 생성 + 자막 합성 + 최종 편집

이 한마디로 시작할 수 있어요

"직장인 퇴근 후 바이브코딩으로 월 100만원 버는 법" 주제로
60초 쇼츠 대본을 만들어줘.
5개 씬으로 나누고, 씬별로 나레이션, 화면 설명, 자막을 포함해줘.
Gemini API로 각 씬의 배경 이미지도 생성해줘.

하나의 프롬프트로 대본 + 이미지가 동시에 생성돼요. 사람이 직접 하면 반나절 걸릴 작업을 10분 안에 끝낼 수 있어요.

단계	수동 제작	API 자동화
대본 작성	2~3시간	2분 (Claude Code)
이미지 소스	1~2시간 (검색/편집)	3분 (Imagen API)
영상 편집	3~4시간	10분 (Veo + 자동 편집)
총 소요	6~9시간	약 15분

처음부터 완벽할 필요 없어요

전체 파이프라인을 한번에 완성하려고 하지 마세요. 먼저 대본 생성부터 시작하고, 이미지 생성을 추가하고, 영상과 TTS를 나중에 붙이면 돼요. 각 단계를 하나씩 자동화해 나가는 게 핵심이에요.

직접 해보기

아래 도전 과제 중 하나를 골라서 직접 해보세요. 모두 무료 API로 할 수 있는 것들이에요.

도전 1: Gemini API 텍스트 생성

Gemini API 키를 발급받고, 간단한 텍스트 생성을 테스트해보세요.

Gemini API 키가 .env에 있어.
"오늘의 직장인 응원 메시지"를 5개 생성해줘.
각각 다른 톤(유머, 진지, 감동, 동기부여, 위트)으로.

도전 2: DART API 공시 조회

DART API 키를 발급받고, 관심 기업의 공시를 조회해보세요.

DART API 키가 .env에 있어.
카카오의 최근 1개월 공시 목록을 가져와서
제목, 날짜, 종류를 표로 정리해줘.

도전 3: 뉴스 API로 오늘 뉴스 요약

네이버 검색 API나 RSS를 활용해서 오늘 뉴스를 요약해보세요.

오늘 "AI" 관련 뉴스를 수집해서
주요 뉴스 5개를 제목, 요약, 출처로 정리하고
news-briefing.html로 만들어줘.

확인 체크리스트

API 키를 .env에 저장했다첫 API 호출이 성공했다결과 파일을 확인했다

에러가 나도 걱정하지 마세요. Claude Code에게 “에러가 났어, 확인해줘”라고 하면 원인을 분석하고 수정해줘요. API 키가 잘못되었거나, 파라미터가 틀렸거나, 네트워크 문제인지 스스로 진단해요.

API 활용 팁

API를 안전하고 효율적으로 활용하기 위한 핵심 팁들이에요. 이것만 지키면 처음부터 깔끔하게 작업할 수 있어요.

1. API 키는 .env 파일에 저장

API 키를 코드에 직접 쓰면 보안 위험이 있어요. 반드시 .env 파일에 따로 저장하고, 코드에서는 환경 변수로 불러오세요..gitignore에 .env를 추가하는 것도 잊지 마세요.

.env 파일 예시

GEMINI_API_KEY=your-api-key-here
DART_API_KEY=your-api-key-here
NAVER_CLIENT_ID=your-client-id-here

2. CLAUDE.md에 API 정보 기록

자주 쓰는 API의 문서 URL, 사용 규칙, 주의사항을 CLAUDE.md에 기록해두세요. 매번 설명할 필요 없이 Claude Code가 자동으로 참고해요.

CLAUDE.md 예시

## API 연동
- DART: https://opendart.fss.or.kr/guide/main.do
- Gemini: https://ai.google.dev/docs
- API 키는 모두 .env에서 읽기
- DART 하루 호출 한도: 10,000건

3. 공식 문서 URL을 항상 같이 전달

AI가 환각(hallucination)으로 잘못된 API 호출을 하는 걸 방지하려면, 공식 문서 URL을 프롬프트에 같이 넣어주세요. “이 문서 참고해서” 한마디면 정확도가 크게 올라가요.

4. 무료 API부터 시작하기

유료 API를 바로 쓰면 실수로 비용이 나갈 수 있어요. 먼저 무료 API(Gemini, DART, 공공데이터포털 등)로 연습하고, 익숙해지면 유료 API로 넘어가세요.

5. 에러는 AI에게 던지기

API 호출 시 에러가 나면, 에러 메시지를 그대로 Claude Code에게 보여주세요. “이 에러 해결해줘” 한마디면 원인 분석부터 코드 수정까지 알아서 해줘요. API 에러는 대부분 키 오류, 파라미터 오류, 한도 초과 중 하나라서 AI가 빠르게 해결할 수 있어요.

실수	결과	예방법
API 키를 코드에 직접 작성	GitHub에 올리면 키 유출	.env 파일에 분리 저장
공식 문서 없이 요청	잘못된 API 호출 코드 생성	문서 URL을 프롬프트에 포함
유료 API로 바로 시작	실수로 과금 발생	무료 API로 먼저 연습
에러를 직접 해결하려 함	시간 낭비	에러 메시지를 AI에게 전달

API는 레고 블록이에요

API 하나하나는 레고 블록과 같아요. Gemini(AI 생성) + DART(데이터) + TTS(음성) 블록을 조합하면 뉴스 브리핑 봇이 되고, 쇼츠 자동화 파이프라인이 돼요. 블록이 많아질수록 만들 수 있는 것도 무궁무진해져요.무료 블록부터 하나씩 모아보세요.

참고 자료

Gemini API — ai.google.dev/docs
DART OpenAPI — opendart.fss.or.kr
Naver API — developers.naver.com

🔌 API 연동 — 외부 데이터 활용

API란?

인기 무료 API

AI에게 공식 문서 알려주기

방법 1: 문서를 파일로 저장

방법 2: URL 직접 전달

방법 3: context7 활용

방법 4: CLAUDE.md에 기록

Gemini API로 콘텐츠 생성

API 키 발급

텍스트 생성 예시

Gemini가 할 수 있는 것들

DART 공시 자동 수집

API 키 발급

공시 자료 수집 + 분석

이런 것도 가능해요

쇼츠 자동화 파이프라인

전체 파이프라인

직접 해보기

도전 1: Gemini API 텍스트 생성

도전 2: DART API 공시 조회

도전 3: 뉴스 API로 오늘 뉴스 요약

확인 체크리스트

API 활용 팁

1. API 키는 .env 파일에 저장

2. CLAUDE.md에 API 정보 기록

3. 공식 문서 URL을 항상 같이 전달

4. 무료 API부터 시작하기

5. 에러는 AI에게 던지기