blog-writer/README.md

블로그 자동 수익 엔진 (Blog Auto Revenue Engine)

AI 기반 한국어 블로그 자동화 시스템. 트렌드 수집 → AI 글 작성 → 자동 발행 → 수익 링크 삽입 → 성과 분석까지 전 과정을 자동화합니다.

Phase 1 목표: Google Blogger 블로그 1개로 시작해 검색 자산 축적 + AdSense 승인

---

목차

1. 시스템 구조
2. 사전 준비
3. 설치 방법
4. API 키 설정
5. Google OAuth 인증
6. 실행하기
7. Telegram 명령어
8. 이미지 모드 선택
9. 콘텐츠 코너 구성
10. Phase 로드맵
11. 자주 묻는 질문

---

시스템 구조

봇 레이어 (Python)          AI 레이어 (OpenClaw)
─────────────────           ────────────────────
수집봇                       blog-writer 에이전트
  └─ 트렌드 수집               └─ 글감 → 완성 글 작성
  └─ 품질 점수 계산
  └─ 폐기 규칙 적용
          │
          ▼
발행봇 ── 링크봇 ── 이미지봇
  └─ 안전장치        └─ 만평 이미지
  └─ Blogger 발행
  └─ Search Console
          │
          ▼
분석봇 → Telegram 리포트
스케줄러 → 모든 봇 시간 관리

파일 구조

blog-writer/
├── bots/
│   ├── collector_bot.py    ← 수집봇 (Google Trends, GitHub, HN, RSS)
│   ├── publisher_bot.py    ← 발행봇 (Blogger API + 안전장치)
│   ├── linker_bot.py       ← 링크봇 (쿠팡 파트너스)
│   ├── analytics_bot.py    ← 분석봇 (5대 핵심 지표)
│   ├── image_bot.py        ← 이미지봇 (만평 3가지 모드)
│   ├── scheduler.py        ← 스케줄러 + Telegram 봇
│   └── article_parser.py   ← OpenClaw 출력 파서
├── config/
│   ├── blogs.json          ← 블로그 ID 설정
│   ├── schedule.json       ← 발행 시간표
│   ├── sources.json        ← 수집 소스 목록
│   ├── affiliate_links.json← 어필리에이트 링크 DB
│   ├── quality_rules.json  ← 품질 점수 기준
│   └── safety_keywords.json← 안전장치 키워드
├── data/                   ← 런타임 데이터 (gitignore)
├── scripts/
│   ├── get_token.py        ← Google OAuth 토큰 발급
│   └── setup.bat           ← Windows 설치 스크립트
├── .env.example            ← 환경변수 템플릿
└── requirements.txt

---

사전 준비

필수

• Python 3.11 이상 — python.org
• Git — git-scm.com
• Google 계정 — Blogger 블로그 운영용
• Telegram 계정 — 봇 알림 수신용
• OpenClaw — AI 글 작성 에이전트 (ChatGPT Pro 구독 필요)

선택

• 쿠팡 파트너스 계정 — 링크 수익화용
• OpenAI API Key — 이미지 자동 생성 모드 사용 시

---

설치 방법

1. 저장소 클론

git clone https://github.com/sinmb79/blog-writer.git
cd blog-writer

2. 설치 스크립트 실행 (Windows)

탐색기에서 scripts\setup.bat 더블클릭 또는:

scripts\setup.bat

스크립트가 자동으로 처리하는 것:

• Python 가상환경(venv) 생성
• 패키지 설치 (requirements.txt)
• .env 파일 생성 (.env.example 복사)
• data/, logs/ 폴더 생성
• Windows 작업 스케줄러에 자동 시작 등록

3. 수동 설치 (선택)

python -m venv venv
venv\Scripts\activate      # Windows
pip install -r requirements.txt
copy .env.example .env

---

API 키 설정

.env 파일을 열고 아래 항목을 입력합니다.

# ─── Google (필수) ───────────────────────────────────
GOOGLE_CLIENT_ID=         # Google Cloud Console에서 발급
GOOGLE_CLIENT_SECRET=     # Google Cloud Console에서 발급
GOOGLE_REFRESH_TOKEN=     # scripts/get_token.py 실행 후 입력
BLOG_MAIN_ID=             # Blogger 대시보드 URL에서 확인

# ─── 쿠팡 파트너스 (선택, 링크 수익화) ────────────────
COUPANG_ACCESS_KEY=
COUPANG_SECRET_KEY=

# ─── Telegram (필수, 알림 수신) ──────────────────────
TELEGRAM_BOT_TOKEN=       # @BotFather에서 발급
TELEGRAM_CHAT_ID=         # @userinfobot에서 확인

# ─── 이미지 모드 ─────────────────────────────────────
IMAGE_MODE=manual          # manual | request | auto

# ─── Search Console (선택) ───────────────────────────
BLOG_SITE_URL=            # 예: https://your-blog.blogspot.com/

# ─── OpenAI (auto 모드만 필요) ───────────────────────
OPENAI_API_KEY=

BLOG_MAIN_ID 확인 방법

Blogger 관리자 페이지(blogger.com)에서 블로그를 선택한 뒤 브라우저 주소창을 확인합니다:

https://www.blogger.com/blog/posts/XXXXXXXXXXXXXXXXXX
                                   ↑ 이 숫자가 BLOG_MAIN_ID

Telegram 설정 방법

1. Telegram에서 @BotFather 검색 → /newbot 명령 → 봇 생성 → Token 복사
2. 생성한 봇과 대화 시작 → @userinfobot에 메시지 → Chat ID 확인

---

Google OAuth 인증

1. Google Cloud Console 설정

1. console.cloud.google.com 접속
2. 새 프로젝트 생성
3. API 및 서비스 → 라이브러리 에서 아래 두 API 활성화:
   • Blogger API v3
   • Google Search Console API
4. 사용자 인증 정보 → OAuth 클라이언트 ID 만들기
   • 애플리케이션 유형: 데스크톱 앱
5. credentials.json 다운로드 → 프로젝트 루트(blog-writer/)에 저장

2. 토큰 발급

venv\Scripts\activate
python scripts\get_token.py

브라우저가 열리면 Google 계정으로 로그인 → 권한 허용 터미널에 출력된 REFRESH_TOKEN 값을 .env의 GOOGLE_REFRESH_TOKEN에 붙여넣기

---

실행하기

스케줄러 시작 (메인 프로세스)

venv\Scripts\activate
python bots\scheduler.py

각 봇 단독 테스트

# 수집봇 테스트 (글감 수집)
python bots\collector_bot.py

# 분석봇 테스트 (일일 리포트)
python bots\analytics_bot.py

# 분석봇 주간 리포트
python bots\analytics_bot.py weekly

# 이미지 프롬프트 배치 전송 (request 모드)
python bots\image_bot.py batch

자동 시작 확인 (Windows)

작업 스케줄러(taskschd.msc)에서 BlogEngine 작업이 등록되어 있으면 PC 시작 시 자동 실행됩니다.

---

일일 자동 플로우

시간	작업
07:00	수집봇 — 트렌드 수집 + 품질 점수 계산 + 폐기 필터링
08:00	AI 글 작성 트리거 (OpenClaw 서브에이전트)
09:00	발행봇 — 첫 번째 글 발행
12:00	발행봇 — 두 번째 글 발행
15:00	발행봇 — 세 번째 글 (선택)
22:00	분석봇 — 일일 리포트 → Telegram 전송
매주 일요일 22:30	분석봇 — 주간 리포트
매주 월요일 10:00	이미지봇 — 프롬프트 배치 전송 (request 모드)

---

Telegram 명령어

텍스트 명령 (키보드로 입력)

명령	설명
발행 중단	자동 발행 일시 중지
발행 재개	자동 발행 재개
오늘 수집된 글감 보여줘	오늘 수집된 글감 목록
대기 중인 글 보여줘	수동 검토 대기 글 목록
이번 주 리포트	주간 리포트 즉시 생성
이미지 목록	이미지 제작 현황

슬래시 명령

명령	설명
/status	봇 상태 + 이미지 모드 확인
/approve [번호]	수동 검토 글 승인 후 발행
/reject [번호]	수동 검토 글 거부
/images	이미지 제작 대기/진행/완료 현황
/imgpick [번호]	해당 번호 이미지 프롬프트 받기
/imgbatch	프롬프트 배치 수동 전송
/imgcancel	이미지 대기 상태 취소

---

이미지 모드 선택

.env의 IMAGE_MODE 값으로 선택합니다.

manual (기본)

한컷 코너 글 발행 시점에 프롬프트 1개를 Telegram으로 전송. 사용자가 직접 이미지를 생성해 data/images/ 에 파일 저장.

request (권장)

매주 월요일 10:00 대기 중인 프롬프트 목록을 Telegram으로 일괄 전송.

사용 흐름:

1. 봇이 프롬프트 목록 전송 (또는 /imgbatch 수동 트리거)
2. /imgpick 3 — 3번 프롬프트 전체 내용 수신
3. 프롬프트 복사 → Midjourney / DALL-E 웹 / Stable Diffusion 등에 붙여넣기
4. 생성된 이미지를 Telegram으로 전송 (캡션에 #3 입력 또는 /imgpick 후 바로 전송)
5. 봇이 자동 저장 + 완료 처리

auto

OpenAI DALL-E 3 API를 직접 호출해 자동 생성. OPENAI_API_KEY 필요. 이미지당 $0.04–0.08 비용 발생 (ChatGPT Pro 구독과 별도).

---

콘텐츠 코너 구성

코너	컨셉	발행 빈도
쉬운 세상	AI/테크를 누구나 따라할 수 있게	주 2–3회
숨은 보물	모르면 손해인 무료 도구 발굴	주 2–3회
바이브 리포트	비개발자가 AI로 만든 실제 사례	주 1–2회
팩트체크	과대광고/거짓 주장 검증 (수동 승인 필수)	주 1회 이하
한 컷	AI/테크 이슈 만평	주 1회

안전장치 (자동 발행 차단 조건)

아래 조건에 해당하면 자동 발행 대신 Telegram으로 수동 검토 요청:

• 팩트체크 코너 글 전체
• 암호화폐/투자/법률 관련 위험 키워드 감지
• 출처 2개 미만
• 품질 점수 75점 미만

---

OpenClaw 서브에이전트 설정

~/.openclaw/ 디렉토리에 아래 파일을 배치합니다:

~/.openclaw/
├── agents/
│   ├── main/AGENTS.md              ← 에이전트 관리 규칙
│   └── blog-writer/SOUL.md         ← 글쓰기 에이전트 설정
└── workspace-blog-writer/
    ├── personas/tech_insider.md    ← 테크인사이더 페르소나
    ├── corners/                    ← 5개 코너 설정 파일
    └── templates/output_format.md  ← 출력 포맷 템플릿

이 파일들은 설치 시 ~/.openclaw/ 에 수동으로 복사해야 합니다. (OpenClaw 설정 완료 후 scheduler.py의 _call_openclaw() 함수를 실제 호출 코드로 교체)

---

Phase 로드맵

Phase	기간	목표	예상 수익
1	Month 1–3	블로그 1개, 시스템 검증, AdSense 승인	0–5만원/월
2	Month 3–5	블로그 2개, 쿠팡 수익 집중	5–20만원/월
3	Month 5–8	3–4개 블로그, 어필리에이트 추가	10–50만원/월
4	Month 8+	영문 블로그, 글로벌 확장	30–100만원+/월

---

자주 묻는 질문

Q. ChatGPT Pro 없이도 사용할 수 있나요? A. 봇 레이어(수집/발행/링크/분석)는 ChatGPT 없이 동작합니다. 글 작성(AI 레이어)만 OpenClaw + ChatGPT Pro를 사용합니다. 다른 LLM으로 교체하려면 scheduler.py의 _call_openclaw() 함수를 수정하세요.

Q. Blogger 외 다른 플랫폼을 사용할 수 있나요? A. publisher_bot.py의 publish_to_blogger() 함수를 교체하면 WordPress, 티스토리 등으로 변경 가능합니다.

Q. Windows가 아닌 환경에서 사용하려면? A. setup.bat 대신 수동으로 venv를 생성하고 패키지를 설치하세요. scheduler.py는 크로스 플랫폼으로 동작합니다. Windows 작업 스케줄러 등록 부분만 Linux cron 또는 macOS launchd로 대체하세요.

Q. 수집봇이 아무것도 가져오지 못해요. A. config/sources.json의 RSS URL이 유효한지 확인하세요. Google Trends는 간혹 요청 제한이 걸릴 수 있으며, 이 경우 pytrends 관련 로그를 확인하세요.

---

라이선스

MIT License — 자유롭게 사용, 수정, 배포 가능합니다.