선생님이 올린 행사·준비물을 AI가 읽고 정리해서, 우리집 캘린더에 알아서 등록해 주는 작은 도우미예요.
사람이 하던 번거로운 옮겨적기를, 매일 알아서 해주는 작은 비서를 만들었어요.
선생님이 올린 행사·준비물 글이 키즈노트에 올라옵니다.
"몇 월 며칠, 무슨 행사, 뭘 챙겨야 하는지" 똑똑하게 뽑아냅니다.
구글 캘린더에 일정이 자동으로 들어가고, 원문도 함께 붙어요.
자동으로 들어간 일정은 항상 @새솔로 시작해요. 직접 적은 일정과 한눈에 구분됩니다.
아래 다섯 단계만 차례로 따라오면 됩니다. 어렵게 느껴지는 부분은 그림으로 정리했어요.
PC에서 키즈노트 웹사이트에 로그인한 뒤, F12(개발자 도구) → Network 탭을 열어요. 새로고침하면 보이는 reports 요청 한 줄에서 5가지 값을 메모합니다.
children/여기 → CHILD_ID?cls=여기 → CLASS_ID¢er_id=여기 → CENTER_IDx-enrollment: 여기 → ENROLLMENT_IDconsole.x.ai 에 접속해서 가입한 뒤, API Key를 하나 발급받아 메모해두세요. 이 키가 있어야 AI가 알림장을 읽어줍니다.
.env 파일 채우기프로젝트 폴더에서 예시 파일을 복사한 뒤, 1번에서 모은 값으로 채웁니다.
cp .env.example .env # 에디터로 .env 열고 위에서 모은 값 채우기
이미지를 한 번 만들고, 백그라운드로 띄워둡니다.
docker compose build docker compose up -d # 백그라운드로 시작
컴퓨터를 껐다 켜도 자동으로 다시 깨어나요 (restart: unless-stopped).
data/credentials.json으로 저장docker compose run --rm kidsnote-calendar-sync node scripts/google-auth.js
브라우저가 localhost로 리다이렉트 되며 연결 실패 페이지가 떠도 정상이에요. 주소창 code= 뒤 값을 복사해 터미널에 붙여넣으면 끝.
설정이 끝났다면 더는 신경 쓸 게 없어요. 안에서 일어나는 일은 이렇습니다.
@새솔 표시가 붙어요docker compose logs -f로 확인할 수 있어요.가끔 한 번 들여다보고 싶다면 아래 명령으로 충분합니다.
docker compose ps # 켜져 있나? docker compose logs -f # 지금 뭐 하고 있나? docker compose exec kidsnote-calendar-sync node src/main.js --once # 지금 바로 한 번 더 돌려보기
대부분의 문제는 아래에서 해결돼요. 카드를 눌러 펼쳐 보세요.
OAuth 동의 화면이 테스트 모드일 때 발생합니다. Google Cloud Console → OAuth 동의 화면 → 테스트 사용자에 본인 Gmail을 추가하면 사라져요.
1) 비밀번호가 정확한지 다시 확인해주세요. 2) 카카오 OAuth 계정은 지원되지 않습니다 — 키즈노트 자체 비밀번호가 있어야 해요. 3) 그래도 안 되면 data/cookies.json을 삭제하고 다시 시도하세요 (자동 재로그인).
의도된 동작이에요. 다른 알림장에서 같은 행사가 또 언급돼도, 캘린더엔 한 번만 들어가도록 막아두었습니다. 정말 다시 등록해야 한다면 data/state.db의 해당 행을 삭제하세요.
알림장 글이 짧거나 날짜 표현이 모호한 경우입니다. src/extractor.js의 SYSTEM_PROMPT를 조정한 뒤 docker compose up -d --force-recreate로 적용하세요. 같은 리포트를 다시 분석하려면 state.db의 해당 행도 함께 지워야 합니다.
대부분 자동 갱신되지만, 가끔 갱신이 막힐 때가 있어요. data/token.json 파일을 지우고 설정 5단계의 인증 명령을 한 번 더 실행하면 깨끗하게 풀립니다.
동작 원리, 파일 구조, 데이터 흐름까지 자세히 알고 싶다면 개발자용 문서를 참고하세요.