🌅 모닝 카톡 브리핑 v2.1 FINAL

다풀림행정사 사무소 | 매일 오전 7시 자동 카카오톡 발송 시스템

---

📋 자동 실행 스케줄

시각 (KST)	워크플로우	동작
06:50	refresh-kakao-token	Kakao 토큰 자동 갱신
07:00	morning-brief	모닝 브리핑 카톡 발송

cron 표현식 (UTC 기준):

• 토큰 갱신: '50 21 * * *' → KST 06:50
• 브리핑 발송: '0 22 * * *' → KST 07:00

---

🎯 주요 기능

기능	외부 의존	비고
🔄 Kakao 토큰 자동 갱신	Kakao OAuth	refresh_token 사용
📢 대한행정사회 공지 크롤링	daaa.or.kr/vtMain.html	공식 사이트 직접 스크래핑
📰 구글 뉴스 보조 수집	Google News RSS	무료 · 키 불필요
🎙️ 음성 브리핑 (TTS)	gTTS	무료 · 키 불필요
📊 DART 공시	DART OpenAPI	선택 · 없어도 동작
☀️ 날씨	Open-Meteo	무료 · 키 불필요
📅 주말/공휴일 간소화	—	자동 모드 전환

---

📂 파일 구조

sjbaik0431/claude/
├── .github/workflows/
│   ├── morning-brief.yml          # 매일 07:00 브리핑
│   └── refresh-kakao-token.yml    # 매일 06:50 토큰 갱신
├── scripts/
│   ├── morning_brief.py           # 메인 스크립트
│   ├── admin_news_crawler.py      # 행정사회 공지 크롤러
│   ├── voice_briefing.py          # 음성 브리핑 생성
│   └── refresh_kakao_token.py     # Kakao 토큰 갱신
├── logs/
│   └── YYYY-MM-DD.md              # 일일 실행 로그
└── audio/
    └── brief_YYYYMMDD.mp3         # 일일 음성 파일

---

🚀 GitHub Secrets 등록 (필수 5개)

Settings → Secrets and variables → Actions

Secret	필수	획득처
ANTHROPIC_API_KEY	✅	console.anthropic.com
KAKAO_REST_API_KEY	✅	developers.kakao.com
KAKAO_ACCESS_TOKEN	✅	Kakao OAuth 인가 후 발급 (자동 갱신됨)
KAKAO_REFRESH_TOKEN	✅	Kakao OAuth 인가 시 동시 발급
GH_PAT	✅	GitHub PAT (scope: repo) — 토큰 자동 갱신용
DART_API_KEY	⚠️ 선택	opendart.fss.or.kr

Kakao 토큰 최초 발급 절차

# 1) 인가 코드 획득 (브라우저에서)
https://kauth.kakao.com/oauth/authorize?client_id={REST_API_KEY}&redirect_uri=https://localhost&response_type=code&scope=talk_message

# 2) 토큰 발급
curl -X POST "https://kauth.kakao.com/oauth/token" \
  -d "grant_type=authorization_code" \
  -d "client_id={REST_API_KEY}" \
  -d "redirect_uri=https://localhost" \
  -d "code={인가코드}"

# 3) 응답의 access_token, refresh_token을 각 Secret에 등록

---

🎯 메시지 예시

평일 (월~금)

📋 다풀림행정사 04/20 월

📢 행정사 소식 3건
• [회]2026년 보수교육 일정 안내
• [회]회비 납부 기한 연장
• 행정사법 시행령 개정 예고

후성: 주요사항보고서
☀️ 용인 12~18°C 강수10%

주말·공휴일

📋 다풀림행정사 04/19 일 [주말]

📢 행정사 소식 1건
• [회]주말 당직 안내

⛅ 용인 10~20°C 강수30%

오늘 하루 잘 보내세요 😊
— 010-3404-5955

---

🛠 문제 해결

대한행정사회 크롤링 결과 없음

• scripts/admin_news_crawler.py 상단 DAAA_NOTICE_CANDIDATES 경로 조정
• 실제 HTML 구조 확인 후 정규식 패턴(patterns) 수정

Kakao 토큰 만료 오류

• Refresh Token도 만료된 경우 수동 재발급 필요 (2개월마다)
• KAKAO_REFRESH_TOKEN Secret 재등록

캐시 초기화 (전체를 신규로 인식)

rm logs/admin_news_cache.json
git commit -am "reset: cache"
git push

---

연락처: 010-3404-5955 (백상진 행정사) / [email protected]
다풀림행정사 사무소 · 경기도 용인시 기흥구 중동