viruagent 1.2.0 → 1.3.1

package/.github/workflows/publish.yml

@@ -0,0 +1,26 @@
+name: Publish to npm
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - run: npm ci
+
+      - run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/README.md

@@ -1,21 +1,29 @@
 <img width="525" height="113" alt="image" src="https://github.com/user-attachments/assets/8bbd21d3-5f14-4d11-933d-17bdf6969ebf" />
 
-
 # ViruAgent
 
-> 터미널에서 티스토리 블로그 글을 만들고, 다듬고, 발행하는 CLI 도구
+> 터미널에서 티스토리 블로그 글을 발행까지 한 번에!
+> (CLI 기반 AI Agent 도구)
+>
+> 태균맨(tae\*virus)의 별명
+> **Viru** + **Agent** = **ViruAgent** (바이루에이전트)
 
-티스토리 API를 역분석해서 OpenAI와 엮었습니다.
+티스토리 API를 분석해서 OpenAI와 엮었습니다.
 글감 잡기 → 초안 생성 → 수정 → 발행까지 터미널 안에서 끝납니다.
 
 공식 API가 아닌 비공식 내부 통신을 쓰기 때문에, 학습/실험 용도로 만들었습니다.
 
 ---
 
-## 뭘 할 수 있나
+📋 [Patch Notes](#patch-notes)
+
+---
+
+## 기능
 
 - **자연어로 글 발행** — "AI 트렌드로 글 써서 발행해줘"라고 말하면 AI가 알아서 글 생성부터 발행까지 처리합니다.
 - **에이전트 패턴** — OpenAI Function Calling 기반. AI가 도구를 자율적으로 선택하고 실행하는 에이전트 루프로 동작합니다.
+- **웹검색 기반 글쓰기** — DuckDuckGo 검색 결과를 바탕으로 최신 정보/트렌드를 반영해 글 초안을 생성합니다.
 - **수동 명령어 호환** — `/write`, `/edit`, `/publish` 같은 슬래시 명령어도 그대로 사용할 수 있습니다.
 - **Unsplash 이미지 자동 삽입** — 글 생성 시 주제에 맞는 이미지를 자동 검색하고 티스토리에 업로드합니다. 첫 번째 이미지가 썸네일로 설정됩니다.
 - **브라우저 로그인으로 세션 관리** — OAuth 설정 없이 Playwright로 실제 로그인해서 쿠키를 가져옵니다.
@@ -53,8 +61,6 @@ Unsplash API Key는 `/set api` 명령어로 나중에 설정할 수 있습니다
 
 ---
 
-
-
 | 명령어          | 설명                                         |
 | --------------- | -------------------------------------------- |
 | `/write <주제>` | AI가 블로그 글 초안 생성                     |
@@ -64,7 +70,7 @@ Unsplash API Key는 `/set api` 명령어로 나중에 설정할 수 있습니다
 | `/set`          | 카테고리, 공개 설정, 모델, 말투 변경         |
 | `/list`         | 최근 발행 글 목록                            |
 | `/login`        | 티스토리 세션 갱신                           |
-| `/logout`        | 티스토리 세션 삭제                           |
+| `/logout`       | 티스토리 세션 삭제                           |
 
 ---
 
@@ -72,27 +78,33 @@ Unsplash API Key는 `/set api` 명령어로 나중에 설정할 수 있습니다
 
 슬래시 명령어 없이 자연어로 말하면 AI가 자율적으로 동작합니다.
 
+
+
 ```
 viruagent> AI 에이전트 주제로 글 써서 발행해줘
 
-  ⠹
+✓ 웹검색 완료: "효과적인 시간 관리 팁" (5건)
 ✓ 글 생성 완료: "AI 에이전트 완벽 가이드: 챗봇과의 7가지 차이"
-  ⠧
 ✓ 발행 완료! https://tkman.tistory.com/60
 
 AI
 블로그 글이 성공적으로 발행되었습니다!
 ```
 
+![clideo_editor_32d1094183c7474a9985dbfd56abda67](https://github.com/user-attachments/assets/96ae2c75-fd1c-4860-9b3e-125f21dba136)
+
+
+
+
 ### 자연어 요청 예시
 
-| 입력 | AI가 하는 일 |
-|------|-------------|
-| "AI 트렌드로 글 써줘" | `generate_post` 호출 → 초안 생성 |
-| "서론을 더 흥미롭게 수정해줘" | `edit_post` 호출 → 초안 수정 |
-| "발행해줘" | `publish_post` 호출 → 즉시 발행 |
-| "비공개로 발행해줘" | 공개설정 변경 후 발행 |
-| "글 써서 바로 발행해줘" | 생성 → 발행 연속 실행 |
+| 입력                          | AI가 하는 일                     |
+| ----------------------------- | -------------------------------- |
+| "AI 트렌드로 글 써줘"         | `generate_post` 호출 → 초안 생성 |
+| "서론을 더 흥미롭게 수정해줘" | `edit_post` 호출 → 초안 수정     |
+| "발행해줘"                    | `publish_post` 호출 → 즉시 발행  |
+| "비공개로 발행해줘"           | 공개설정 변경 후 발행            |
+| "글 써서 바로 발행해줘"       | 생성 → 발행 연속 실행            |
 
 ### 동작 원리
 
@@ -116,11 +128,8 @@ AI
 
 <img width="1054" height="896" alt="image" src="https://github.com/user-attachments/assets/9e30e0ed-32f9-41a4-b39f-e4e6863d5d2d" />
 
-
-
 카테고리, 공개 여부, 발행 방식을 물어본 뒤 AI가 글을 생성해서 티스토리에 발행합니다.
 
-
 ### 직접 CLI로 실행
 
 ```bash
@@ -164,13 +173,13 @@ config/
 
 ### 글 유형 (AI가 주제에 맞게 자율 선택)
 
-| 유형 | 구조 |
-|------|------|
-| 튜토리얼 | 준비물 → 단계 → 결과 확인 → 트러블슈팅 |
-| 비교/리뷰 | 비교 테이블 + 장단점 → 추천 |
-| 리스트 | 번호 소제목 + 항목별 팁 |
-| 정보 가이드 | 문제 → 원인 → 해결 → FAQ |
-| 인사이트 | 화두 → 근거 → 시사점 → 액션 |
+| 유형        | 구조                                   |
+| ----------- | -------------------------------------- |
+| 튜토리얼    | 준비물 → 단계 → 결과 확인 → 트러블슈팅 |
+| 비교/리뷰   | 비교 테이블 + 장단점 → 추천            |
+| 리스트      | 번호 소제목 + 항목별 팁                |
+| 정보 가이드 | 문제 → 원인 → 해결 → FAQ               |
+| 인사이트    | 화두 → 근거 → 시사점 → 액션            |
 
 ### prompt-config.json 설정
 
@@ -179,6 +188,12 @@ config/
   "defaultModel": "gpt-4o-mini",
   "defaultTone": "정보전달",
   "defaultLength": 2500,
+  "webSearch": {
+    "enabled": true,
+    "provider": "duckduckgo",
+    "defaultMaxResults": 5,
+    "timeoutMs": 8000
+  },
   "imageSource": "unsplash",
   "imagesPerPost": 3
 }
@@ -230,3 +245,15 @@ logs/
 ## License
 
 MIT
+
+---
+
+## Patch Notes
+
+| 버전   | 내용                                                             |
+| ------ | ---------------------------------------------------------------- |
+| v1.3.1 | GitHub Actions npm 자동 배포 워크플로우 추가                     |
+| v1.3.0 | 웹 검색 기반 글 작성 도구 추가, 발행 로그 기반 패턴 요약 적용    |
+| v1.2.0 | 초기 설정 위저드, 저장 방식 전환, Function Calling 에이전트 도입 |
+| v1.1.0 | 시스템 프롬프트 분리, Unsplash 연동, 썸네일 자동 설정            |
+| v1.0.0 | 티스토리 자동 글쓰기 모듈 초기 설정                              |

package/config/agent-prompt.md

@@ -12,12 +12,13 @@
 
 ## 도구 사용 원칙
 
-1. 사용자가 글 작성을 요청하면 `generate_post`를 호출하세요.
+1. 사용자가 글 작성을 요청하면 기본적으로 `search_web`로 최신 정보를 먼저 확인한 뒤 `generate_post`를 호출하세요.
 2. 수정 요청이면 `edit_post`를 호출하세요.
 3. 미리보기 요청이면 `preview_post`를 호출하세요.
 4. 발행 요청이면 바로 `publish_post`를 호출하세요. 별도 확인을 구하지 마세요.
 5. 카테고리나 공개설정 변경 요청이면 `set_category` 또는 `set_visibility`를 호출하세요.
 6. 현재 상태를 파악해야 할 때 `get_blog_status`를 호출하세요.
+7. 웹검색이 실패하거나 결과가 부족해도 작업을 멈추지 말고 `generate_post`를 진행하세요.
 
 ## 대화 스타일
 

package/config/prompt-config.json

@@ -9,6 +9,12 @@
   "defaultTone": "정보전달",
   "defaultLength": 2500,
   "defaultModel": "gpt-4o-mini",
+  "webSearch": {
+    "enabled": true,
+    "provider": "duckduckgo",
+    "defaultMaxResults": 5,
+    "timeoutMs": 8000
+  },
   "imageSource": "unsplash",
   "imagesPerPost": 3
 }

package/config/system-prompt.md

@@ -23,6 +23,13 @@
 | 📖 정보 가이드 | 문제 → 원인 → 해결 → FAQ, 불릿/테이블 정리   |
 | 💡 인사이트    | 화두 → 근거(통계) → 시사점 → 독자 액션       |
 
+## 구조 다양화 규칙 (필수)
+
+- 최상단 고정 구조와 구분선 규칙은 반드시 유지
+- 단, 본문 섹션 순서/소제목 라벨/전개 방식은 최근 글과 동일하게 반복하지 말 것
+- 비교 주제라도 항상 같은 순서(비교표 → Plus 특징 → Pro 특징 → 선택 가이드)로 고정하지 말 것
+- 같은 주제를 다뤄도 관점(비용, 사용 시나리오, 리스크, 체크리스트)을 바꿔 차별화할 것
+
 ## 티스토리 HTML 레퍼런스
 
 문단: `<p data-ke-size="size16">텍스트</p>`
@@ -90,6 +97,7 @@
 - 한 문단 2~4문장, 짧을수록 좋음
 - 시각 요소 교차 배치 (리스트 → 문단 → 테이블)
 - 한국어로 작성
+- 제목 타입(숫자형/질문형/대조형/문장형) 지시가 주어지면 반드시 준수
 
 ## 이미지 플레이스홀더
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viruagent",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "description": "AI 기반 티스토리 블로그 자동 발행 CLI 도구",
   "main": "src/agent.js",
   "bin": {
@@ -8,7 +8,8 @@
   },
   "scripts": {
     "start": "node --no-deprecation src/agent.js",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "test:websearch": "node scripts/test-websearch.js"
   },
   "keywords": [
     "tistory",

package/src/agent.js

@@ -2,6 +2,7 @@ const readline = require('readline');
 const chalk = require('chalk');
 const { generatePost, revisePost, chat, runAgent, MODELS, loadConfig } = require('./lib/ai');
 const { initBlog, getBlogName, publishPost, saveDraft, getPosts, getCategories, VISIBILITY } = require('./lib/tistory');
+const { readRecentPatterns, recordPublishedPattern } = require('./lib/pattern-store');
 
 const TONES = loadConfig().tones.map((t) => t.name);
 
@@ -102,6 +103,8 @@ const state = {
   model: saved.model,
   tone: saved.tone,
   chatHistory: [],
+  blogConnected: false,
+  lastWebResearch: null,
 };
 
 const log = {
@@ -121,17 +124,29 @@ const animateBanner = async () => {
   const figlet = require('figlet');
   const gradient = require('gradient-string');
 
-  const text = figlet.textSync('ViruAgent', { font: 'ANSI Shadow' });
-  const lines = text.split('\n');
-  const totalLines = lines.length;
+  const viruText = figlet.textSync('Viru', { font: 'ANSI Shadow' });
+  const agentText = figlet.textSync('Agent', { font: 'ANSI Shadow' });
+  const viruLines = viruText.split('\n');
+  const agentLines = agentText.split('\n');
+
+  // 두 figlet의 줄 수를 맞춤
+  const maxLines = Math.max(viruLines.length, agentLines.length);
+  while (viruLines.length < maxLines) viruLines.push('');
+  while (agentLines.length < maxLines) agentLines.push('');
+
+  const viruGrad = gradient(['#ff0844', '#ff6b6b', '#ee5a24', '#f9d423']); // 빨강→핑크→주황→노랑
+  const agentGrad = gradient(['#00d2ff', '#4ecdc4', '#7b68ee', '#a855f7']); // 하늘→민트→보라→퍼플
+
   const { version } = require('../package.json');
-  const sub = `  대화형 티스토리 블로그 에이전트  v${version}`;
+  const sub = `  티스토리 블로그 에이전트  v${version}`;
 
   console.log();
 
-  // 라인별 드롭 애니메이션
-  for (let i = 0; i < totalLines; i++) {
-    console.log(gradient.pastel(lines[i]));
+  // 라인별 드롭 애니메이션 (VIRU + AGENT 나란히)
+  for (let i = 0; i < maxLines; i++) {
+    const viruPart = viruGrad(viruLines[i]);
+    const agentPart = agentGrad(agentLines[i]);
+    console.log(viruPart + agentPart);
     await sleep(40);
   }
 
@@ -351,9 +366,26 @@ const commands = {
     const topic = args.join(' ');
     if (!topic) return log.warn('사용법: /write <주제>');
 
+    if (!state.blogConnected) {
+      log.warn('티스토리 로그인이 안 되어있습니다.');
+      rl.pause();
+      const idx = await selectMenu(
+        ['그래도 진행', '로그인하기', '취소'],
+        '로그인 없이 진행하시겠습니까? (↑↓ 이동, Enter 선택)',
+      );
+      rl.resume();
+      if (idx === 1) {
+        await commands.login();
+      } else if (idx !== 0) {
+        return log.dim('취소됨');
+      }
+    }
+
     try {
+      const categoryName = getCategoryName() === '없음' ? 'Heartbeat' : getCategoryName();
+      const recentPatterns = readRecentPatterns({ category: categoryName, limit: 5 });
       state.draft = await withSpinner(`"${topic}" 주제로 글을 생성하는 중...`, () =>
-        generatePost(topic, { model: state.model, tone: state.tone }),
+        generatePost(topic, { model: state.model, tone: state.tone, categoryName, recentPatterns }),
       );
       log.success(`글 생성 완료: "${state.draft.title}"`);
       log.dim(`태그: ${state.draft.tags}`);
@@ -396,6 +428,7 @@ const commands = {
   },
 
   async publish() {
+    if (!state.blogConnected) return log.warn('티스토리 로그인이 필요합니다. /login으로 먼저 로그인하세요.');
     if (!state.draft) return log.warn('초안이 없습니다.');
 
     log.info('발행하는 중...');
@@ -408,6 +441,16 @@ const commands = {
         tag: state.draft.tags,
         thumbnail: state.draft.thumbnailKage || null,
       });
+      const categoryName = getCategoryName() === '없음' ? 'Heartbeat' : getCategoryName();
+      recordPublishedPattern({
+        title: state.draft.title,
+        topic: state.draft?._meta?.topic || '',
+        content: state.draft.content,
+        url: result.entryUrl || '',
+        postId: result?.post?.id || result?.id || null,
+        category: categoryName,
+        generationMeta: state.draft?._meta || null,
+      });
       log.success(`발행 완료! ${result.entryUrl || ''}`);
       state.draft = null;
     } catch (e) {
@@ -416,6 +459,7 @@ const commands = {
   },
 
   async draft() {
+    if (!state.blogConnected) return log.warn('티스토리 로그인이 필요합니다. /login으로 먼저 로그인하세요.');
     if (!state.draft) return log.warn('초안이 없습니다.');
 
     log.info('임시저장하는 중...');
@@ -531,7 +575,7 @@ const commands = {
       }
     } else if (key === 'api') {
       const keys = loadApiKeys();
-      const mask = (v) => v ? `${v.slice(0, 8)}${'*'.repeat(8)}` : chalk.dim('(미설정)');
+      const mask = (v) => (v ? `${v.slice(0, 8)}${'*'.repeat(8)}` : chalk.dim('(미설정)'));
 
       console.log();
       log.title('API Key 설정');
@@ -629,6 +673,7 @@ ${chalk.dim('예: "AI 트렌드로 글 써줘", "서론을 더 흥미롭게 수
       await initBlog();
       log.success(`블로그 감지: ${getBlogName()}`);
       state.categories = await getCategories();
+      state.blogConnected = true;
       log.success(`${Object.keys(state.categories).length}개 카테고리 로드 완료`);
     } catch (e) {
       log.error(`로그인 실패: ${e.message}`);
@@ -661,6 +706,20 @@ const handleInput = async (input) => {
     }
   } else {
     // 에이전트 루프 (자연어 → 자율 도구 호출)
+    if (!state.blogConnected) {
+      log.warn('티스토리 로그인이 안 되어있습니다.');
+      rl.pause();
+      const idx = await selectMenu(
+        ['그래도 진행', '로그인하기', '취소'],
+        '로그인 없이 진행하시겠습니까? (↑↓ 이동, Enter 선택)',
+      );
+      rl.resume();
+      if (idx === 1) {
+        await commands.login();
+      } else if (idx !== 0) {
+        return log.dim('취소됨');
+      }
+    }
     try {
       // Braille 도트 애니메이션 (텍스트 없이)
       const DOT_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
@@ -704,6 +763,8 @@ const handleInput = async (input) => {
             log.success(`카테고리 설정: ${result.category}`);
           } else if (name === 'set_visibility' && result?.visibility) {
             log.success(`공개설정: ${result.visibility}`);
+          } else if (name === 'search_web' && result?.success) {
+            log.success(`웹검색 완료: "${result.query}" (${result.count}건)`);
           }
           startSpinner();
         },
@@ -873,6 +934,7 @@ const main = async () => {
       1200,
     );
     blogOk = true;
+    state.blogConnected = true;
   } catch (e) {
     if (!blogOk) log.warn(`  티스토리 연결 실패: ${e.message}\n  ${chalk.dim('/login 명령어로 다시 로그인하세요.')}`);
   }

package/src/cli-post.js

@@ -15,6 +15,7 @@ try {
 
 const { generatePost, loadConfig } = require('./lib/ai');
 const { initBlog, publishPost, saveDraft, getCategories, VISIBILITY } = require('./lib/tistory');
+const { readRecentPatterns, recordPublishedPattern } = require('./lib/pattern-store');
 
 const parseArgs = (argv) => {
   const args = {};
@@ -40,6 +41,16 @@ const output = (obj) => {
   console.log(JSON.stringify(obj));
 };
 
+const resolveCategoryName = async (categoryId) => {
+  try {
+    const categories = await getCategories();
+    const found = Object.entries(categories).find(([, id]) => Number(id) === Number(categoryId));
+    return found ? found[0] : 'Heartbeat';
+  } catch {
+    return 'Heartbeat';
+  }
+};
+
 const main = async () => {
   const args = parseArgs(process.argv.slice(2));
 
@@ -59,11 +70,16 @@ const main = async () => {
   }
 
   const config = loadConfig();
+  const category = Number(args.category) || 0;
+  const categoryName = await resolveCategoryName(category);
+  const recentPatterns = readRecentPatterns({ category: categoryName, limit: 5 });
 
   // 글 생성
   const post = await generatePost(args.topic, {
     model: args.model || config.defaultModel,
     tone: args.tone || config.defaultTone,
+    categoryName,
+    recentPatterns,
   });
 
   // dry-run: 생성만
@@ -73,7 +89,6 @@ const main = async () => {
   }
 
   const visibility = visibilityMap[args.visibility] ?? VISIBILITY.PUBLIC;
-  const category = Number(args.category) || 0;
 
   // 임시저장
   if (args.draft) {
@@ -93,6 +108,15 @@ const main = async () => {
   });
 
   const url = result.entryUrl || null;
+  recordPublishedPattern({
+    title: post.title,
+    topic: post?._meta?.topic || args.topic,
+    content: post.content,
+    url: url || '',
+    postId: result?.post?.id || result?.id || null,
+    category: categoryName,
+    generationMeta: post?._meta || null,
+  });
 
   output({ success: true, mode: 'publish', title: post.title, tags: post.tags, url });
 };