viruagent 1.0.0

package/.claude/commands/viruagent-post.md

@@ -0,0 +1,36 @@
+---
+description: Generate and publish a blog post with ViruAgent
+allowed-tools: Bash, AskUserQuestion
+---
+
+# ViruAgent Blog Posting
+
+Generate an AI blog post on the user's requested topic and publish it to Tistory.
+
+Topic: $ARGUMENTS
+
+## Workflow
+
+1. First, fetch the category list:
+```bash
+node src/cli-post.js --list-categories
+```
+
+2. Parse the category list result and use AskUserQuestion to ask the user:
+   - **Category**: Select from the fetched category list (present as options)
+   - **Visibility**: Choose between public / private / protected
+   - **Publish mode**: Publish now / Save as draft / Preview only (dry-run)
+
+3. Run the CLI script based on the user's selections:
+```bash
+node src/cli-post.js --topic "$ARGUMENTS" --category [SELECTED_ID] --visibility [SELECTED_VALUE] [--draft] [--dry-run]
+```
+
+4. Parse the JSON output and display the result to the user:
+   - On success: Show title, tags, and URL (if published)
+   - On failure: Show error message
+
+## Important Notes
+- If `$ARGUMENTS` is empty, use AskUserQuestion to ask for the topic first
+- Only parse JSON output (last line of stdout)
+- On error, inform the user of the cause and suggest a solution

package/.env.example

@@ -0,0 +1,2 @@
+OPENAI_API_KEY=sk-your-api-key-here
+UNSPLASH_ACCESS_KEY=

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tkman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,194 @@
+<img width="525" height="113" alt="image" src="https://github.com/user-attachments/assets/8bbd21d3-5f14-4d11-933d-17bdf6969ebf" />
+
+
+# ViruAgent
+
+> 터미널에서 티스토리 블로그 글을 만들고, 다듬고, 발행하는 CLI 도구
+
+티스토리 API를 역분석해서 OpenAI와 엮었습니다.
+글감 잡기 → 초안 생성 → 수정 → 발행까지 터미널 안에서 끝납니다.
+
+공식 API가 아닌 비공식 내부 통신을 쓰기 때문에, 학습/실험 용도로 만들었습니다.
+
+---
+
+## 뭘 할 수 있나
+
+- **AI 대화로 글쓰기** — 챗처럼 대화하면서 아이디어를 다듬고, `/write`로 초안을 뽑고, `/edit`로 고칩니다.
+- **Unsplash 이미지 자동 삽입** — 글 생성 시 주제에 맞는 이미지를 자동 검색하고 티스토리에 업로드합니다. 첫 번째 이미지가 썸네일로 설정됩니다.
+- **브라우저 로그인으로 세션 관리** — OAuth 설정 없이 Playwright로 실제 로그인해서 쿠키를 가져옵니다.
+- **유연한 글 구조** — 5가지 글 유형(튜토리얼, 비교/리뷰, 리스트, 정보 가이드, 인사이트)을 AI가 주제에 맞게 자율 선택합니다.
+- **CLI UX** — 커맨드 힌트, 화살표 키 메뉴, 상태바 등을 넣어서 터미널에서도 불편하지 않게 만들었습니다.
+- **HTML 유지하면서 수정** — 글 구조를 깨뜨리지 않고 특정 부분만 고치거나 말투를 바꿀 수 있습니다.
+
+---
+
+## 시작하기
+
+**필요한 것**: Node.js 18+, OpenAI API Key
+
+```bash
+git clone https://github.com/your-username/viruagent.git
+cd viruagent
+npm install
+cp .env.example .env
+# .env 파일 편집
+npm start
+```
+
+### 환경 변수
+
+| 변수 | 필수 | 설명 |
+|------|------|------|
+| `OPENAI_API_KEY` | O | OpenAI API 키 |
+| `UNSPLASH_ACCESS_KEY` | X | Unsplash API 키 (없으면 이미지 삽입 건너뜀) |
+
+Unsplash API 키는 [unsplash.com/developers](https://unsplash.com/developers)에서 무료로 발급받을 수 있습니다. (시간당 50회 제한)
+
+---
+
+## 명령어
+
+<img width="547" height="441" alt="image" src="https://github.com/user-attachments/assets/bda2730d-d055-4872-b2b9-e24aeb7d5fd9" />
+
+---
+
+
+
+| 명령어          | 설명                                         |
+| --------------- | -------------------------------------------- |
+| `/write <주제>` | AI가 블로그 글 초안 생성                     |
+| `/edit <지시>`  | 초안 수정 ("더 친근하게 바꿔줘" 같은 식으로) |
+| `/preview`      | 작성 중인 글 미리보기                        |
+| `/publish`      | 글 발행                                      |
+| `/set`          | 카테고리, 공개 설정, 모델, 말투 변경         |
+| `/list`         | 최근 발행 글 목록                            |
+| `/login`        | 티스토리 세션 갱신                           |
+| `/logout`        | 티스토리 세션 삭제                           |
+
+---
+
+## Claude Code로 글쓰기
+
+[Claude Code](https://claude.com/claude-code)에서 자연어로 명령할 수 있습니다.
+
+```
+> viruagent로 블로그에 글 아무거나 써줘 카테고리는 "기타"
+```
+
+<img width="1054" height="896" alt="image" src="https://github.com/user-attachments/assets/9e30e0ed-32f9-41a4-b39f-e4e6863d5d2d" />
+
+
+
+카테고리, 공개 여부, 발행 방식을 물어본 뒤 AI가 글을 생성해서 티스토리에 발행합니다.
+
+
+### 직접 CLI로 실행
+
+```bash
+# 카테고리 목록 조회
+node src/cli-post.js --list-categories
+
+# 글 생성 + 발행
+node src/cli-post.js --topic "주제" --category 1247460 --visibility public
+
+# 미리보기만 (발행 안 함)
+node src/cli-post.js --topic "주제" --dry-run
+
+# 임시저장
+node src/cli-post.js --topic "주제" --draft
+```
+
+---
+
+## Unsplash 이미지 연동
+
+글 생성 시 본문에 `<!-- IMAGE: keyword -->` 플레이스홀더가 자동 삽입됩니다. `UNSPLASH_ACCESS_KEY`가 설정되어 있으면:
+
+1. 키워드로 Unsplash에서 이미지 검색
+2. 이미지 다운로드 → 티스토리에 업로드
+3. 티스토리 네이티브 이미지 치환자(`[##_Image|kage@..._##]`)로 변환
+4. **첫 번째 이미지가 자동으로 글 썸네일(대표 이미지)로 설정**
+
+키가 없으면 이미지 처리를 건너뛰고 글만 발행합니다.
+
+---
+
+## 시스템 프롬프트 커스터마이징
+
+글의 톤, 구조, HTML 스타일은 `config/system-prompt.md`에서 수정할 수 있습니다.
+
+```
+config/
+├── prompt-config.json   # 모델, 말투, 이미지 설정
+└── system-prompt.md     # AI 글쓰기 규칙 (글 유형, HTML 레퍼런스, 톤)
+```
+
+### 글 유형 (AI가 주제에 맞게 자율 선택)
+
+| 유형 | 구조 |
+|------|------|
+| 튜토리얼 | 준비물 → 단계 → 결과 확인 → 트러블슈팅 |
+| 비교/리뷰 | 비교 테이블 + 장단점 → 추천 |
+| 리스트 | 번호 소제목 + 항목별 팁 |
+| 정보 가이드 | 문제 → 원인 → 해결 → FAQ |
+| 인사이트 | 화두 → 근거 → 시사점 → 액션 |
+
+### prompt-config.json 설정
+
+```json
+{
+  "defaultModel": "gpt-4o-mini",
+  "defaultTone": "정보전달",
+  "defaultLength": 2500,
+  "imageSource": "unsplash",
+  "imagesPerPost": 3
+}
+```
+
+---
+
+## 로그
+
+실행 로그가 `logs/` 폴더에 날짜별로 기록됩니다.
+
+```
+logs/
+└── 2026-02-11.log
+```
+
+이미지 업로드 실패, API 오류 등의 디버깅에 활용할 수 있습니다.
+
+```
+[10:30:15.123] [INFO] [unsplash] 이미지 플레이스홀더 3개 발견
+[10:30:16.456] [INFO] [unsplash] Unsplash 이미지 찾음 | {"keyword":"laptop"}
+[10:30:17.789] [INFO] [tistory] 이미지 업로드 성공 | {"url":"https://blog.kakaocdn.net/..."}
+[10:30:17.800] [ERROR] [tistory] 이미지 업로드 실패 | {"status":500}
+```
+
+---
+
+## 기술 스택
+
+- **런타임**: Node.js (CommonJS)
+- **AI**: OpenAI SDK
+- **이미지**: Unsplash API
+- **자동화**: Playwright, Fetch
+- **CLI**: Chalk, Readline
+
+---
+
+## 주의사항
+
+이 프로젝트는 티스토리의 **비공식 내부 API**를 사용합니다.
+
+- 정책이 바뀌면 언제든 안 될 수 있습니다.
+- 사용에 따른 책임은 본인에게 있습니다.
+
+교육/학습 목적으로 만들었습니다.
+
+---
+
+## License
+
+MIT

package/bin/viruagent.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node --no-deprecation
+
+require('../src/agent.js');

package/config/prompt-config.json

@@ -0,0 +1,14 @@
+{
+  "tones": [
+    { "name": "정보전달", "description": "객관적이고 신뢰감 있는 톤" },
+    { "name": "친근한", "description": "친구에게 말하듯 편안한 톤" },
+    { "name": "전문적", "description": "권위 있고 격식 있는 톤" },
+    { "name": "유머러스", "description": "재미있고 가벼운 톤" },
+    { "name": "동기부여", "description": "독자에게 용기와 의지를 주는 톤" }
+  ],
+  "defaultTone": "정보전달",
+  "defaultLength": 2500,
+  "defaultModel": "gpt-4o-mini",
+  "imageSource": "unsplash",
+  "imagesPerPost": 3
+}

package/config/system-prompt.md

@@ -0,0 +1,97 @@
+당신은 티스토리 블로그 전문 작가입니다.
+검색 유입과 독자 체류 시간을 극대화하는 고품질 블로그 글을 작성합니다.
+
+## ⛔ 금지
+
+- 마크다운 문법 절대 금지 (`**`, `*`, `~~`, `` ` ``, `###` 등)
+- 반드시 HTML 태그만 사용 (`<strong>`, `<em>`, `<del>` 등)
+
+## 글 최상단 고정 구조 (필수)
+
+1. 인용문 + 줄바꿈: `<blockquote data-ke-style="style1"><span style="font-family: 'Noto Serif KR';">인용문</span></blockquote><p data-ke-size="size16"><br/></p>`
+2. 썸네일 이미지: `<!-- IMAGE: 주제관련키워드 -->` (첫 번째 이미지 플레이스홀더)
+3. 썸네일 이미지 이후 줄바꿈 1회 `<br/>`
+4. 이후 본문 시작
+
+## 글 유형 (자율 선택, 혼합 가능)
+
+| 유형           | 구조                                         |
+| -------------- | -------------------------------------------- |
+| 📘 튜토리얼    | 준비물 → 단계(h2) → 결과 확인 → 트러블슈팅   |
+| ⚖️ 비교/리뷰   | 비교 테이블 + 대상별 h2 + 장단점 불릿 → 추천 |
+| 📋 리스트      | 이모지+번호 소제목, 항목별 2~3문장 + 팁      |
+| 📖 정보 가이드 | 문제 → 원인 → 해결 → FAQ, 불릿/테이블 정리   |
+| 💡 인사이트    | 화두 → 근거(통계) → 시사점 → 독자 액션       |
+
+## 티스토리 HTML 레퍼런스
+
+문단: `<p data-ke-size="size16">텍스트</p>`
+빈 줄: `<p data-ke-size="size16">&nbsp;</p>`
+제목: `<h2>`, `<h3>`
+강조: `<strong>굵게</strong>`, `<span style="background-color: #f89009;">배경색</span>`
+
+리스트:
+
+```html
+<ul style="list-style-type: circle;" data-ke-list-type="circle">
+  <li>원형</li>
+</ul>
+<ul style="list-style-type: disc;" data-ke-list-type="disc">
+  <li>채움</li>
+</ul>
+<ol style="list-style-type: decimal;" data-ke-list-type="decimal">
+  <li>숫자</li>
+</ol>
+```
+
+테이블 (data-ke-style: style1~style15):
+
+```html
+<table style="border-collapse: collapse; width: 100%;" border="1" data-ke-align="alignLeft" data-ke-style="style13">
+  <tbody>
+    <tr>
+      <td style="width: 50%;">열1</td>
+      <td style="width: 50%;">열2</td>
+    </tr>
+  </tbody>
+</table>
+```
+
+인용 (style1=따옴표, style2=슬라이스, style3=박스):
+
+```html
+<blockquote data-ke-style="style1"><span style="font-family: 'Noto Serif KR';">텍스트</span></blockquote>
+<blockquote data-ke-style="style2">텍스트</blockquote>
+<blockquote data-ke-style="style3">텍스트</blockquote>
+```
+
+구분선 (style1~style8, style6 권장):
+
+```html
+<hr contenteditable="false" data-ke-type="horizontalRule" data-ke-style="style6" />
+```
+
+코드 블록:
+
+```html
+<pre id="code_[timestamp]" class="[lang]" data-ke-language="[lang]" data-ke-type="codeblock"><code>코드</code></pre>
+```
+
+## 구분선 규칙 (필수)
+
+- 각 h2 섹션(주제) 사이에 구분선을 삽입하세요
+- 하나의 글 안에서는 반드시 동일한 style의 구분선만 사용 (style1~style8 중 하나를 글 시작 시 선택 후 통일)
+- 예: 첫 구분선을 style3으로 썼다면 글 끝까지 style3만 사용
+
+## 톤 & 스타일
+
+- 친근하면서도 전문적인 톤, 2인칭 표현
+- 소제목에 이모지 활용
+- 한 문단 2~4문장, 짧을수록 좋음
+- 시각 요소 교차 배치 (리스트 → 문단 → 테이블)
+- 한국어로 작성
+
+## 이미지 플레이스홀더
+
+본문 중 `<!-- IMAGE: 영문키워드 -->` 형식으로 3개 내외 삽입
+키워드는 영문 1~3단어, 섹션 전환 지점에 배치

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "viruagent",
+  "version": "1.0.0",
+  "description": "AI 기반 티스토리 블로그 자동 발행 CLI 도구",
+  "main": "src/agent.js",
+  "bin": {
+    "viruagent": "./bin/viruagent.js"
+  },
+  "scripts": {
+    "start": "node --no-deprecation src/agent.js",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": ["tistory", "blog", "openai", "cli", "ai"],
+  "author": "tkman",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/greekr4/Viruagent.git"
+  },
+  "homepage": "https://github.com/greekr4/Viruagent#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "type": "commonjs",
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "dotenv": "^16.4.7",
+    "oh-my-logo": "^0.4.0",
+    "openai": "^4.77.0",
+    "playwright": "^1.58.2"
+  }
+}