본문으로 건너뛰기

카드 추천 봇 : 결제 혜택까지 완벽하게

아루네

2026.10.07

카드 추천 봇 : 결제 혜택까지 완벽하게 본문 이미지

카드캡터 봇: 결제 직전 "이 카드 맞나?"를 묻는 개인용 카드 추천 봇 만들기

소개

카드가 여러 장이면 결제할 때마다 헷갈립니다. 어떤 카드는 전월 실적을 채워야 할인이 되고, 어떤 카드는 주말에만 추가 적립을 해 주고, 어떤 카드는 무이자 할부를 실적에서 뺍니다. 이 규칙을 매번 기억하거나 카드사 앱을 하나씩 열어 확인하기는 어렵습니다.

그래서 결제 직전에 메신저(텔레그램)로 짧게 물어보면 가진 카드 중 가장 유리한 카드를 바로 알려 주는 개인용 봇 카드캡터 봇(카드길잡이)을 만들었습니다. 사용 방법은 이렇습니다.

  • "스타벅스 6500"

  • "네이버페이로 쿠팡 2만3천원"

  • "신세계백화점 30만원 3개월 무이자"

이렇게 보내면 등록된 카드 9장 중 혜택이 큰 순서대로 알려 줍니다.

이 글은 봇을 만들어 운영을 시작한 단계까지의 기록입니다.

준비 조건

항목

쓴 것

비고

코드 작성 도우미

Claude Code (데스크톱 앱)

코드·테스트·문서 작성

메신저

텔레그램 봇

봇 계정과 토큰 발급은 직접

문장 이해

Gemini API (경량 모델)

문장 → 가맹점·금액·결제수단

서버

Vercel (서버리스)

요청이 올 때만 실행

데이터 저장

Firebase Firestore

카드 혜택, 결제 기록, 실적 선언

카드 자료

카드사 공식 상품설명서

혜택 숫자의 출처

노트 앱 (선택)

옵시디언

카드 데이터를 노트·대시보드로 보기

사전 지식은 많지 않아도 됩니다. 다만 계정 만들기, 키 발급, 배포처럼 비밀값이 필요한 단계는 AI가 대신할 수 없어서 직접 해야 했습니다.

진행 방법

1. 기획: AI와 규칙이 할 일을 나눈다

처음 기획서에서 가장 중요하게 정한 것은 역할 분담이었습니다.

  • AI(Gemini): 사람이 쓴 문장을 정리된 데이터로 바꾸는 일만 합니다. 예를 들어 "내일 세무서 종소세 100만원"은 가맹점·업종·금액으로 나눕니다.

  • 규칙(룰 엔진): 정리된 데이터를 받아서 카드별 혜택을 계산하고 순위를 매깁니다.

기획서는 이렇게 나눈 이유를 "생성형 AI의 환각 현상을 방지하기 위해"라고 적었습니다. 돈이 걸린 계산을 AI가 그럴듯하게 지어내면 곤란하기 때문입니다.

2. 뼈대 만들기와 테스트

Claude Code로 프로젝트 뼈대를 만들었습니다. 뼈대는 다음과 같이 나뉩니다.

  • 혜택 계산처럼 외부 연결 없이 계산만 하는 부분

  • 텔레그램·Gemini·Firestore에 연결하는 부분

  • 서버 입구(웹훅)

첫 단계에서 단위 테스트, 타입 검사, 빌드, 코드 검사를 모두 통과시켰습니다. 그래도 이 시점의 봇은 키가 하나도 없는 "빈 뼈대"였다고 계획서에 적혀 있습니다. 파일이 만들어진 것과 봇이 실제로 동작하는 것은 다른 단계였습니다.

3. 설계를 바꾼 지점: 24시간 켜져 있어야 한다

원래 기획에서는 평소 쓰던 개인 AI 비서가 카드 질문을 받아 카드 봇에 넘기기로 했습니다. 그런데 Claude Code로 그 비서가 어떻게 돌아가는지 살펴보니, 오픈소스 에이전트 프레임워크 위에서 내 PC가 켜져 있을 때만 동작하고 있었습니다.

카드 추천은 결제 직전 몇 초 안에 답이 와야 하는 기능입니다. PC가 꺼져 있는 외출 중에 답을 못 받는 구조가 되면 쓸모가 없습니다. 텔레그램 봇 하나는 메시지를 받는 곳을 한 군데만 둘 수 있다는 기술적 제약도 있었습니다.

그래서 세 가지 안을 놓고 비교했습니다.

안

내용

판단

A

카드 봇을 완전히 따로 운영

가장 단순함

B

개인 AI 비서 전체를 클라우드로 이전

카드 추천 하나 때문에 하기엔 과한 투자

C

A를 기본으로 하고, 비서에서도 같은 답을 받는 연결은 선택 사항

채택

이 판단은 다른 AI(Gemini)에게 계획서를 보여 주고 한 번 더 검토받은 뒤 확정했습니다. 결과적으로 카드 봇은 별도의 텔레그램 봇으로 Vercel에서 24시간 돌아갑니다.

4. 사람이 할 일과 AI가 할 일을 미리 정해 두기

계획서에 "AI가 스스로 하는 일 / 확인받고 하는 일 / 사람이 직접 하는 일"을 표로 정리해 두었습니다.

AI가 스스로

확인받고 진행

사람이 직접

코드 작성·수정, 테스트, 빌드

실제 배포, 웹훅 등록

계정 만들기, 콘솔 로그인

계산 로직 버그 수정

다른 프로그램(개인 비서) 설정 변경

API 키·토큰 발급

가짜 메시지로 로컬 점검

실적 반영 시점 같은 설계 판단

비용이 드는 결정

실제로 배포와 환경변수 올리기는 제가 PowerShell에서 직접 했고, Claude Code는 명령만 안내했습니다. 토큰을 채팅이나 파일에 남기지 않기 위해서였습니다.

5. 실제 카드 9장 넣기

카드사 공식 상품설명서(PDF 등)를 받아 Claude Code에게 주고 혜택을 데이터로 옮겼습니다. 공식 자료가 없는 카드는 제가 확인한 내용을 넣었고, 어느 쪽이든 카드마다 출처를 메모로 남겼습니다.

실제 카드를 넣다 보니 처음 생각한 구조로는 부족했습니다. 그래서 구조를 여러 번 넓혔습니다.

  • 실적 조건이 카드 전체가 아니라 혜택 항목마다 다릅니다. 기본 적립은 무실적인데 영화 할인만 실적이 필요한 식입니다.

  • 실적을 "충족/미달"이 아니라 구간(20만·30만·50만…)으로 받아야 혜택 금액이 정해지는 카드가 있습니다.

  • 가장 큰 혜택 하나만 받는 항목과 위에 더해지는 항목을 나눴습니다.

  • 요일·공휴일·간편결제·해외·월 횟수·통합 한도 조건을 넣었습니다.

  • 마일리지는 마일로 보여 주되, 1마일 = 15원으로 환산해 순위를 매깁니다.

  • 일반 할부와 무이자 할부를 구분했습니다. 체크카드는 할부가 안 됩니다.

운영 가이드에는 카드 혜택이 바뀌었을 때 AI에게 이렇게 요청하라고 적어 두었습니다(운영 가이드에 적어 둔 권장 방식이며, 실제로 보낸 지시문 원문은 아닙니다).

"이 PDF로 ○○카드 혜택 고쳐줘(추가해줘)"

6. 버튼으로 실적과 결제를 기록하기

봇이 추측하지 않도록, 사람이 버튼으로 알려 주는 방식을 택했습니다.

  • 전월 실적 선언: 매달 1일 오전 9시에 봇이 카드별 구간 버튼을 보냅니다. 카드사 앱에서 지난달 실적을 보고 버튼을 누릅니다. 놓치면 /실적 명령으로 다시 할 수 있습니다.

  • 결제 기록: 추천 메시지에서 혜택이 있는 상위 3개 카드에 [💳 ○○로 결제] 버튼이 붙습니다. 1위가 아닌 카드로 결제했을 수도 있어서 여러 카드에 버튼을 붙였습니다. 이 버튼을 눌렀을 때만 이번 달 결제액과 혜택 사용 횟수가 기록되고, 조회만 하고 끝내면 기록되지 않습니다.

  • 기록 고치기: 방금 누른 건 [↩ 취소]로, 지난 기록은 /기록에서 카드나 금액을 바꾸거나 취소합니다.

  • 공항 혜택: "공항"이라고 보내면 이번 달 라운지·발렛파킹·공항 커피를 쓸 수 있는 카드를 보여 줍니다. 이용한 뒤 [이용 기록] 버튼을 누르면 횟수 계산에 반영됩니다.

아래 화면은 "공항"이라고 물었을 때의 답입니다. 지난달 실적을 채우지 못해 쓸 수 없는 카드는 ❌와 함께 "9월 실적 30만원 미달"처럼 이유를 보여 줍니다.

[공항"이라고 물었을 때의 답 — ✅/❌ 표시, 실적 미달 이유, [이용 기록] 버튼]

텔레그램 버튼에는 실을 수 있는 데이터가 64바이트로 제한됩니다. 그래서 추천 내용은 데이터베이스에 저장하고, 버튼에는 그 문서 번호만 싣도록 했습니다.

7. 다음 작업을 위한 문서 정리

다음에 다시 작업할 때를 위해 문서를 정리했습니다.

  • 진행상황: 지금 상태

  • 운영가이드: 무언가 바꿔야 할 때의 절차

  • 실행계획서: 왜 이렇게 만들었는지, 확정된 결정

  • CLAUDE.md: Claude Code가 새 대화에서 가장 먼저 읽는 작업 규칙

예를 들어 운영가이드에는 "카드 정보만 바꿀 때는 재배포가 필요 없다", "매년 말 다음 해 공휴일을 추가한다" 같은 내용이 표로 정리돼 있습니다.

8. 카드 데이터를 옵시디언에서 보기

옵시디언의 백링크와 대시보드로 카드 9장을 서로 비교해 보려고, 카드 데이터를 옵시디언 노트로 내보내는 기능을 만들었습니다.

원본은 하나, 노트는 보기 전용

처음부터 노트를 원본으로 삼지 않기로 정했습니다. 그렇게 하면 봇이 읽는 데이터 파일과 옵시디언 노트 두 군데를 따로 고치게 되어, 언젠가 내용이 어긋납니다. 봇이 쓰는 조건(요일, 횟수, 실적 구간, 유효기간)도 노트 속성 몇 줄로는 다 담을 수 없었습니다.

그래서 명령 하나로 데이터 파일에서 노트를 매번 통째로 다시 만드는 방식을 택했습니다. 카드 혜택을 고칠 때는 데이터 파일만 고치고, Firestore에 올리는 명령과 노트를 내보내는 명령을 함께 실행합니다. 노트에 들어가는 혜택 문구는 봇이 답장에 쓰는 문구와 같은 함수로 만들어서, 봇과 노트의 설명이 서로 다르지 않습니다.

만들어지는 것

종류

내용

카드 노트 9개

카드마다 속성, 혜택 표, 메모

조건 노트

"주유 혜택", "무실적 혜택", "공항라운지", "해외 혜택"처럼 조건별로 해당 카드를 모아 보기. 백링크로도 확인 가능

카드 대시보드

옵시디언 기본 기능인 Bases로 만든 카드 비교표. 플러그인 설치가 필요 없음

조건 노트가 어떤 업종에 속하는지는 봇이 가맹점 업종을 판별하는 규칙을 그대로 써서 정합니다. 해외에서만 받는 혜택은 국내 업종 노트에 넣지 않고 "해외 혜택"으로만 묶습니다.

직접 쓴 노트는 건드리지 않기

내보낸 노트에는 "자동생성" 속성이 붙습니다. 다시 내보낼 때는 이 표시가 있는 파일만 덮어쓰거나 지우고, 같은 폴더에 직접 만든 노트는 건드리지 않습니다. 대신 자동 생성된 노트를 옵시디언에서 고치면 다음 내보내기 때 덮어써집니다. 그래서 운영 가이드에 "옵시디언에서 고치지 않는다"고 적어 두었습니다.

한국어 텍스트가 있는 페이지의 스크린샷

결과와 배운 점

확인된 결과

  • 봇은 Vercel에 배포되어 운영을 시작했습니다. 현재 기능은 다음과 같습니다.

    • 결제 금액을 보내면 카드 추천

    • 금액 없이 가맹점만 보내면 할인율 안내

    • 결제 기록과 그 기록의 수정·취소

    • 매달 1일 전월 실적 질문

    • 공항 라운지 같은 부가 혜택 기록

  • 카드 데이터를 옵시디언의 카드 노트·조건 노트·대시보드로 내보내는 기능을 만들었습니다.

  • 카드 9장 대부분을 카드사 공식 자료와 대조했고, 일부는 직접 확인한 내용을 넣었습니다.

  • Git 기록에는 뼈대 만들기부터 문서 정리까지 커밋 25건이 남아 있습니다.

  • 아직 확인하지 못한 것: 결제 버튼과 기록 수정이 실제 사용에서 잘 되는지는 앞으로 써 보면서 확인할 예정입니다.

시행착오와 복구

  • 배포 도구 로그인 실패: 컴퓨터 이름이 한글이라 Vercel 로그인 명령이 오류를 냈습니다. 토큰을 발급받아 PowerShell 창에만 임시로 두고 배포하는 방식으로 우회했습니다.

  • 카드 목록 정리: 쓰지 않는 카드 1장은 목록에서 뺐습니다.

배운 점

  1. 모르는 건 모른다고 계산하게 하기. 전월 실적 충족 여부는 카드사만 압니다. 처음에는 봇이 기록한 결제액으로 짐작하는 방식이었는데, 봇이 모르는 결제가 있으면 틀립니다. 그래서 이 방식을 버리고, 사용자가 알려 주기 전에는 실적이 필요한 혜택을 0원으로 계산하게 바꿨습니다. 월 한도도 "남은 금액"이라고 단정하지 않고 "봇 기록 기준"이라고 밝힙니다.

  2. AI에게 맡길 일의 범위를 좁히기. 문장 이해는 AI가, 돈 계산은 규칙이, 확인할 수 없는 사실은 사람이 맡도록 나눴습니다.

  3. "편한 구조"보다 "필요할 때 켜져 있는 구조". 개인 AI 비서 하나에 모든 걸 맡기는 그림이 처음 계획이었지만, 결제 직전에 답이 와야 한다는 조건 때문에 따로 떼어 냈습니다.

  4. 같은 데이터를 여러 곳에서 보고 싶으면 원본을 하나로 정하기. 봇과 옵시디언이 같은 카드 데이터를 쓰지만, 고치는 곳은 데이터 파일 한 곳뿐이고 옵시디언 노트는 그 파일에서 만들어 냅니다.

  5. 다음 세션을 위한 문서. 상태·절차·결정 이유를 나눠 적어 두면, 새 대화에서도 AI가 같은 규칙으로 이어서 작업할 수 있게 됩니다. 실제로 이어서 써 본 경험은 아직 많지 않습니다.

알려진 제한

  • 해외 결제 수수료는 계산에 넣지 않았습니다.

  • 횟수·월 한도 사용량은 봇 버튼으로 기록한 것만 압니다.

  • 주유 할인은 기름값을 1L = 1,700원으로 가정한 추정치입니다.

  • 월 합산 조건이 붙은 일부 대중교통 혜택이나 행사상품 할인처럼, 결제 한 건만 보고 판단할 수 없는 혜택은 계산에서 뺐습니다.

아직 하지 않은 일

  • 실제 결제에서 버튼·기록 기능 확인 (예정)

  • 매년 말 다음 해 공휴일 추가 (2027년까지는 반영됨)

  • 개인 AI 비서에서도 같은 답을 받도록 연결 (꼭 해야 하는 일은 아니어서 선택 사항으로 남겨 둠)

  • 개인 AI 비서 전체를 클라우드로 옮기는 일 (카드 봇이 안정된 뒤 따로 검토할 장기 과제)

1

함께 이야기해요 1

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

야호심 프로필 이미지
야호심2026.10.13

아루네 님, '카드 추천 봇' 정말 창의적인 아이디어 같아요. 저도 바로 써보고 싶어지네요. ㅎ 업데이트 하시면 꼭 사례글로 공유해 주세요. 🤟

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

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

이런 사례도 있어요

사례 전체 보기