Ex1-my-blog/claude.md

AI 활용법 블로그 프로젝트 지침

프로젝트 개요

이 프로젝트는 일반인을 위한 AI 활용법 블로그입니다. AI를 처음 접하는 사람들이 쉽게 따라할 수 있도록 실용적인 가이드를 연재합니다.

배포 정보

• 플랫폼: 네이버 블로그
• 블로그 주소: https://blog.naver.com/smartrupy
• 글쓰기 URL: https://blog.naver.com/smartrupy/postwrite
• 배포 방식: Playwright 브라우저로 자동 배포
• 로그인 정보: .env 파일 참조

자동 발행 프로세스

글 작성 요청 시 자동으로 다음 단계를 수행:

1. 글 작성 → posts/ 폴더에 마크다운 파일 저장
2. ⚠️ 대표 이미지 준비 → Unsplash에서 관련 이미지 다운로드 (필수!)
3. 자동 로그인 → .env 파일에서 로그인 정보 읽어서 로그인
4. 글쓰기 페이지 이동 → https://blog.naver.com/smartrupy/postwrite
5. ⚠️ 이미지 첨부 → "사진" 버튼 클릭하여 대표 이미지 업로드 (필수!)
6. 제목/본문 입력 → 키보드 입력 방식으로 입력
7. 발행 → 발행 버튼 클릭하여 즉시 발행

⚠️ 중요: 이미지 없는 글은 절대 발행하지 않는다. 모든 글에는 반드시 1장 이상의 대표 이미지가 포함되어야 한다.

.env 파일 구조

NAVER_BLOG_URL=https://blog.naver.com/smartrupy
NAVER_LOGIN_ID=아이디
NAVER_LOGIN_PASSWORD=비밀번호

네이버 블로그 입력 방법 (Playwright)

네이버 스마트에디터는 JavaScript 직접 조작이 안 되므로 키보드 입력 방식 사용:

// 1. 로그인 (이미 로그인된 세션이 있으면 스킵)
const frame = page.locator('iframe[name="mainFrame"]').contentFrame();

// 2. 제목 입력
await frame.locator('.se-title-text').click();
await page.keyboard.type('제목 내용', { delay: 10 });

// 3. 본문 입력
await frame.locator('.se-component-content').first().click();
await page.keyboard.type('본문 내용', { delay: 5 });

// 4. 발행 버튼 클릭
await frame.getByRole('button', { name: '발행' }).click();
await frame.getByTestId('seOnePublishBtn').click();

본문 포맷팅 규칙

마크다운을 네이버 블로그용으로 변환:

• #, ##, ### → ■ 소제목으로 변환
• -, * 리스트 → • 불릿으로 변환
• **굵은글씨** → 그대로 텍스트로 (서식 제거)
• 코드블록 → 인용구 또는 일반 텍스트로
• 해시태그는 본문 마지막에 #태그1 #태그2 형식으로 추가

주의사항

• textContent 직접 수정은 에디터가 인식 못 함
• 제목과 본문 사이 클릭 위치 주의 (제목 영역에서 본문이 입력될 수 있음)
• 로그인 세션이 만료되면 재로그인 필요

블로거 페르소나

• 말투: 평어(반말) 사용, 단 독자를 존중하는 태도 유지
  • 좋은 예: "이건 정말 유용해", "한번 따라해봐", "어렵지 않아"
  • 나쁜 예: "이것도 모르냐", "당연한 거잖아" (비하/무시 금지)
• 톤: 친근하고 편한 친구가 알려주는 느낌
• 관점: AI 전문가가 아닌, AI를 직접 써보며 배워가는 동료의 시선
• 목표: 독자가 글을 읽고 바로 따라할 수 있는 실용적인 콘텐츠

말투 예시

경어체 (X)	평어체 (O)
~해보세요	~해봐
~입니다	~야, ~이야
~하시면 됩니다	~하면 돼
감사합니다	고마워
어려우시면	어려우면

콘텐츠 가이드라인

타겟 독자

• AI를 처음 접하는 일반인 (20~50대)
• 직장인, 대학생, 자영업자, 콘텐츠 크리에이터
• 기술 배경 없이도 이해할 수 있어야 함

작성 원칙

1. 쉬운 용어: 전문 용어는 괄호 안에 쉬운 설명 추가

   • 예: "프롬프트(AI에게 보내는 질문이나 명령)"

2. 단계별 설명: 모든 과정을 스크린샷 수준으로 상세하게

   • "설정 > 일반 > 언어 선택" 처럼 경로 명시

3. 실습 예제: 복사해서 바로 쓸 수 있는 프롬프트 템플릿 제공

4. 주의사항 명시: AI 사용 시 주의점 (개인정보, 팩트체크 등)

글 구조 템플릿

# [회차] 제목

> 한 줄 요약

## 이 글에서 배울 것
- 포인트 1
- 포인트 2
- 포인트 3

## 준비물
- 필요한 도구/계정 목록

## 본문
### 1단계: ...
### 2단계: ...
### 3단계: ...

## 실전 활용 팁
> 꿀팁 박스

## 주의사항
- 주의점 1
- 주의점 2

## 마무리
다음 글 예고

---
*프롬프트 템플릿은 복사해서 바로 사용하세요*

연재 계획

blog-plan.md 파일을 참조하여 다음 시리즈를 순서대로 연재합니다:

1. 시리즈 1: AI 입문편 (1~5회)
2. 시리즈 2: 일상 활용편 (6~11회)
3. 시리즈 3: 업무 활용편 (12~16회)

파일 구조

/my-blog
├── claude.md          # 이 지침 파일
├── blog-plan.md       # 연재 아웃라인
└── posts/             # 블로그 글 저장
    ├── 01-ai-intro.md
    ├── 02-chatgpt-start.md
    └── ...

작업 요청 시 참고

• 새 글 작성 요청 시: blog-plan.md의 해당 회차 내용을 기반으로 작성
• 글 수정 요청 시: 기존 글의 톤앤매너 유지
• 프롬프트 예시 추가 시: 실제로 테스트해본 것처럼 구체적으로

품질 체크리스트

글 작성 완료 후 확인:

• 전문 용어에 쉬운 설명이 있는가?
• 단계별 설명이 충분히 상세한가?
• 복사해서 쓸 수 있는 프롬프트가 있는가?
• 주의사항을 명시했는가?
• 다음 글 예고가 있는가?

SEO 체크리스트

네이버 블로그 검색 노출 최적화:

⚠️ 필수 항목 (발행 전 반드시 확인)

항목	설명	중요도
대표 이미지	본문 최상단에 관련 이미지 1장 (썸네일로 사용됨)	🔴 필수
제목 키워드	제목에 핵심 키워드 포함 (예: "AI", "ChatGPT", "활용법")	🔴 필수
첫 문장 훅	본문 첫 문장에 핵심 메시지/키워드 포함	🔴 필수
해시태그	5개 이상, 관련 키워드로 구성	🔴 필수

🚨 경고: 위 4가지 항목 중 하나라도 빠지면 발행하지 않는다! 특히 대표 이미지는 무조건 1장 이상 첨부해야 한다.

권장 항목

• 소제목(■)에 키워드 포함
• 본문 길이 1,500자 이상
• 내부 링크 (이전/다음 글 연결)
• 이미지 alt 텍스트 (네이버는 파일명 참조)

🖼️ 이미지 첨부 가이드 (필수)

1. 이미지 다운로드 (Unsplash 무료 이미지)

# 예시: AI 관련 이미지 다운로드
curl -L "https://images.unsplash.com/photo-1677442136019-21780ecad995?w=1200" -o /tmp/blog-image.jpg

2. 키워드별 추천 Unsplash 검색어

글 주제	검색어
AI 입문	artificial intelligence, robot, technology
ChatGPT	chat, conversation, typing
이미지 생성	digital art, creative, design
업무 활용	office, productivity, laptop

3. Playwright로 이미지 업로드

// 사진 버튼 클릭
await frame.getByRole('button', { name: '사진 추가' }).click();
// 파일 업로드
await page.locator('input[type="file"]').setInputFiles('/tmp/blog-image.jpg');

4. 이미지 요구사항

• 크기: 가로 1200px 이상 권장
• 파일명: 키워드 포함 (예: chatgpt-guide-image.jpg)
• 위치: 본문 최상단 (제목 바로 아래)