viruagent-cli 0.5.1 → 0.6.0

package/skills/va-tistory-login/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: va-tistory-login
+version: 1.0.0
+description: "Tistory: 카카오 계정으로 로그인 (2FA 지원)"
+metadata:
+  category: "command"
+  provider: "tistory"
+  requires:
+    bins: ["viruagent-cli"]
+    cliHelp: "viruagent-cli login --help"
+---
+
+# va-tistory-login — Tistory 로그인
+
+## 인증 상태 확인
+
+```bash
+npx viruagent-cli status --provider tistory
+```
+
+## 로그인
+
+```bash
+npx viruagent-cli login --provider tistory --username <kakao_id> --password <pass> --headless
+```
+
+### 옵션
+
+| 플래그 | 설명 | 기본값 |
+|--------|------|--------|
+| `--username` | 카카오 아이디 | - |
+| `--password` | 카카오 비밀번호 | - |
+| `--headless` | 헤드리스 브라우저 모드 | false |
+| `--two-factor-code` | 2FA 인증 코드 | - |
+
+### 2FA 처리
+
+로그인 결과가 `pending_2fa`인 경우:
+1. 사용자에게 카카오 앱에서 인증 승인 요청
+2. 승인 후 `status` 재확인
+
+### 환경변수
+
+`TISTORY_USERNAME` / `TISTORY_PASSWORD` 설정 시 자동 사용.
+
+## 로그아웃
+
+```bash
+npx viruagent-cli logout --provider tistory
+```
+
+## See Also
+
+va-tistory, va-shared

package/skills/va-tistory-posts/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: va-tistory-posts
+version: 1.0.0
+description: "Tistory: 글 목록 조회 및 개별 글 읽기"
+metadata:
+  category: "command"
+  provider: "tistory"
+  requires:
+    bins: ["viruagent-cli"]
+    cliHelp: "viruagent-cli list-posts --help"
+---
+
+# va-tistory-posts — 글 목록 & 읽기
+
+## 글 목록
+
+```bash
+npx viruagent-cli list-posts --provider tistory --limit 10
+```
+
+| 플래그 | 설명 | 기본값 |
+|--------|------|--------|
+| `--limit` | 조회할 글 수 | 20 |
+
+## 글 읽기
+
+```bash
+npx viruagent-cli read-post --provider tistory --post-id <id>
+```
+
+| 플래그 | 설명 |
+|--------|------|
+| `--post-id` | 글 ID |
+| `--include-draft` | 임시저장 포함 |
+
+## See Also
+
+va-tistory, va-shared

package/skills/va-tistory-publish/SKILL.md

@@ -0,0 +1,90 @@
+---
+name: va-tistory-publish
+version: 1.0.0
+description: "Tistory: 블로그 글 발행 (HTML 콘텐츠 + 이미지)"
+metadata:
+  category: "command"
+  provider: "tistory"
+  requires:
+    bins: ["viruagent-cli"]
+    cliHelp: "viruagent-cli publish --help"
+---
+
+# va-tistory-publish — Tistory 글 발행
+
+## 사용법
+
+```bash
+npx viruagent-cli publish \
+  --provider tistory \
+  --title "Post Title" \
+  --content "<h2>...</h2><p>...</p>" \
+  --category <id> \
+  --tags "tag1,tag2,tag3,tag4,tag5" \
+  --visibility public \
+  --related-image-keywords "keyword1,keyword2" \
+  --image-upload-limit 2 \
+  --minimum-image-count 1
+```
+
+### 옵션
+
+| 플래그 | 설명 | 기본값 |
+|--------|------|--------|
+| `--title` | 글 제목 | (필수) |
+| `--content` | HTML 콘텐츠 | - |
+| `--content-file` | HTML 파일 경로 (절대) | - |
+| `--category` | 카테고리 ID | - |
+| `--tags` | 쉼표 구분 태그 (5개) | - |
+| `--visibility` | public / private | public |
+| `--related-image-keywords` | 이미지 검색 키워드 (영어) | - |
+| `--image-upload-limit` | 최대 이미지 수 | 1 |
+| `--minimum-image-count` | 최소 이미지 수 | 1 |
+| `--dry-run` | 파라미터만 검증 | false |
+
+## HTML 템플릿
+
+```html
+<!-- 1. Hook -->
+<blockquote data-ke-style="style2">[한 문장 임팩트]</blockquote>
+<p data-ke-size="size16">&nbsp;</p>
+
+<!-- 2. 서론 (2~3단락) -->
+<p data-ke-size="size18">[맥락과 공감, 3~5문장]</p>
+<p data-ke-size="size18">[이 글에서 다룰 내용]</p>
+<p data-ke-size="size16">&nbsp;</p>
+
+<!-- 3. 본문 (3~4 섹션) -->
+<h2>[섹션 제목]</h2>
+<p data-ke-size="size18">[3~5문장, 근거 포함]</p>
+<p data-ke-size="size18">[분석과 시사점]</p>
+<p data-ke-size="size16">&nbsp;</p>
+
+<!-- 4. 핵심 정리 -->
+<h2>핵심 정리</h2>
+<ul>
+  <li>[핵심 1]</li>
+  <li>[핵심 2]</li>
+  <li>[핵심 3]</li>
+</ul>
+<p data-ke-size="size16">&nbsp;</p>
+
+<!-- 5. 마무리 -->
+<p data-ke-size="size18">[구체적 실행 제안]</p>
+```
+
+## 이미지 규칙
+
+- `--related-image-keywords`에 영어 키워드 2~3개 항상 포함
+- `--image-upload-limit 2`, `--minimum-image-count 1` 설정
+- `--no-auto-upload-images`는 사용자 명시 요청 시만
+
+## 발행 후 검증
+
+```bash
+npx viruagent-cli list-posts --provider tistory --limit 1
+```
+
+## See Also
+
+va-tistory, va-tistory-draft, va-shared

package/src/providers/insta/index.js

@@ -225,12 +225,33 @@ const createInstaProvider = ({ sessionPath }) => {
       });
     },
 
-    async publish({ imageUrl, imagePath, caption = '' } = {}) {
+    async publish({ imageUrl, imagePath, caption = '', content, title, relatedImageKeywords = [], imageUrls = [] } = {}) {
       return withProviderSession(async () => {
-        if (!imageUrl && !imagePath) {
-          throw new Error('Either imageUrl or imagePath is required.');
+        // Use content as caption if caption is not provided
+        const finalCaption = caption || content || '';
+
+        // Resolve image: explicit imageUrl/imagePath > imageUrls > relatedImageKeywords search
+        let resolvedImageUrl = imageUrl;
+        if (!resolvedImageUrl && !imagePath) {
+          if (imageUrls.length > 0) {
+            resolvedImageUrl = imageUrls[0];
+          } else if (relatedImageKeywords.length > 0) {
+            const { buildKeywordImageCandidates } = require('../tistory/imageSources');
+            for (const keyword of relatedImageKeywords) {
+              const candidates = await buildKeywordImageCandidates(keyword);
+              if (candidates.length > 0) {
+                resolvedImageUrl = candidates[0];
+                break;
+              }
+            }
+          }
+        }
+
+        if (!resolvedImageUrl && !imagePath) {
+          throw new Error('No image found. Provide --image-urls, --related-image-keywords, or use imageUrl/imagePath.');
         }
-        const result = await instaApi.publishPost({ imageUrl, imagePath, caption });
+
+        const result = await instaApi.publishPost({ imageUrl: resolvedImageUrl, imagePath, caption: finalCaption });
         return {
           provider: 'insta',
           mode: 'publish',

package/src/runner.js

@@ -47,26 +47,36 @@ const runCommand = async (command, opts = {}) => {
 
   if (command === 'install-skill') {
     const skillsDir = path.resolve(__dirname, '..', 'skills');
-    const skillFiles = ['viruagent.md', 'viruagent-tistory.md', 'viruagent-naver.md', 'viruagent-insta.md'];
-
     const targetDir = opts.target
       || path.join(os.homedir(), '.claude', 'commands');
-    fs.mkdirSync(targetDir, { recursive: true });
-
-    const installed = [];
-    for (const file of skillFiles) {
-      const src = path.join(skillsDir, file);
-      if (!fs.existsSync(src)) continue;
-      const dest = path.join(targetDir, file);
-      fs.copyFileSync(src, dest);
-      installed.push(dest);
-    }
 
-    if (installed.length === 0) {
-      throw createError('FILE_NOT_FOUND', 'Skill files not found in package');
+    // Install only the main router skill as /viruagent
+    const routerSrc = path.join(skillsDir, 'va-shared', 'SKILL.md');
+    if (!fs.existsSync(routerSrc)) {
+      throw createError('FILE_NOT_FOUND', 'Router skill (va-shared/SKILL.md) not found');
     }
 
-    return { installed: true, paths: installed, count: installed.length };
+    const destDir = path.join(targetDir, 'viruagent');
+    fs.mkdirSync(destDir, { recursive: true });
+    const dest = path.join(destDir, 'SKILL.md');
+    fs.copyFileSync(routerSrc, dest);
+
+    // Inject actual skills directory path into the installed SKILL.md
+    const skillsAbsPath = skillsDir;
+    let content = fs.readFileSync(dest, 'utf-8');
+    content = content.replace(
+      'SKILLS_DIR: <viruagent-cli 설치 경로>/skills/',
+      `SKILLS_DIR: ${skillsAbsPath}/`
+    );
+    fs.writeFileSync(dest, content, 'utf-8');
+
+    return {
+      installed: true,
+      paths: [dest],
+      count: 1,
+      skillsDir: skillsAbsPath,
+      note: 'Only /viruagent is registered as a slash command. Sub-skills are loaded on demand from ' + skillsAbsPath,
+    };
   }
 
   const manager = createProviderManager();
@@ -110,7 +120,7 @@ const runCommand = async (command, opts = {}) => {
 
     case 'publish': {
       const content = readContent(opts);
-      if (!content) {
+      if (!content && providerName !== 'insta') {
         throw createError('MISSING_CONTENT', 'publish requires --content or --content-file', 'viruagent-cli publish --spec');
       }
       return withProvider(() =>

package/skills/viruagent-insta.md

@@ -1,163 +0,0 @@
----
-name: viruagent-insta
-description: Instagram automation via viruagent-cli — like, comment, follow, post, analyze feed. Handles rate limits and bot detection avoidance.
-triggers:
-  - 인스타
-  - 인스타그램
-  - instagram
-  - insta
-  - 좋아요
-  - 댓글 달아
-  - 팔로우
-  - 언팔로우
-  - 피드
-  - like
-  - comment
-  - follow
-  - unfollow
-  - feed
----
-
-# viruagent-insta — Instagram Automation Skill
-
-You are an Instagram automation agent using `viruagent-cli`. Always use `npx viruagent-cli` with `--provider insta`.
-
-## Step 1: Check authentication
-
-```bash
-npx viruagent-cli status --provider insta
-```
-
-If not logged in:
-
-```bash
-npx viruagent-cli login --provider insta --username <user> --password <pass>
-```
-
-Environment variables `INSTA_USERNAME` / `INSTA_PASSWORD` also work.
-
-## Step 2: Available commands
-
-### Profile & Feed
-
-```bash
-# Get user profile
-npx viruagent-cli get-profile --provider insta --username <username>
-
-# Get your feed timeline
-npx viruagent-cli get-feed --provider insta
-
-# List user's posts (with pagination)
-npx viruagent-cli list-posts --provider insta --username <username> --limit 20
-```
-
-### Engagement (auto rate-limit delays applied)
-
-```bash
-# Like a post
-npx viruagent-cli like --provider insta --post-id <shortcode>
-
-# Comment on a post
-npx viruagent-cli comment --provider insta --post-id <shortcode> --text "comment text"
-
-# Follow / Unfollow
-npx viruagent-cli follow --provider insta --username <username>
-npx viruagent-cli unfollow --provider insta --username <username>
-
-# Like / Unlike a comment
-npx viruagent-cli like-comment --provider insta --comment-id <id>
-npx viruagent-cli unlike-comment --provider insta --comment-id <id>
-```
-
-### Analyze & Smart Comment
-
-```bash
-# Analyze post (returns caption + thumbnail base64 + profile)
-npx viruagent-cli analyze-post --provider insta --post-id <shortcode>
-```
-
-Use `analyze-post` to get the thumbnail image, then visually analyze it to write contextual comments.
-
-### Publish
-
-```bash
-# Publish an image post (provide imageUrl or imagePath in code)
-# CLI does not have a direct publish command — use the Node.js API:
-```
-
-```javascript
-const insta = require('viruagent-cli/src/services/providerManager').createProviderManager().getProvider('insta');
-await insta.publish({ imageUrl: 'https://...', caption: 'My post' });
-```
-
-### Rate Limit
-
-```bash
-npx viruagent-cli rate-limit-status --provider insta
-```
-
-## Workflows
-
-### "Like all posts from @user"
-
-1. `list-posts --username <user> --limit 20`
-2. For each post: `like --post-id <shortcode>`
-3. Rate limit delays are automatic (20~40s between likes)
-
-### "Comment on all @user's posts"
-
-1. `list-posts --username <user> --limit 20`
-2. For each post:
-   a. Check if already commented (use `analyze-post` to see existing comments)
-   b. `analyze-post --post-id <shortcode>` — read thumbnail + caption
-   c. Visually analyze the thumbnail to understand the content
-   d. Write a contextual, natural comment (1~2 sentences, 1~2 emoji max)
-   e. `comment --post-id <shortcode> --text "..."`
-3. Rate limit delays are automatic (5~7min between comments)
-
-### "Follow @user and engage with their feed"
-
-1. `follow --username <user>`
-2. `list-posts --username <user> --limit 20`
-3. Like + comment each post (as above)
-
-### Comment Writing Rules
-
-- Write in the same language as the post caption
-- Be specific to the content — reference what's in the image/caption
-- 1~2 sentences max, 1~2 emoji
-- No hashtags in comments
-- No generic phrases like "Nice post!" or "Great content!"
-- Vary tone and style across comments — don't repeat patterns
-- If the post is a video (릴스), analyze the thumbnail + caption to understand context
-
-## Rate Limit Safety (New Account)
-
-| Action | Delay | Hourly | Daily |
-|--------|-------|--------|-------|
-| Like | 20~40s | 15 | 500 |
-| Comment | 5~7min | 5 | 100 |
-| Follow | 1~2min | 15 | 250 |
-| Unfollow | 1~2min | 10 | 200 |
-| DM | 2~5min | 5 | 30 |
-| Post | 1~2min | 3 | 25 |
-
-All delays are randomized and applied automatically. Counters persist across sessions per userId.
-
-## Error Recovery
-
-| Error | Action |
-|---|---|
-| `hourly_limit` | Wait for the specified time, then retry |
-| `daily_limit` | Wait until tomorrow |
-| `rate_limit` (spam detected) | Wait 24~48 hours |
-| `challenge` (302 redirect to /challenge/) | User must verify identity in browser |
-| `SESSION_EXPIRED` | Run `login` again |
-
-## Important Notes
-
-- Always check `rate-limit-status` before bulk operations
-- New accounts (< 20 days) have stricter limits
-- Uniform action intervals trigger bot detection — delays are randomized
-- challenge requires manual browser verification
-- Session + counters stored locally at `~/.viruagent-cli/sessions/insta-session.json`

package/skills/viruagent-naver.md

@@ -1,122 +0,0 @@
----
-name: viruagent-naver
-description: Naver Blog publishing via viruagent-cli. Login, categories, HTML-to-SE-Editor conversion, image upload, and publishing.
-triggers:
-  - 네이버
-  - naver
-  - 네이버 블로그
-  - naver blog
----
-
-# viruagent-naver — Naver Blog Publishing Skill
-
-You are a Naver blog publishing agent using `viruagent-cli`. Always use `--provider naver`.
-
-## Step 1: Check authentication
-
-```bash
-npx viruagent-cli status --provider naver
-```
-
-If not logged in:
-
-```bash
-# Auto login
-npx viruagent-cli login --provider naver --username <naver_id> --password <pass>
-
-# Manual login (browser)
-npx viruagent-cli login --provider naver --manual
-```
-
-Environment variables: `NAVER_USERNAME` / `NAVER_PASSWORD`
-
-Note: Naver has aggressive bot detection. Use `--manual` if auto login fails.
-
-## Step 2: Get categories
-
-```bash
-npx viruagent-cli list-categories --provider naver
-```
-
-Ask the user which category to use if not specified.
-
-## Step 3: Create content
-
-Write content in plain HTML. Do NOT use `data-ke-*` attributes — Naver's SE Editor ignores them.
-
-### HTML Template
-
-```html
-<!-- 1. Hook -->
-<blockquote>[One impactful sentence]</blockquote>
-<p>&nbsp;</p>
-
-<!-- 2. Introduction (2~3 paragraphs) -->
-<p>[Context and reader empathy, 3~5 sentences]</p>
-<p>[What this post covers]</p>
-<p>&nbsp;</p>
-
-<!-- 3. Body (3~4 sections) -->
-<h2>[Section Title]</h2>
-<p>[3~5 sentences with evidence]</p>
-<p>[Analysis and implications]</p>
-<p>&nbsp;</p>
-
-<!-- Repeat for 2~3 more sections -->
-
-<!-- 4. Summary -->
-<h2>핵심 정리</h2>
-<ul>
-  <li>[Takeaway 1]</li>
-  <li>[Takeaway 2]</li>
-  <li>[Takeaway 3]</li>
-</ul>
-<p>&nbsp;</p>
-
-<!-- 5. Closing -->
-<p>[Specific actionable suggestion]</p>
-```
-
-### Naver-Specific Rules
-
-- Use plain `<p>` tags — no `data-ke-*` attributes
-- Use `<p>&nbsp;</p>` for spacing
-- Use plain `<blockquote>` for hook — Naver converts it to a quotation component
-- HTML is auto-converted to SE Editor components server-side
-
-## Step 4: Publish
-
-```bash
-npx viruagent-cli publish \
-  --provider naver \
-  --title "Post Title" \
-  --content "<h2>...</h2><p>...</p>" \
-  --category <id> \
-  --tags "tag1,tag2,tag3,tag4,tag5" \
-  --visibility public \
-  --related-image-keywords "keyword1,keyword2" \
-  --image-upload-limit 1 \
-  --minimum-image-count 1
-```
-
-For drafts: Naver saves as private post (`save-draft` uses `--visibility private`).
-
-### Image Rules
-
-- Always include `--related-image-keywords` with 2~3 English keywords
-- Set `--image-upload-limit 1` and `--minimum-image-count 1`
-- Never use `--no-auto-upload-images` unless user explicitly asks
-
-## Step 5: Verify
-
-```bash
-npx viruagent-cli list-posts --provider naver --limit 1
-```
-
-## Other Commands
-
-```bash
-npx viruagent-cli read-post --provider naver --post-id <id>
-npx viruagent-cli list-posts --provider naver --limit 10
-npx viruagent-cli logout --provider naver
-```

package/skills/viruagent-tistory.md

@@ -1,117 +0,0 @@
----
-name: viruagent-tistory
-description: Tistory blog publishing via viruagent-cli. Login, categories, content creation, image upload, and publishing.
-triggers:
-  - 티스토리
-  - tistory
-  - 티스토리 블로그
-  - tistory blog
----
-
-# viruagent-tistory — Tistory Blog Publishing Skill
-
-You are a Tistory blog publishing agent using `viruagent-cli`. Always use `--provider tistory`.
-
-## Step 1: Check authentication
-
-```bash
-npx viruagent-cli status --provider tistory
-```
-
-If not logged in:
-
-```bash
-npx viruagent-cli login --provider tistory --username <kakao_id> --password <pass> --headless
-```
-
-If 2FA is required (`pending_2fa`), ask the user to approve in Kakao app, then retry status check.
-
-Environment variables: `TISTORY_USERNAME` / `TISTORY_PASSWORD`
-
-## Step 2: Get categories
-
-```bash
-npx viruagent-cli list-categories --provider tistory
-```
-
-Ask the user which category to use if not specified.
-
-## Step 3: Create content
-
-Write content in HTML using the Tistory template. Tistory uses `data-ke-*` attributes.
-
-### HTML Template
-
-```html
-<!-- 1. Hook -->
-<blockquote data-ke-style="style2">[One impactful sentence]</blockquote>
-<p data-ke-size="size16">&nbsp;</p>
-
-<!-- 2. Introduction (2~3 paragraphs) -->
-<p data-ke-size="size18">[Context and reader empathy, 3~5 sentences]</p>
-<p data-ke-size="size18">[What this post covers]</p>
-<p data-ke-size="size16">&nbsp;</p>
-
-<!-- 3. Body (3~4 sections) -->
-<h2>[Section Title]</h2>
-<p data-ke-size="size18">[3~5 sentences with evidence]</p>
-<p data-ke-size="size18">[Analysis and implications]</p>
-<p data-ke-size="size16">&nbsp;</p>
-
-<!-- Repeat for 2~3 more sections -->
-
-<!-- 4. Summary -->
-<h2>핵심 정리</h2>
-<ul>
-  <li>[Takeaway 1]</li>
-  <li>[Takeaway 2]</li>
-  <li>[Takeaway 3]</li>
-</ul>
-<p data-ke-size="size16">&nbsp;</p>
-
-<!-- 5. Closing -->
-<p data-ke-size="size18">[Specific actionable suggestion]</p>
-```
-
-### Tistory-Specific Rules
-
-- Use `<p data-ke-size="size18">` for body text
-- Use `<p data-ke-size="size16">&nbsp;</p>` for spacing
-- Use `<blockquote data-ke-style="style2">` for hook
-
-## Step 4: Publish
-
-```bash
-npx viruagent-cli publish \
-  --provider tistory \
-  --title "Post Title" \
-  --content "<h2>...</h2><p>...</p>" \
-  --category <id> \
-  --tags "tag1,tag2,tag3,tag4,tag5" \
-  --visibility public \
-  --related-image-keywords "keyword1,keyword2" \
-  --image-upload-limit 2 \
-  --minimum-image-count 1
-```
-
-For drafts: `save-draft` instead of `publish`.
-
-### Image Rules
-
-- Always include `--related-image-keywords` with 2~3 English keywords
-- Set `--image-upload-limit 2` and `--minimum-image-count 1`
-- Never use `--no-auto-upload-images` unless user explicitly asks
-
-## Step 5: Verify
-
-```bash
-npx viruagent-cli list-posts --provider tistory --limit 1
-```
-
-## Other Commands
-
-```bash
-npx viruagent-cli read-post --provider tistory --post-id <id>
-npx viruagent-cli list-posts --provider tistory --limit 10
-npx viruagent-cli logout --provider tistory
-```