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 λ‘κ·ΈμΈ
- μ°μλ¨
+< 8000 /code> β 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) Β· κΈ°μ λ§λΉ
μ΄ νλ‘μ νΈλ κ΅μ‘μ© μλ£μ
λλ€.
λ΄μ€Β·μ§μμ¬μ
λ±μ κ³΅κ° νμ΄μ§ μ€ν¬λνμ΄λ©°, κ°μΈΒ·μλ νμ΅ λͺ©μ μ
λλ€.
4C5F
μ΅μ μκΈΒ·κΈ°λ₯ μ 보λ κ° μλΉμ€ 곡μ λ¬Έμλ₯Ό νμΈνμΈμ.