Claude Code로 개인 블로그를 자동화한 실전기 — 노트에서 발행까지 파이프라인
이 글은 블로그·뉴스레터를 AI로 반자동 운영하고 싶은 사람에게 유효하다. 노트 앱(Obsidian)에 생각을 쌓아두기만 했는데 발행까지 이어지지 않는 병목을 겪고 있다면 직접 도움이 된다. 이 글에서는 실제 개인 블로그 자동화 파이프라인 구성, 단계별 설정법, 그리고 반드시 사람이 개입해야 할 지점까지 구체적으로 답한다.
Claude Code로 노트에서 발행까지 블로그 파이프라인을 자동화하는 흐름을 요약한 AI 생성 대표 이미지.
전체 파이프라인은 어떻게 생겼는가?
파이프라인은 5단계로 구성된다. 각 단계는 Claude Code 워크플로우(스킬)로 묶여 순서대로 실행된다. 입력은 Obsidian 마크다운 노트이고, 출력은 발행 준비가 끝난 HTML 또는 CMS API 호출이다.
| 단계 | 하는 일 | 도구 | 사람 개입 |
|---|---|---|---|
| 1. 노트 수집 | Vault에서 주제 연관 노트 검색·병합 | Obsidian MCP / 파일시스템 읽기 | 없음 |
| 2. 초안 생성 | 문체·구조 스펙에 따라 본문 작성 | Claude Code (메인 에이전트) | 없음 |
| 3. 팩트 검증 | 수치·고유명사 웹 검색으로 교차 확인 | Claude Code + 웹검색 도구 | 결과 검토 권장 |
| 4. 포맷 변환 | 표·코드블록·FAQ·HTML 스타일 적용 | Claude Code (서브에이전트) | 없음 |
| 5. 발행 API 호출 | Blogger·WordPress REST API로 초안 push | MCP / Bash (curl) | 발행 최종 확인 |
1단계: Obsidian 노트를 어떻게 Claude Code에 연결하는가?
Obsidian Vault는 결국 로컬 마크다운 파일 모음이다. Claude Code는 파일시스템 읽기 권한만 있으면 find와 MCP 파일시스템 도구로 Vault 전체를 인덱싱할 수 있다. 주제어 기반 검색은 아래처럼 Bash 한 줄로 충분하다.
# Vault에서 '일본여행' 관련 노트를 날짜 내림차순으로 수집
find ~/Obsidian\ Vault -name '*.md' \
| xargs grep -l '일본여행' \
| sort -r \
| head -20수집된 파일 목록을 Claude Code에 컨텍스트로 넘기면, 에이전트가 각 노트를 읽어 주제를 파악하고 초안에 필요한 사실·경험 데이터를 추출한다. 이때 Obsidian 공식 로컬 REST API 플러그인을 쓰면 파일 경로 없이 검색어만으로 쿼리할 수 있어 스크립트가 더 단순해진다.
2단계: 초안 생성 스킬은 어떻게 구성하는가?
Claude Code의 '스킬'은 .claude/ 폴더 안에 마크다운 파일로 정의하는 재사용 가능한 워크플로우 단위다. 블로그 초안 생성 스킬은 문체 규칙, 출력 포맷, 필수 섹션(한줄결론·표·FAQ)을 프롬프트로 담고 있다. 한 번 작성해두면 /블로그-초안처럼 슬래시 커맨드로 재호출할 수 있다.
# .claude/skills/blog-draft.md 요약 예시
---
name: 블로그-초안
description: 노트 컨텍스트를 받아 SEO 최적화 블로그 초안 생성
---
## 지시
1. 입력: 노트 파일 목록 (절대 경로)
2. 노트를 읽어 주제 · 핵심 사실 · 수치 추출
3. 문체: ~다체, 소제목 질문형, 결론 먼저
4. 출력: 마크다운 초안 (2800~4000자)스킬 파일은 사람이 읽을 수 있는 마크다운이므로 팀이나 개인 Vault에 함께 버전관리할 수 있다. Claude Code 공식 문서에는 서브에이전트 정의법과 스킬 작성 가이드가 상세히 정리돼 있다.
3단계: 팩트 검증은 어떤 방식으로 자동화하는가?
초안이 나오면 Claude Code는 서브에이전트를 별도로 띄워 수치·고유명사·날짜를 웹에서 교차 확인한다. 2026년 5월 기준 Claude Code의 Dynamic Workflows 기능은 최대 1,000개 서브에이전트를 병렬 실행할 수 있지만, 블로그 팩트체크에는 2~3개 병렬 검색으로 충분하다. 검증 결과는 초안의 해당 문장 옆에 [검증됨] / [불확실, 출처 필요] 태그로 주석을 단다.
4~5단계: 포맷 변환과 발행 API는 어떻게 연결하는가?
초안이 검증을 통과하면 포맷 서브에이전트가 마크다운을 HTML로 변환하고, 표·코드블록·FAQ를 삽입한다. 이 HTML을 Blogger REST API 또는 WordPress REST API로 push하는 것은 curl 한 줄이면 된다.
# Blogger API로 초안 push (상태: DRAFT)
curl -s -X POST \
'https://www.googleapis.com/blogger/v3/blogs/{BLOG_ID}/posts/' \
-H 'Authorization: Bearer '"$BLOGGER_TOKEN" \
-H 'Content-Type: application/json' \
-d '{
"title": "'"$POST_TITLE"'",
"content": "'"$POST_HTML"'",
"labels": ["AI 자동화", "생산성"],
"status": "DRAFT"
}'상태를 DRAFT로 설정하면 실수로 발행되는 일을 막을 수 있다. 사람이 대시보드에서 확인 후 LIVE로 전환하는 것이 이 파이프라인의 마지막 수동 게이트다. MCP 서버를 이용하면 이 curl 호출도 Claude Code 세션 안에서 직접 실행할 수 있어 터미널 전환이 없다.
실제로 얼마나 빠른가? 시간 절감 체감
노트 수집에서 초안 완성까지 대략 5~15분이 걸린다(노트 양과 팩트 검증 쿼리 수에 따라 다름). 기존에 노트를 보고 직접 쓰던 방식은 편당 2~4시간이었는데, 파이프라인 도입 후 사람이 쓰는 시간은 최종 편집·검토에 집중된 20~40분으로 줄었다. 3개월간 개인 블로그 3채널(네이버·티스토리·Blogger)에 100편 이상을 발행하면서 얻은 대략적인 수치다. 블로그 주제·노트 밀도·품질 게이트 수준에 따라 차이가 크다.
한계와 반드시 지켜야 할 품질 게이트
파이프라인이 자동화한다는 것은 '글이 알아서 나온다'는 뜻이 아니다. 아래 3가지는 사람이 반드시 개입해야 한다.
- 수치·날짜 교차 검증: AI가 붙인 [검증됨] 태그를 맹신하지 말고, 민감한 수치는 원문 출처 직접 확인
- 개인·기밀 정보 필터: 노트에 업무 기밀이나 타인 정보가 섞이면 파이프라인이 그대로 초안에 포함시킬 수 있다. 발행 전 반드시 확인
- 문체·톤 검토: 동일 스킬로 여러 편을 생성하면 패턴이 반복된다. 주기적으로 스킬 프롬프트를 갱신하고 최종 편집에서 개성을 더해야 한다
🤖 AI·자동화 가이드 더 보기
FAQ
3줄 요약
- Obsidian 노트를 입력으로, Claude Code 스킬로 초안~발행 API까지 5단계 파이프라인 구성 가능하다.
- 팩트검증은 서브에이전트가 담당하지만 최종 확인은 반드시 사람이 한다. 발행은 항상 DRAFT 상태로 시작한다.
- 노트 밀도가 쌓일수록 파이프라인 품질이 올라간다. 자동화보다 노트 습관이 먼저다.
다음 글 예고: Claude Code 스킬 파일을 처음 작성하는 방법 — 파라미터 설계부터 재사용 패턴까지.
도구 기능은 업데이트가 잦아 공식 문서 재확인을 권한다.
댓글
댓글 쓰기