rupy1014
30ebc3a871
- 프로젝트 지침 (claude.md) - 연재 계획 (blog-plan.md) - 1~3회차 블로그 글 작성 완료 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
231 lines
7.6 KiB
Markdown
231 lines
7.6 KiB
Markdown
# 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`)
|
|
- **위치**: 본문 최상단 (제목 바로 아래)
|