블로그 자동화, GitHub에서 받아 5단계로 세팅하는 방법

블로그 관리를 자동화하면 시간을 절약할 수 있습니다. 하지만 처음 시작하는 분들은 어디서부터 시작해야 할지 막막할 수 있습니다. 이 가이드는 코딩 경험이 없어도 따라 할 수 있도록 설계되었습니다. GitHub에서 자동화 코드를 받아 기본 설정을 마치는 과정을 5단계로 설명하겠습니다.

1. 블로그 자동화 파이프라인이란 무엇인가요?

블로그 자동화 파이프라인은 블로그 글 작성, 발행, 공유 등의 반복적인 작업을 자동으로 처리하는 시스템입니다. 한 번 설정하면 매일 정해진 시간에 자동으로 글이 발행되고, 뉴스를 수집하며, SNS에 공유됩니다.

첫째, Python 에이전트입니다. 이는 글 수집, 요약, 발행 등의 작업을 수행하는 프로그램입니다. 둘째, API 키 관리입니다. Claude, Naver, Telegram 등의 서비스를 연결하기 위해 각 플랫폼의 API 키를 안전하게 보관해야 합니다. 셋째, 자동화 스케줄러입니다. LaunchAgent를 사용해 매일 특정 시간에 자동으로 실행되도록 설정합니다.

많은 분들이 파이프라인 구축을 실패하는 이유는 세 가지입니다. 첫 번째는 한 번에 모든 기능을 만들려고 시도하는 것입니다. 두 번째는 프롬프트만 튜닝하고 기본 구조는 무시하는 것입니다. 세 번째는 규칙 없이 무작정 시작하는 것입니다. 이 가이드는 이런 실수를 피하도록 설계되었습니다.

2. 개발 환경 준비하기

Python 설치는 자동화의 첫 번째 단계입니다. macOS 사용자라면 Homebrew를 통해 설치하시면 됩니다. Windows 사용자는 Python 공식 사이트에서 직접 설치할 수 있습니다.

python3 --version

다음은 가상 환경(venv)을 생성하는 단계입니다. 가상 환경은 프로젝트별로 독립적인 Python 라이브러리를 관리할 수 있게 해줍니다. 작업 폴더에서 아래 명령어를 실행하세요:

python3 -m venv blog_automation_env
source blog_automation_env/bin/activate

pip install requests beautifulsoup4 python-dotenv anthropic

이 네 가지 라이브러리가 기본입니다. requests는 웹에서 데이터를 가져오고, beautifulsoup4는 HTML을 파싱하며, python-dotenv는 API 키를 안전하게 관리합니다. anthropic은 Claude API를 사용하기 위한 라이브러리입니다.

3. API 키 설정과 관리

API 키 설정은 자동화 파이프라인의 심장입니다. 잘못된 관리는 보안 위협으로 이어질 수 있습니다. 반드시 .env 파일을 생성해 환경변수로 관리하세요.

프로젝트 폴더의 최상단에 .env 파일을 만들고 아래와 같이 작성합니다:

CLAUDE_API_KEY=your_claude_api_key_here
NAVER_CLIENT_ID=your_naver_id_here
NAVER_CLIENT_SECRET=your_naver_secret_here
TELEGRAM_BOT_TOKEN=your_telegram_token_here

각 API 키를 어떻게 구하는지 설명하겠습니다. Claude API 키는 console.anthropic.com에서 회원가입 후 API 섹션에서 발급받습니다. Naver는 developers.naver.com에서 애플리케이션을 등록하면 클라이언트 ID와 Secret을 얻을 수 있습니다. Telegram 봇 토큰은 Telegram의 BotFather에서 /newbot 명령어로 생성합니다.

from dotenv import load_dotenv
import os

load_dotenv()
claude_api_key = os.getenv('CLAUDE_API_KEY')

절대로 .env 파일을 GitHub에 올리지 마세요. .gitignore에 .env를 추가해 버전 관리에서 제외하세요. 이것이 API 키 보안의 기본 원칙입니다.

4. 첫 번째 에이전트 만들고 실행하기

에이전트는 자동화 작업을 수행하는 프로그램입니다. 복잡해 보이지만, 기본 구조는 간단합니다. BaseAgent라는 부모 클래스를 상속받아 만듭니다.

GitHub의 harness-engineering-guide 저장소에서 기본 에이전트 코드를 받아올 수 있습니다. 주소는 github.com/alice840126-ship-it/harness-engineering-guide 입니다. 이 저장소에는 telegram_sender, news_scraper, obsidian_writer 등 이미 완성된 에이전트들이 있습니다.

초보자를 위한 첫 에이전트는 HelloAgent입니다. 이 에이전트는 단순히 메시지를 출력하는 기능을 합니다. 코드는 다음과 같습니다:

from base_agent import BaseAgent

class HelloAgent(BaseAgent):
    def execute(self):
        print("블로그 자동화가 시작되었습니다!")
        return {"status": "success"}

if __name__ == "__main__":
    agent = HelloAgent()
    agent.execute()

python3 hello_agent.py

성공하면 "블로그 자동화가 시작되었습니다!"라는 메시지가 출력됩니다. 이제 뉴스 수집 에이전트를 추가할 수 있습니다. NewsScraper 에이전트는 이미 완성되어 있으므로 다운로드해서 바로 사용하면 됩니다.

5. 자동화 스케줄 설정하기

한 번 설정한 에이전트를 매일 자동으로 실행하려면 LaunchAgent를 사용해야 합니다. LaunchAgent는 macOS의 스케줄러로, plist 파일을 통해 특정 시간에 프로그램을 실행합니다.

~/.config/launchd/로 이동해 blog_automation.plist 파일을 생성하세요:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.user.blog-automation</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/bin/python3</string>
        <string>/Users/username/blog_automation/hello_agent.py</string>
    </array>
    <key>StartCalendarInterval</key>
    <dict>
        <key>Hour</key>
        <integer>7</integer>
        <key>Minute</key>
        <integer>0</integer>
    </dict>
</dict>
</plist>

이 설정은 매일 오전 7시에 hello_agent.py를 실행합니다. 경로는 자신의 환경에 맞게 수정하세요.

launchctl load ~/.config/launchd/blog_automation.plist

log show --predicate 'process == "python3"' --last 1h

만약 에러가 나면 /tmp/blog_automation.log 파일을 확인해 문제를 파악할 수 있습니다.

6. 자주 묻는 질문과 해결법

안타깝게도 Python은 필수입니다. 하지만 설치 과정은 단 5분이면 충분합니다. Homebrew가 설치되어 있다면 brew install python3 명령어 하나로 끝납니다.

이 에러는 필요한 라이브러리가 설치되지 않았다는 의미입니다. pip install requests beautifulsoup4 python-dotenv anthropic를 다시 실행하세요.

.env 파일이 프로젝트 폴더에 정확하게 위치했는지 확인하세요. 또한 load_dotenv() 함수가 코드 상단에 있어야 합니다.

그렇습니다. LaunchAgent를 올바르게 설정했다면, macOS가 켜져 있는 동안 매일 정해진 시간에 자동으로 실행됩니다. 컴퓨터가 꺼져 있으면 실행되지 않으니 유의하세요.

마치며

블로그 자동화 파이프라인 세팅은 어렵지 않습니다. 이 5단계 가이드를 따르면 누구나 시작할 수 있습니다. 환경 준비 → 라이브러리 설치 → API 키 관리 → 에이전트 실행 → 자동화 스케줄 설정, 이렇게 순서대로 진행하세요.

처음에는 HelloAgent처럼 간단한 에이전트부터 시작하세요. 성공 경험이 쌓이면 뉴스 수집, 글 요약, SNS 공유 등으로 확장할 수 있습니다. 자동화의 핵심은 복잡함이 아니라 규칙과 반복입니다.

질문이 있거나 에러가 발생했을 때는 당황하지 마세요. 에러 메시지를 자세히 읽고 이 가이드의 문제 해결 섹션을 참고하면 해결할 수 있습니다. 블로그 자동화 여정을 응원합니다.

#블로그자동화 #세팅가이드 #초보자 #파이프라인 #자동화 #Python #GitHub #API키 #자동화도구 #블로그수익화 #하네스엔지니어링 #MCP #LaunchAgent #자동화아키텍처 #개발자블로그