GitHub Pages 무료 배포 | API 키·Secret 전혀 없음 | 모바일 반응형
오늘의 영어 명언 · 날씨·코디 · 경제 뉴스 · 시장 지수 · 서울·경기 지원사업 · FAQ 챗봇을 한 페이지에서!
- 프로젝트 소개
- 기능 설명
- 폴더 구조
- 로컬에서 바로 열기
- GitHub 저장소 만들기 & 업로드
- GitHub Pages 활성화
- GitHub Actions로 데이터 자동 갱신
- FAQ 챗봇 업데이트 방법
- 자주 발생하는 문제 해결
- 파일별 역할 요약
| 항목 | 내용 |
|---|---|
| 비용 | 완전 무료 (GitHub Pages 호스팅) |
| API 키 | 전혀 없음 — Open-Meteo + 웹 스크래핑 + yfinance + 정적 FAQ |
| 백엔드 | 없음 — GitHub Actions가 Python으로 데이터 수집 후 JSON으로 저장 |
| 기술 스택 | HTML + CSS + Vanilla JS (빌드 도구 없음) |
| 모바일 | 완전 반응형 (모바일·태블릿·데스크톱) |
| 배포 방식 | Deploy from a branch (main 루트) |
GitHub Actions
├─ daily-collect.yml (매일 06:00 KST)
│ └─ collector.py
│ ├─ Open-Meteo → data/weather.json
│ ├─ 네이버 뉴스 → data/news.json
│ ├─ yfinance → data/finance.json
│ └─ 기업마당 → data/bizinfo.json
│
└─ supports-collect.yml (6시간마다)
└─ 지원사업만 갱신 → data/bizinfo.json
│
JSON 커밋 & 푸시
│
GitHub Pages (branch 배포) 자동 반영
│
브라우저에서 JSON만 fetch해서 렌더링
핵심 포인트: 프론트엔드(브라우저)는 data/*.json만 읽습니다.
스크래핑·API 호출은 전부 Actions(서버 측)에서 합니다.
script.js안에 명언 목록이 들어 있습니다.- 페이지 로드 시 ·
↻ 다른 명언 보기클릭 시 랜덤으로 바뀝니다. - 영어 원문 → 한글 해석 → 작자 순으로 표시됩니다.
- 날씨 소스: Open-Meteo 공개 API (키 불필요) — 서울 기준
- 공기질: Open-Meteo Air Quality (PM10)
- 갱신 주기: 매일 06:00 KST (
daily-collect.yml) - 최고/최저 기온·강수·날씨 코드를 반영해 코디 문구·이미지를 생성합니다.
- 소스: 네이버 뉴스 경제 섹션 스크래핑
- 제목 클릭 시 새 창으로 원문 이동
- 갱신 주기: 매일 06:00 KST
- 소스: yfinance
- 지수: KOSPI, S&P 500, 반도체(SOX), 금(Gold)
- 전일 대비 등락·등락률 표시
- 갱신 주기: 매일 06:00 KST
- 소스: 기업마당(bizinfo.go.kr) 스크래핑
- 공고 제목 · 기간 · 상세 링크
- 갱신 주기: 6시간마다 (
supports-collect.yml) + 매일 전체 수집에도 포함
- 우하단 플로팅 버튼 클릭 → 사이드 패널 슬라이드 인
- 키워드 검색 방식 (런타임 AI API 호출 없음, 키 불필요)
q·tags매칭 점수가 높으면 명확한 답변 표시- 약한 매칭이면 "관련 항목" 버튼 제시
- FAQ 내용: ChatGPT · Claude Code 사용 가이드 (
docs/PDF 기반, 약 50개+ Q&A) - 데이터 파일:
data/faq.json· 로직:chatbot.js
aishbot/ (또는 저장소 이름)
├── index.html ← 페이지 구조 + FAQ 챗봇 UI
├── style.css ← 디자인 (포레스트 그린 톤, 반응형)
├── script.js ← 명언 · 날씨 · 뉴스 · 금융 · 지원사업 렌더링
├── chatbot.js ← FAQ 사이드 챗봇 (키워드 검색)
├── requirements.txt ← Python 라이브러리 목록
├── README.md
│
├── docs/ ← 원본 가이드 PDF
│ ├── ChatGPT_사용가이드.pdf
│ └── 클로드코드_사용가이드.pdf
│
├── data/ ← Actions가 갱신하거나 정적 FAQ
│ ├── weather.json ← 날씨 + 코디
│ ├── news.json ← 네이버 뉴스
│ ├── finance.json ← 시장 지수
│ ├── bizinfo.json ← 서울·경기 지원사업
│ ├── faq.json ← 챗봇 Q&A
│ └── contents.json ← (참고용/이전 샘플, 메인 화면은 위 JSON 사용)
│
├── scripts/
│ └── collector.py ← 데이터 수집 스크립트 (한 파일)
│
└── .github/workflows/
├── daily-collect.yml ← 매일 KST 06:00 전체 수집
├── supports-collect.yml ← 6시간마다 지원사업만 수집
└── clean-history.yml ← 오래된 Actions 실행 기록 정리
jkai-ai.github.io(또는aishbot) 폴더를 엽니다.index.html을 엽니다.- "Go Live" 등으로 로컬 서버를 켭니다.
cd jkai-ai.github.io
python -m http.server 8000브라우저에서 http://localhost:8000 접속
npm install -g serve
serve .주의:
index.html을 더블클릭해서file://로 열면
fetch()가 차단되어 JSON·FAQ를 불러오지 못합니다.
반드시http://localhost:...로 여세요.
pip install -r requirements.txt
python scripts/collector.py- github.com 로그인
- 우상단
+→ New repository - Repository name 예:
aishbot - Public 선택 (Pages 무료 배포는 Public 권장)
- Create repository
cd jkai-ai.github.io
git init
git add .
git commit -m "feat: Daily Insights 초기 구성"
# YOUR_GITHUB_USERNAME / REPO_NAME 을 본인 정보로 교체
git remote add origin https://github.com/YOUR_GITHUB_USERNAME/REPO_NAME.git
git branch -M main
git push -u origin main# 예: jk0601 + aishcokr
git remote add origin https://github.com/jk0601/aishbot.git
git remote add aishco https://github.com/aishcokr/aishbot.git
git push origin main
git push aishco main
git pull/git push기본 대상은 추적 중인 remote(origin등)입니다.
Active GitHub 계정(gh auth status)은 인증(누구 권한으로) 이고, remote URL은 어디로 보낼지입니다.
이 프로젝트는 Deploy from a branch 방식을 사용합니다.
(my-ai-assistant처럼 deploy.yml + Source: GitHub Actions 가 아닙니다.)
- 저장소 → Settings → Pages
- Source: Deploy from a branch
- Branch:
main/ folder:/ (root)→ Save - 1~2분 후 Actions에
pages-build-deployment가 나타나면 배포 중 - 주소 예:
https://YOUR_GITHUB_USERNAME.github.io/REPO_NAME/
배포 확인: Settings → Pages 상단 URL, 또는 Actions의
pages-build-deployment성공(✓)
| Deploy from a branch | GitHub Actions (deploy.yml) |
|
|---|---|---|
| 설정 | 브랜치만 선택 | 워크플로 + Source를 Actions로 |
| 이 프로젝트 | 사용 중 | 없음 (정적 HTML이라 불필요) |
| URL 표시 | pages-build-deployment 실행 기록 |
deploy 워크플로 environment URL |
| 워크플로 | 주기 | cron (UTC) |
|---|---|---|
daily-collect.yml |
매일 오전 6시 (KST) | 0 21 * * * |
supports-collect.yml |
6시간마다 | 0 */6 * * * |
clean-history.yml |
매주 일요일 09:00 (KST) + 수동 | 0 0 * * 0 |
cron / 수동 실행
│
├── collector.py (또는 지원사업만)
│ → data/*.json 갱신
│
├── git commit & push
│
└── Pages(branch)가 최신 JSON 반영
- 저장소 → Actions
- 왼쪽 Daily Data Collection 또는 Supports Data Collection (6h)
- Run workflow → Run workflow
- 1~2분 후 완료 →
data/*.json커밋 확인
없음. Open-Meteo · 스크래핑 · yfinance 모두 무인증입니다.
챗봇은 data/faq.json을 검색합니다.
{
"q": "질문 내용을 자연스럽게 적으세요",
"a": "답변 내용. 여러 줄은 \\n으로 구분합니다.\n줄바꿈 예시입니다.",
"tags": ["키워드1", "키워드2", "검색될단어"]
}태그 팁
- 사용자가 칠 법한 단어·동의어를 넣습니다. (예:
클로드코드,Claude Code,Claude) - 짧고 핵심적인 단어 위주
- 새 PDF를
docs/에 넣습니다. data/faq.json을 직접 수정하거나, ChatGPT/Claude에 PDF 내용을 주고 FAQ JSON을 생성해 달라고 요청합니다.
프롬프트 예시:
아래 내용을 바탕으로 FAQ를 만들어줘.
형식: [{ "q": "...", "a": "...", "tags": ["...", "..."] }]
질문 20개 이상, 초보자도 이해할 수 있게 답변해줘.
원인: data/*.json 없음 · 형식 오류 · 로컬을 file://로 염
해결:
- Actions에서 Daily Data Collection 수동 실행
- GitHub에서
data/weather.json등 확인 - 로컬은
python -m http.server로 접속
원인: 네이버·기업마당 HTML 구조 변경
해결:
scripts/collector.py의 셀렉터 확인- 브라우저 F12로 현재 구조에 맞게 수정 후 push
원인: data/faq.json 없음 또는 JSON 문법 오류
해결: 파일 존재 확인 · jsonlint.com으로 검증
원인: Pages를 아직 안 켰거나, 이 저장소에 deploy.yml이 없음
해결: Settings → Pages → Deploy from a branch 설정
→ pages-build-deployment가 생겨야 정상
원인: Pages 미설정 · 배포 진행 중 · 저장소/경로 이름 불일치
해결:
- Settings → Pages에서
main/(root)확인 - Actions의
pages-build-deployment완료 여부 확인 (1~5분)
원인: Actions가 JSON을 커밋해 원격이 앞섬
해결:
git pull origin main
git push origin mainindex.html만 수정했다면 git add index.html로 그 파일만 커밋하면 됩니다.
pull로 들어온 JSON은 Actions 커밋이지, 내 커밋에 억지로 넣을 필요는 없습니다.
| 파일 | 역할 | 수정 빈도 |
|---|---|---|
index.html |
페이지 구조 + 챗봇 UI | UI 변경 시 |
style.css |
전체 스타일 · 챗봇 · 반응형 | 디자인 변경 시 |
script.js |
명언 · 각 섹션 JSON 렌더링 | 거의 없음 |
chatbot.js |
FAQ 검색 · 패널 열기/닫기 | 거의 없음 |
data/weather.json |
날씨·코디 (Actions) | 자동 |
data/news.json |
뉴스 (Actions) | 자동 |
data/finance.json |
시장 지수 (Actions) | 자동 |
data/bizinfo.json |
지원사업 (Actions) | 자동 |
data/faq.json |
챗봇 Q&A | 가이드 변경 시 |
docs/*.pdf |
FAQ 원본 자료 | 자료 교체 시 |
scripts/collector.py |
데이터 수집 | 셀렉터/소스 변경 시 |
daily-collect.yml |
매일 전체 수집 | 거의 없음 |
supports-collect.yml |
6시간 지원사업 수집 | 거의 없음 |
clean-history.yml |
Actions 실행 기록 정리 | 거의 없음 |
- Frontend: HTML5 · CSS3 (Custom Properties, Grid) · Vanilla JavaScript
- Data: Python 3 · requests · beautifulsoup4 · lxml · yfinance
- Hosting: GitHub Pages (Deploy from a branch)
- CI/CD: GitHub Actions (수집 · 기록 정리)
- 외부 데이터: Open-Meteo · 네이버 뉴스 · Yahoo Finance(yfinance) · 기업마당
이 프로젝트는 교육용 자료입니다.
뉴스·지원사업 등은 공개 페이지 스크래핑이며, 개인·소량 학습 목적입니다.
최신 요금·기능 정보는 각 서비스 공식 문서를 확인하세요.