Capstone Project 2025

CookDoc
AI 요리 어시스턴트

유튜브 링크 하나로 AI가 레시피를 자동 추출하고,
음성으로 요리를 도와주는 스마트 쿠킹 파트너

User Flow 보기 API Docs
24
API Endpoints
6
AI Models
37
Server Files
4
DB Collections
Scroll
↓
USER FLOW

9단계 사용자 여정

URL 입력부터 소비기한 기반 추천까지, 쿡닥의 전체 흐름을 체험하세요

홈 화면
URL 입력 & 탐색
AI 레시피 파싱
Gemini Vision 분석
레시피 상세
재료 / 단계 / 댓글 분석
음성 요리 모드
STT/TTS + 타이머
AI 채팅 (RAG)
Claude 기반 Q&A
요리 완료
재료 자동 차감
지연 평가
2시간 후 별점
냉장고 관리
소비기한 추적
소비기한 추천
임박 재료 기반
9:415G
CookDoc
오늘 뭐 먹지?
유튜브 링크만 붙여넣으면 AI가 레시피를 뚝딱!
🎰
저메추
🔥
인기
🧊
냉장고
🔍
검색
인기 레시피
1
🍲
김치찌개
4.6 / 한식 / 30분
2
🥘
된장찌개
4.4 / 한식 / 25분
3
🍝
까르보나라
4.5 / 양식 / 20분
🏠
홈
🔍
탐색
🧊
냉장고
👤
마이
레시피 분석중
🤖

AI가 영상을 분석하고 있어요

재료, 조리 단계, 타이머, 댓글 팁을
자동으로 추출합니다

1
yt-dlp 영상 다운로드 (720p)
2
댓글 200개 크롤링
3
Gemini Vision 영상 분석
4
레시피 JSON 구조화
5
댓글 AI 분석 (꿀팁 추출)
6
MongoDB 저장 완료
🍲
30분
2인분
4.6
1,247회
백종원 김치찌개
묵은지와 돼지고기로 만드는 깊은 맛의 김치찌개
한식찌개초보 가능
재료
묵은지1/2포기
돼지고기 앞다리200g
두부1/2모
대파1대
고춧가루1큰술
댓글 분석 (200개)
78%
긍정
15%
중립
7%
부정
4.6
평점
김치를 먼저 기름에 볶으면 국물 맛이 훨씬 깊어져요!
342
간이 좀 쎄다는 의견 다수 - 소금 조심!
218 / 주의사항

백종원 김치찌개

요리 모드 진행중
STEP 2 / 6
돼지고기를 한입 크기로 썰어 중불에서 3분간 볶아주세요
⏱2:47
CookDoc AI
김치찌개 시작! 간이 좀 쎄다는 의견이 있으니 소금 조심하세요!
음성 인식 활성 — "다음", "질문"
AI
CookDoc AI
Claude RAG
김치찌개 요리를 도와드릴게요!
간장이 없으면 대체할 게 있을까?
국간장이나 액젓을 사용할 수 있어요. 댓글에서도 "액젓 넣으니 감칠맛이 더 좋았다"는 팁이 있네요!
댓글 #47 참고
중불이 정확히 어느 정도야?
가스레인지 기준 중간 세기의 불꽃이에요. 냄비 바닥에 불이 닿을 듯 말 듯한 정도. 인덕션이면 5~6단계예요.
레시피 컨텍스트
🎉
김치찌개 완성!
조리 시간: 28분 / 6단계 완료
재료 차감 확인
묵은지
1/2포기
돼지고기 앞다리
200g
두부
1/2모
고춧가루
양념류 (스킵)
맛 평가
🔔

김치찌개 어떠셨어요?

2시간 후 알림 / 실제 맛 기반 평가

★★★★★
내 냉장고
소비기한 임박 재료 2개
🥩
소고기 등심
300g / 냉장
D-1
🥬
시금치
1단 / 냉장
D-2
🧅
양파
3개 / 실온
D-12
🥚
계란
8개 / 냉장
D-14
🏠
홈
🔍
탐색
🧊
냉장고
👤
마이
소비기한 기반 추천
소고기(D-1), 시금치(D-2)가 곧 소비기한이에요!
이 재료로 만들 수 있는 요리
🥘
소고기 시금치 된장국
소고기 + 시금치 + 양파
95%
🥩
소고기 볶음밥
소고기 + 계란 + 양파
88%
🥗
시금치 나물
시금치 + 참기름 + 마늘
80%
FEATURES

핵심 기능

AI가 레시피를 추출하고, 음성으로 요리를 도와주는 6가지 핵심 기능

🤖
AI 레시피 파싱
Gemini Vision이 유튜브 영상을 시청하고 재료, 단계, 타이머를 자동 추출합니다.
Gemini 2.0 Flash
💬
댓글 AI 분석
200개 댓글에서 꿀팁, 주의사항, 레시피 변형을 자동으로 추출합니다.
NLP 감성분석
🎙
음성 요리 모드
"다음", "이전", "타이머" 한마디로 손 안 대고 요리 진행. iOS STT/TTS 기반.
On-Device STT
🧠
RAG 기반 AI 채팅
요리 중 궁금한 점을 물으면 레시피+댓글 컨텍스트로 정확한 답변을 제공합니다.
Claude Sonnet
🧊
냉장고 관리
재료 등록, 소비기한 추적, 요리 후 자동 차감. 식재료 낭비를 줄여줍니다.
D-Day 알림
🎯
스마트 추천
보유 재료, 소비기한 임박 재료, 인기도 기반으로 최적의 레시피를 추천합니다.
매칭 스코어링
TECH STACK

기술 스택

검증된 기술로 안정적이고 확장 가능한 서비스를 구현합니다

⚡
FastAPI
비동기 Python 백엔드
24개 REST API
🍃
MongoDB
Motor 비동기 드라이버
4개 컬렉션 + 인덱스
✨
Gemini 2.0
Vision 영상 분석
레시피 + 댓글 추출
🧠
Claude
RAG 기반 채팅
능동 안내 시스템
📺
yt-dlp
영상 다운로드
댓글 크롤링
📱
iOS (Swift)
네이티브 앱
STT/TTS 온디바이스
🔒
Pydantic v2
데이터 검증
타입 안전성
📊
Aggregation
인기도 집계
추천 스코어링
API

24개 REST API

6개 도메인 라우터, 완전한 CRUD + AI 파이프라인

POST/api/recipes/parse
유튜브 URL → AI 레시피 파싱
GET/api/recipes
레시피 목록 (페이지네이션/필터/검색)
GET/api/recipes/{id}/steps
요리 모드용 단계별 조회
POST/api/cooking/start
요리 세션 시작
PATCH/api/cooking/{id}/step
현재 단계 업데이트
POST/api/cooking/{id}/complete
요리 완료 + 재료 차감
POST/api/chat
Claude RAG 기반 AI 채팅
POST/api/chat/proactive
이벤트 기반 능동 안내
GET/api/ingredients
내 냉장고 재료 목록
POST/api/ingredients
재료 등록
GET/api/recommendations/random
저메추: 랜덤 레시피 추천
GET/api/recommendations/expiring
소비기한 임박 재료 기반 추천