SELUB과 AI 활용하기🤖

국회 API 가져오는 법 

이제는 업무에 어떤 방식으로든 AI를 활용하는 것은 너무나 익숙한 일이 되어 버렸는데요. 그 예로 국회 쪽에서도 텔레그램을 통해 다양한 서비스를 제공하는 방들이 우후죽순 늘어나고 있습니다. 하지만 AI를 어느 정도 깊이로 활용하고 있느냐는 개인마다 천차만별일 것입니다. 단순히 LLM 챗으로 대화를 한다든가, AI agent를 만들어 업무를 자동화한다든가, 바이브 코딩을 통해 간단한 서비스를 만들어 사용한다든가 하는 식으로 말입니다. 오늘 SELUB에서는 조금 더 깊이 들어가 국회 API를 끌어와 내 업무에 활용할 수 있는 방법을 소개해보도록 하겠습니다. 

오늘의 목표

국회의원 정보를 API로 가져와서 데이테베이스에 저장하고, 필요한 정보만 필터링 해서 화면으로 만들기

✅ 필요한 사전지식

API란? API(Application Programming Interface)는 다른 프로그램(또는 서비스)이 제공하는 기능과 데이터를 정해진 규칙(요청/응답 형식)에 따라 사용할 수 있게 해주는 창구. 예를 들어 국회 OpenAPI에 요청을 보내면(요청 URL + 인증키 + 파라미터), 국회의원 정보가 JSON/XML 형태로 응답되어 오고, 우리는 그 데이터를 가공해 화면에 보여주거나 데이터베이스에 저장할 수 있음

1. 국회 API를 가져오기 위한 인증서(토큰) 발행

• 발행 사이트 링크: https://open.assembly.go.kr/portal/openapi/main.do
• 로그인 후 마이페이지 → 인증키 발급(활용 용도: '연구용' / 내용: '연구용') → 발급 확인(인증키는 별도 저장 필요)

✅ 필요한 사전지식

왜 API 인증토큰을 받아야 하는가?

• 사용자 및 앱 식별: API를 호출하는 주체가 누구인지(어떤 개발자나 기관인지) 시스템이 파악하고 승인된 사용자임을 확인
• 트래픽 및 호출 횟수 제한 (Rate Limiting): 특정 사용자가 서버에 과도한 부하를 주거나 무분별하게 데이터를 요청하는 것을 막기 위해 1일 최대 호출 횟수(예: 하루 1,000회 등)를 제한하고 관리
• 보안 및 서버 과부하 방지: 인증되지 않은 익명의 대량 요청으로 인해 국회 데이터 서버가 다운되거나 마비되는 상황을 예방합니다.
• 활용 목적 파악 및 통계: 공공 데이터가 어떤 목적으로 얼마나 쓰이는지 통계를 내어 향후 서비스 개선과 데이터 개방 정책 수립에 활용

2. 국회 API 사이트에서 API 정보 가져오기

• API 제공 사이트: https://open.assembly.go.kr/portal/openapi/openApiNaListPage.do
• 검색에서 '국회의원' 키워드로 API 찾기 → '국회의원 정보통합' API 클릭(https://open.assembly.go.kr/portal/data/service/selectAPIServicePage.do/OOWY4R001216HX11439) → 샘플 URL 탭에서 '샘플URL'을 클릭하면, 아래와 같은 [샘플 출력 결과]가 나옴

3. 코덱스에서 API 가져오고 저장하는 스킬 만들기

• API 페이지 링크와 함께 아래와 같이 프롬프트 입력
• 특별한 설명 없이 아래처럼 입력하면 약 3000개 이상의 역대 국회의원 정보를 가져옴(22대 국회, 회기당 300명, 초선 비율 50%면 대략 맞는 숫자로 보임)
  🖥️ 프롬프트
  국회의원정보를 가져오는 API 주소 페이지야. 해당 API에 대해서 분석하고 정보를 가져와서 보여줘.
  주소 링크: https://open.assembly.go.kr/portal/data/service/selectAPIServicePage.do/OOWY4R001216HX11439
  인증키 : [복사한 인증키]
  샘플 URL 출력 결과 [          ]
• 값을 제대로 가져오면 아래와 같이 스킬 만들기
  🖥️ 프롬프트
  지금까지 작업한 것을 토대로 국회의원 정보를 가져오는 스킬을 생성해줘. skill-creator 스킬을 사용해서 만들어줘.
• API 호출을 통한 정보 가져오기가 끝나면, 수파베이스에 데이터베이스 저장
  🖥️ 프롬프트
  수파베이스에 API 결과를 저장할꺼야. 테이블을 만들고, 저장해줘.
• 저장이 끝나면, 저장하기까지 포함해서 스킬 업데이트
  🖥️ 프롬프트
  앞서 만든 국회의원 정보 가져오기 스킬을 수파베이스 저장까지 포함해서 업데이트 해줘.

✅ 필요한 사전지식

1) AI 스킬 만들기란, 클로드(Claude) 같은 AI 에이전트가 특정 업무를 반복해서 일관되게 수행하도록 구체적인 작업 지침서(SKILL.md) 파일을 작성해 AI에게 장착해 주는 기능. 스마트폰에 필요한 앱을 설치하듯 AI에게 특정 분야의 전문 능력을 더해주는 원리

• 반복 설명 불필요: 매번 대화할 때마다 회사 양식이나 규칙을 길게 설명할 필요 없이, 키워드나 요청만 하면 AI가 스킬을 동적으로 불러와 실행
• 코딩 없는 쉬운 제작: 복잡한 프로그래밍 없이 마크다운(.md) 형식의 문서 하나로 규칙과 절차를 정의할 수 있음
• 스킬을 만드는 이유는 재사용을 위한 것이고, 국회의원 정보는 상임위 변경 등으로 업데이트될 수 있는데, 매번 업데이트하기 어렵기 때문에 스킬을 사용한 것임
• 스킬을 DB 저장까지 만드는 이유는 화면은 어차피 최신 정보만 반영하고, DB만 업데이트되면 화면은 따라서 바뀌게 됨

2) 코덱스란, 오픈AI에서 만든 AI agent. 자세한 설명은 링크에서

3) 수파베이스란, 빠르게 앱 개발을 진행할 수 있도록 데이터베이스, 인증, 스토리지, 실시간 업데이트 등의 기능을 제공

4. 22대 국회의원 정보만 추출해서 화면 만들기

• 수파베이스 국회의원 정보 데이터베이스에서 데이터를 가져와서 화면 만들기
  🖥️ 프롬프트
  수파베이스에 국회의원정보 데이터 테이블이 있어. 그 정보를 가져오는 NaMember.html을 만들어줘 22대 국회의원만 가져오면 돼. 22대 국회의원을 필터링 하는 방식은 당선대수에 22대가 있는 경우야.
• 검색 필터 적용
  🖥️ 프롬프트
  정당별, 지역별(광역), 소속위원회, 성별 등 검색 필터 적용

본 콘텐츠는 박용규 어드바이저님의 자료를 참조, 편집하였습니다. 감사합니다🙇.