viruagent-cli 0.5.0 → 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/apiClient.js

@@ -545,6 +545,43 @@ const createInstaApiClient = ({ sessionPath }) => {
     return res.json();
   });
 
+  const sendDm = (recipientUserId, text) => withDelay('dm', async () => {
+    const cookies = getCookies();
+    const csrf = getCsrfToken();
+    const body = new URLSearchParams({
+      action: 'send_item',
+      recipient_users: `[[${recipientUserId}]]`,
+      client_context: `6${Date.now()}_${Math.floor(Math.random() * 1000000000)}`,
+      offline_threading_id: Date.now().toString(),
+      text,
+    });
+    const res = await fetch('https://i.instagram.com/api/v1/direct_v2/threads/broadcast/text/', {
+      method: 'POST',
+      headers: {
+        'User-Agent': 'Instagram 317.0.0.34.109 Android (30/11; 420dpi; 1080x2220; samsung; SM-A515F; a51; exynos9611; en_US; 562940699)',
+        'X-IG-App-ID': '567067343352427',
+        'X-CSRFToken': csrf,
+        'Content-Type': 'application/x-www-form-urlencoded',
+        Cookie: cookiesToHeader(cookies),
+      },
+      body: body.toString(),
+      redirect: 'manual',
+    });
+    const data = await res.json();
+    if (data.status !== 'ok') {
+      const errCode = data.content?.error_code;
+      if (errCode === 4415001) {
+        throw new Error('DM restricted: Account DM feature is limited. Please open Instagram in browser, go to Direct Messages, and resolve any pending prompts or challenges.');
+      }
+      throw new Error(`DM failed: ${JSON.stringify(data)}`);
+    }
+    return {
+      status: data.status,
+      threadId: data.payload?.thread_id || null,
+      itemId: data.payload?.item_id || null,
+    };
+  });
+
   const getMediaIdFromShortcode = async (shortcode) => {
     const detail = await getPostDetail(shortcode);
     return detail.id;
@@ -666,6 +703,7 @@ const createInstaApiClient = ({ sessionPath }) => {
     uploadPhoto,
     configurePost,
     publishPost,
+    sendDm,
     deletePost,
     resolveChallenge,
     resetState,

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',
@@ -239,6 +260,204 @@ const createInstaProvider = ({ sessionPath }) => {
       });
     },
 
+    async sendDm({ username, threadId, text } = {}) {
+      const target = String(username || '').trim();
+      const tid = String(threadId || '').trim();
+      const msg = String(text || '').trim();
+      if (!target && !tid) throw new Error('username or threadId is required.');
+      if (!msg) throw new Error('text is required.');
+
+      const { chromium } = require('playwright');
+      const path = require('path');
+      const userDataDir = path.join(path.dirname(sessionPath), '..', 'browser-data', 'insta');
+      const fs = require('fs');
+      if (!fs.existsSync(userDataDir)) fs.mkdirSync(userDataDir, { recursive: true });
+
+      // Determine DM URL
+      let dmUrl;
+      if (tid) {
+        dmUrl = `https://www.instagram.com/direct/t/${tid}/`;
+      } else {
+        dmUrl = `https://www.instagram.com/direct/new/`;
+      }
+
+      const context = await chromium.launchPersistentContext(userDataDir, {
+        headless: true,
+        viewport: { width: 1280, height: 800 },
+      });
+
+      try {
+        const page = context.pages()[0] || await context.newPage();
+
+        if (!tid && target) {
+          // New DM: go to new message, search for user
+          await page.goto('https://www.instagram.com/direct/new/', { waitUntil: 'domcontentloaded' });
+          await page.waitForTimeout(3000);
+
+          // Search for recipient
+          const searchInput = page.locator('input[name="queryBox"]').or(page.getByPlaceholder(/검색|Search/i));
+          await searchInput.first().waitFor({ timeout: 10000 });
+          await searchInput.first().fill(target);
+          await page.waitForTimeout(2000);
+
+          // Click the user result
+          const userResult = page.locator(`text=${target}`).first();
+          await userResult.click();
+          await page.waitForTimeout(1000);
+
+          // Click chat/next button
+          const chatBtn = page.getByRole('button', { name: /채팅|Chat|다음|Next/i });
+          await chatBtn.first().click();
+          await page.waitForTimeout(2000);
+        } else {
+          await page.goto(dmUrl, { waitUntil: 'domcontentloaded' });
+          await page.waitForTimeout(3000);
+        }
+
+        // Dismiss popups
+        try {
+          const btn = page.getByRole('button', { name: /나중에|Not Now/i });
+          if (await btn.first().isVisible({ timeout: 2000 })) await btn.first().click();
+        } catch {}
+
+        // Send message
+        const input = page.locator('[role="textbox"]').first();
+        await input.waitFor({ timeout: 10000 });
+        await input.click();
+        await page.keyboard.type(msg);
+        await page.waitForTimeout(500);
+        await page.keyboard.press('Enter');
+        await page.waitForTimeout(3000);
+
+        return {
+          provider: 'insta',
+          mode: 'dm',
+          to: target || tid,
+          text: msg,
+          status: 'ok',
+        };
+      } finally {
+        await context.close();
+      }
+    },
+
+    async listMessages({ threadId } = {}) {
+      const tid = String(threadId || '').trim();
+      if (!tid) throw new Error('threadId is required.');
+
+      const { chromium } = require('playwright');
+      const path = require('path');
+      const fs = require('fs');
+      const userDataDir = path.join(path.dirname(sessionPath), '..', 'browser-data', 'insta');
+      if (!fs.existsSync(userDataDir)) fs.mkdirSync(userDataDir, { recursive: true });
+
+      const context = await chromium.launchPersistentContext(userDataDir, {
+        headless: true,
+        viewport: { width: 1280, height: 800 },
+      });
+
+      try {
+        const page = context.pages()[0] || await context.newPage();
+        await page.goto(`https://www.instagram.com/direct/t/${tid}/`, { waitUntil: 'domcontentloaded' });
+        await page.waitForTimeout(5000);
+
+        // Dismiss popups
+        try {
+          const btn = page.getByRole('button', { name: /나중에|Not Now/i });
+          if (await btn.first().isVisible({ timeout: 2000 })) await btn.first().click();
+        } catch {}
+        await page.waitForTimeout(1000);
+
+        // Extract messages from DOM
+        const messages = await page.evaluate(() => {
+          const result = [];
+          // Find message containers - Instagram uses div with role="row" or specific data attributes
+          const rows = document.querySelectorAll('div[role="row"]');
+          rows.forEach((row) => {
+            const textEl = row.querySelector('div[dir="auto"]');
+            if (!textEl) return;
+            const text = textEl.innerText?.trim();
+            if (!text) return;
+
+            // Determine if sent or received by checking position/style
+            const wrapper = row.closest('[class]');
+            const style = wrapper ? window.getComputedStyle(wrapper) : null;
+            const isSent = row.innerHTML.includes('rgb(99, 91, 255)') ||
+                           row.innerHTML.includes('#635BFF') ||
+                           row.querySelector('[style*="flex-end"]') !== null;
+
+            result.push({ text, isSent });
+          });
+          return result;
+        });
+
+        // If role="row" didn't work, try alternative extraction
+        if (messages.length === 0) {
+          const altMessages = await page.evaluate(() => {
+            const result = [];
+            const allDivs = document.querySelectorAll('div[dir="auto"]');
+            const seen = new Set();
+            allDivs.forEach((el) => {
+              const text = el.innerText?.trim();
+              if (!text || text.length > 500 || seen.has(text)) return;
+              // Skip UI elements
+              if (['메시지 입력...', '검색', 'Message...'].includes(text)) return;
+              if (el.closest('nav') || el.closest('header')) return;
+              seen.add(text);
+
+              // Check if element is in right-aligned (sent) bubble
+              const rect = el.getBoundingClientRect();
+              const isSent = rect.left > window.innerWidth / 2;
+
+              result.push({ text, isSent });
+            });
+            return result;
+          });
+          if (altMessages.length > 0) messages.push(...altMessages);
+        }
+
+        // Get thread participant name
+        const participant = await page.evaluate(() => {
+          const header = document.querySelector('header');
+          if (!header) return null;
+          const spans = header.querySelectorAll('span');
+          for (const s of spans) {
+            const t = s.innerText?.trim();
+            if (t && !['메시지', 'Direct', '뒤로'].includes(t) && t.length < 30) return t;
+          }
+          return null;
+        });
+
+        return {
+          provider: 'insta',
+          mode: 'messages',
+          threadId: tid,
+          participant,
+          totalCount: messages.length,
+          messages,
+        };
+      } finally {
+        await context.close();
+      }
+    },
+
+    async listComments({ postId } = {}) {
+      return withProviderSession(async () => {
+        const shortcode = String(postId || '').trim();
+        if (!shortcode) {
+          throw new Error('postId (shortcode) is required.');
+        }
+        const comments = await instaApi.getComments(shortcode);
+        return {
+          provider: 'insta',
+          mode: 'comments',
+          postId: shortcode,
+          totalCount: comments.length,
+          comments,
+        };
+      });
+    },
+
     async analyzePost({ postId } = {}) {
       return withProviderSession(async () => {
         const shortcode = String(postId || '').trim();

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(() =>
@@ -231,6 +241,27 @@ const runCommand = async (command, opts = {}) => {
       }
       return withProvider(() => provider.unlikeComment({ commentId: opts.commentId }))();
 
+    case 'send-dm':
+      if (!opts.username && !opts.threadId) {
+        throw createError('MISSING_PARAM', 'send-dm requires --username or --thread-id');
+      }
+      if (!opts.text) {
+        throw createError('MISSING_PARAM', 'send-dm requires --text');
+      }
+      return withProvider(() => provider.sendDm({ username: opts.username, threadId: opts.threadId, text: opts.text }))();
+
+    case 'list-messages':
+      if (!opts.threadId) {
+        throw createError('MISSING_PARAM', 'list-messages requires --thread-id');
+      }
+      return withProvider(() => provider.listMessages({ threadId: opts.threadId }))();
+
+    case 'list-comments':
+      if (!opts.postId) {
+        throw createError('MISSING_PARAM', 'list-comments requires --post-id');
+      }
+      return withProvider(() => provider.listComments({ postId: opts.postId }))();
+
     case 'analyze-post':
       if (!opts.postId) {
         throw createError('MISSING_PARAM', 'analyze-post requires --post-id');