API는 서로 다른 프로그램이 데이터를 주고받는 창구입니다. 내 도구가 네이버·Slack 같은 서비스에 데이터를 요청하면 서비스가 정해진 형식으로 응답을 돌려줍니다. 경쟁사 기사 모니터링은 네이버 검색 API, 마감 알림은 Slack API처럼, 사람이 일일이 하던 일을 프로그램이 대신하게 해주는 연결 통로입니다.

AI 일잘러 ① API 연결편: 코드 몰라도 외부 서비스 붙이기

Q: API 키는 어떻게 발급받나요?

각 서비스의 개발자 페이지에서 앱을 등록하면 발급됩니다. 개발자 센터에 로그인해 애플리케이션을 등록하고 사용할 기능을 선택하면 키가 나옵니다. 보통 Client ID와 Client Secret 한 쌍이거나 긴 토큰 하나이며, 이 키는 출입증이라 공개된 곳에 올리면 안 됩니다.

Q: .env(환경변수)가 뭔가요?

.env는 환경변수를 모아 두는 설정 파일입니다. 환경변수(environment variable)란 코드 안에 직접 적지 않고 프로그램이 실행될 때 바깥 환경에서 읽어 오는 값으로, API 키처럼 비밀스럽거나 상황에 따라 달라지는 값을 코드와 분리해 둘 때 씁니다. 키를 코드에 박으면 공유·깃허브 업로드 시 유출되므로, 값을 .env에 환경변수로 빼두고 코드는 환경에서 읽어오게 만드는 것이 표준입니다. 한 줄에 하나씩 이름=값 형태로 적습니다.

Q: .env는 어떻게 설정하나요?

프로젝트 폴더에 .env 파일을 만들어 NAVER_CLIENT_ID=값 형태로 키를 적고, .gitignore에 .env를 추가해 공유에서 제외합니다. 이렇게 하면 키는 내 컴퓨터에만 남고 코드를 공유해도 비밀 값은 빠집니다. 핵심은 키는 .env에, .env는 공유 금지입니다.

Q: 프롬프트로 내 입맛에 맞게 세팅하기

키 준비가 끝나면 실제 연결 코드는 Claude Code 같은 AI에게 프롬프트로 맡기면 됩니다. '원하는 결과 + 키는 .env에서 읽기'를 함께 적어 주면, AI가 .env에서 키를 읽어 API를 호출하는 코드를 만들어 줍니다. 코드를 직접 짜지 않아도 내 입맛에 맞는 자동화가 완성됩니다.

AI에게 업무를 시키려면 먼저 외부 서비스를 연결하는 'API'를 붙여야 하며, 코드를 몰라도 다음 5단계로 가능합니다. ① API 개념 이해 ② API 키 발급 ③ .env(환경변수) 이해 ④ .env 설정 ⑤ 프롬프트로 세팅입니다. 핵심은 비밀 키를 안전하게 보관한 뒤, 실제 연결 코드는 Claude Code 같은 AI에게 프롬프트로 맡기는 것입니다. 이번 1편에서 기초를 잡으면, 2편(기사 모니터링)부터 바로 써먹을 수 있습니다.

API 연결 5단계를 순서대로 보여주는 도식 - API 개념, 키 발급, env 이해, env 설정, 프롬프트 세팅과 기사 모니터링·마감 알림 예시

API가 뭔가요?

API는 서로 다른 프로그램이 데이터를 주고받는 '창구'입니다. 식당에 비유하면, 주방(서비스)에 직접 들어가지 않고 점원(API)에게 주문하면 음식을 받아오는 것과 같습니다. 내 도구가 네이버·Slack 같은 서비스에 "이 데이터 줘"라고 요청하면, 서비스는 정해진 형식으로 응답을 돌려줍니다.

업무에서는 이렇게 쓰입니다.

경쟁사 기사 모니터링을 하고 싶을 때 → 네이버 검색 API로 관련 기사를 자동 수집
업무 마감을 놓치기 싫을 때 → Slack API로 마감 알림을 자동 발송
매일 반복되는 데이터 수집을 자동화할 때 → 해당 서비스의 API 호출

즉 API는 "사람이 일일이 들어가서 복사하던 일"을 프로그램이 대신하게 해주는 연결 통로입니다.

API 키는 어떻게 발급받나요?

API 키는 각 서비스의 개발자 센터에 로그인해 앱(애플리케이션)을 등록하고 쓸 기능을 선택하면 발급됩니다. 보통 Client ID와 Client Secret 한 쌍이거나 긴 문자열 토큰 하나로 나옵니다.

공통 절차는 다음과 같습니다.

해당 서비스의 개발자 센터에 로그인합니다(예: 네이버 개발자 센터, Slack API 페이지).
'애플리케이션 등록' 또는 'Create App'을 눌러 앱을 만듭니다.
사용할 기능(예: 검색)을 선택하면 키(Key) 가 발급됩니다.

이 키가 곧 '출입증'이라, 노출되면 남이 내 권한으로 서비스를 쓸 수 있으니 절대 공개된 곳에 올리면 안 됩니다.

.env(환경변수)가 뭔가요?

.env는 '환경변수'를 모아 두는 설정 파일입니다. 환경변수(environment variable)란 프로그램 코드 안에 직접 적지 않고, 프로그램이 실행될 때 바깥 환경에서 읽어 오는 값을 말합니다. API 키처럼 비밀스럽거나, 개발용·운영용처럼 상황에 따라 달라지는 값을 코드와 분리해 두기 위해 씁니다.

키를 코드에 직접 박아 두면, 그 코드를 공유하거나 깃허브(GitHub)에 올리는 순간 키가 통째로 유출됩니다. 또 값이 바뀔 때마다 코드를 고쳐야 합니다. 그래서 이런 값들을 .env 파일에 환경변수로 빼두고, 코드는 "환경에서 그 값을 읽어오게" 만드는 것이 표준 방식입니다.

.env는 한 줄에 하나씩 이름=값 형태로 적는 단순한 텍스트 파일이며, 여기 적은 이름이 곧 코드가 불러 쓰는 환경변수의 이름이 됩니다.

.env는 어떻게 설정하나요?

프로젝트 폴더에 .env 파일을 만들어 한 줄에 하나씩 이름=값 형태로 키를 적고, .gitignore에 .env를 추가해 공유에서 제외하면 됩니다. 네이버 검색 API라면 NAVER_CLIENT_ID와 NAVER_CLIENT_SECRET 두 줄을 넣습니다.

예를 들어 .env에 다음과 같이 적습니다.

NAVER_CLIENT_ID=발급받은_아이디
NAVER_CLIENT_SECRET=발급받은_시크릿

그리고 키가 실수로 업로드되지 않도록, .gitignore 파일에 다음 한 줄을 추가합니다.

.env

이렇게 하면 키는 내 컴퓨터에만 남고, 코드를 공유해도 비밀 값은 빠집니다. 핵심 원칙은 "키는 .env에, .env는 공유 금지"입니다.

프롬프트로 내 입맛에 맞게 세팅하기

키 준비가 끝나면, 실제 연결 코드는 Claude Code 같은 AI에게 프롬프트로 맡기면 됩니다. 코드를 직접 짜지 않아도, 무엇을 하고 싶은지 설명하면 AI가 .env에서 키를 읽어 API를 호출하는 코드를 만들어 줍니다. 예를 들어 이렇게 요청합니다.

.env에 있는 NAVER_CLIENT_ID와 NAVER_CLIENT_SECRET을 사용해서
네이버 검색 API로 '버거킹' 관련 최신 기사 10건을 가져와 제목과 링크를 정리해줘.
키는 코드에 직접 쓰지 말고 .env에서 읽어와.

이처럼 "원하는 결과 + 키는 .env에서 읽기"를 함께 적어 주면, 내 입맛에 맞는 자동화가 완성됩니다. 다음 2편에서는 이 방식을 그대로 써서 네이버 API로 경쟁사 기사 동향을 자동 정리하고 PPT로 내보내는 과정을 다룹니다.

참고: 네이버 개발자 센터 · Claude Code 공식 문서