본문으로 건너뛰기

[사례글] 23기 K스킬자동화 - 국민연금 API로 인력변동 알림 만들다가, 세 번 막혔다

nihong

2026.07.28

## 왜 시작했나

여러 기업을 관리하는 입장에서, 비상장기업은 성장하고 있는지 어려워지고 있는지를 재무적으로 확인할 방법이 많지 않습니다. 감사보고서나 공시가 없으니까요. 그런데 국민연금 가입자 수는 매달 공개되고, 고용 인원의 증감을 어느 정도 유추할 수 있는 지표예요. "이걸 매달 자동으로 추적하면 어떨까"에서 시작했습니다. GPT에게 아이디어를 물어봤고, k-skill 중 국민연금 가입 사업장 조회 API를 쓰는 스킬이 이미 있길래 그걸 바탕으로 클로드코드에서 만들었습니다.

## 처음 설계, 그리고 바로 고침

처음엔 "3개월 전 대비 30% 감소하면 경고"로 설계했어요. GPT가 준 예시 그대로였죠. 그런데 만들고 나서 생각해보니 3개월은 텀이 너무 길었어요. 그래서 "전월 대비 몇 % 감소했는가" 기준으로, 관찰(5~10%)·주의(10~20%)·경고(20~35%)·긴급(35%+) 네 단계로 다시 나눴습니다. 여기에 지속 감소(3개월 연속)와 급증(전월 대비 20%↑)은 등급과 별개로 항상 체크하게 했고요.

## 막힌 것 1 — "매달 자동 실행"이 생각보다 안 됐다

매달 1일에 자동으로 체크하고 캘린더에 알림을 남기고 싶었는데, 여기서 두 번 헛발질했습니다.

1. 클라우드에 크론(정기 실행)을 걸었더니, 클라우드 환경엔 제 컴퓨터의 구글 인증도, 국민연금 조회 스크립트도 없어서 애초에 돌아갈 수가 없었어요.

2. 그럼 구글 시트/캘린더 커넥터를 연결하면 되겠다 싶어 찾아봤는데, 이 환경엔 구글 드라이브·캘린더·지메일 커넥터만 있고 구글 시트 커넥터 자체가 없었어요. 드라이브 커넥터는 파일 다운로드 정도만 되고 시트 셀 단위 읽기/쓰기는 안 되고요.

결국 방법을 바꿨습니다. clasp로 스프레드시트에 직접 묶인 구글 앱스스크립트를 만들어서, 매달 1일 트리거가 구글 서버 안에서 도는 방식으로요. 제 컴퓨터가 꺼져 있어도, 별도 커넥터 없이도 돌아갑니다. 완전히 무료고요.

## 막힌 것 2 — "(주)"라고 검색하니 데이터가 없었다

관심 기업 164곳을 한 번에 조회해봤는데, 처음 결과가 이상했어요. 164곳 중 확인된 게 겨우 20곳. 꽤 규모 있는 회사(A사)도 "데이터 없음"으로 나왔거든요.

이유는 표기 차이였습니다. 국민연금에 등록된 이름은 "(주)OOO"가 아니라 "주식회사 OOO"였어요. API가 부분일치 검색이라, "(주)"라는 글자 자체가 원본 데이터에 없으니 통째로 못 찾은 거였습니다. 회사가 없어서가 아니라 표기가 안 맞아서였던 거죠.

"(주)"를 떼고 "주식회사"를 붙이거나 떼거나 띄어쓰기를 바꿔가며 여러 표기를 순서대로 시도하게 고쳤더니, 확인된 회사가 20곳에서 97곳으로 늘었습니다.

## 막힌 것 3 — 안 되는 건 안 되는 거였다

나머지 33곳은 같은 이름의 사업장이 여러 개 걸려서 특정이 안 됐어요. 처음엔 "같은 법인이면 합산하면 되지 않을까" 싶었는데, 확인해보니 국민연금 API는 사업자등록번호 뒷자리를 항상 마스킹해서 공개해요. 그리고 후보가 2개 이상으로 안 좁혀지면 애초에 가입자수 자체를 안 줍니다. 합산할 숫자 자체가 없는 거예요. 사업자번호를 정확히 넘겨봐도, 다른 파라미터를 시도해봐도 안 뚫렸습니다.

이 33곳을 매달 사람이 국민연금 사이트에서 직접 확인하는 것도 생각해봤는데, 계산해보니 매달 100번 넘는 조회 작업이 들어가더라고요. 원래 자동화는 완전 무료로 도는데, 여기에 매달 사람 손이 드는 작업을 얹으면 자동화 취지가 무색해집니다. 그래서 이 33곳은 그냥 시트에 회색으로 "미확정" 표시만 해두고, 무료 자동 재시도에 맡기기로 했어요.

## 결과

- 관심 기업 164곳을 등록했고, 그중 97곳은 이번 달 가입자 수가 확정됐습니다.

- 스프레드시트에 회사·월별 가입자 수가 쌓이는 구조(가로 포맷, 매달 새 열 추가)를 만들었고, 필터와 빈칸 회색 표시도 걸어뒀습니다.

- 매달 1일 오전 9시, 구글 앱스스크립트가 자동으로 전체 기업을 재확인하고 알림이 있으면 캘린더에 남깁니다.

## 이 프로젝트의 특성 — 지금은 "구축"까지

이 국민연금 API는 조회 시점의 최신 월 데이터만 줘서, 과거 데이터를 지금 끌어올 수가 없습니다. 그 말은 "전월 대비 몇 % 감소"라는 이 프로젝트의 핵심 기능이, 최소 두 번은 자동 수집이 돌아야 실제로 작동한다는 뜻이에요. 이번 달엔 첫 스냅샷만 쌓였고, 진짜 알림이 뜨는 걸 보려면 다음 달 1일 이후까지 기다려야 합니다.

그래서 이번 주는 "완성"이 아니라 "구축"으로 정의했습니다. 매달 자동으로 데이터가 쌓이는 구조를 만들어두고, 실제로 몇 달 지나서 어떻게 동작하는지 보면서 계속 다듬어가는 프로젝트로요.

## Key Takeaways

- 국민연금 가입자 수는 비상장기업의 고용 증감을 유추할 수 있는 몇 안 되는 공개 지표다.

- "(주)"와 "주식회사" 표기 차이만으로 조회 결과가 20곳에서 97곳으로 거의 5배 차이 났다 — 이름 매칭 로직은 생각보다 정확도에 큰 영향을 준다.

- 사업자등록번호 뒷자리 마스킹은 정부 데이터 정책이라 클라이언트 쪽에서 뚫을 방법이 없다 — 안 되는 건 안 되는 거로 인정하고 넘어가는 것도 결정이다.

- 클라우드 자동화(크론, MCP 커넥터)가 항상 되는 게 아니다. 안 되면 다른 경로(구글 앱스스크립트)로 우회할 수 있다.

- "매달 최신 데이터만 주는" API 위에 트렌드 분석 기능을 얹으려면, 최소 2회차 이상 데이터가 쌓일 때까지는 기다려야 한다 — 이번 주는 그 첫 회차를 심어두는 작업이었다.

## To-do List

- [ ] 8월 1일 이후 첫 "전월 대비" 알림이 실제로 뜨는지, 등급 기준(관찰/주의/경고/긴급)이 적절한지 확인

- [ ] 미확정 33곳 중 국민연금 쪽 옛 주소 데이터가 정리되며 자동으로 좁혀지는 곳이 몇 곳인지 2~3개월 지켜보기

- [ ] 알림 캘린더 이벤트 문구가 실제로 판단에 쓸 만한지 검토하고 필요하면 형식 조정

- [ ] 데이터가 몇 달 쌓이면, 감소율 등급 구간(5/10/20/35%)이 실제 상황에 맞는지 재조정

1

함께 이야기해요 1

로그인하고 댓글을 남겨 주세요

뽀짝이 프로필 이미지
뽀짝이2026.07.28
"(주)" vs "주식회사" 표기 하나로 조회 결과가 20곳에서 97곳으로 늘어난 부분이 인상적이었어요. 데이터가 없는 게 아니라 표기 방식이 달라서 못 찾은 거라는 원인을 직접 파고든 과정이 잘 드러나 있어요. 33곳을 "미확정"으로 처리하고 사람 손을 올리지 않기로 한 결정도 좋았어요. 매달 100번 조회 작업이 드는 것과 자동화 취지 사이의 트레이드오프를 명확하게 따진 것이, 막연히 "구현 어려움"으로 남기는 것보다 훨씬 설득력 있어요. 이번 주를 "완성"이 아닌 "구축"으로 정의한 것도요 — 데이터가 두 달 쌓여야 경고 기준이 의미를 갖게 되는 구조니까, 지금 단계를 정확하게 이름 붙인 거예요. 8월 1일 첫 재실행 결과가 기대돼요. 고롱고롱 🐾

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기