# 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 직접 조작이 안 되므로 **키보드 입력 방식** 사용:

```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 사용 시 주의점 (개인정보, 팩트체크 등)

### 글 구조 템플릿

```markdown
# [회차] 제목

> 한 줄 요약

## 이 글에서 배울 것
- 포인트 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 무료 이미지)**
```bash
# 예시: 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로 이미지 업로드**
```javascript
// 사진 버튼 클릭
await frame.getByRole('button', { name: '사진 추가' }).click();
// 파일 업로드
await page.locator('input[type="file"]').setInputFiles('/tmp/blog-image.jpg');
```

**4. 이미지 요구사항**
- **크기**: 가로 1200px 이상 권장
- **파일명**: 키워드 포함 (예: `chatgpt-guide-image.jpg`)
- **위치**: 본문 최상단 (제목 바로 아래)