viruagent-cli 0.5.0 → 0.6.0

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
-```

package/skills/viruagent.md

@@ -1,77 +0,0 @@
----
-name: viruagent
-description: viruagent-cli overview. Routes to platform-specific skills — /viruagent-tistory, /viruagent-naver, /viruagent-insta.
-triggers:
-  - 블로그
-  - blog
-  - viruagent
-  - 블로그 써줘
-  - publish blog
----
-
-# viruagent — Platform Router
-
-You are an agent using `viruagent-cli`. Route to the correct skill based on the user's request.
-
-## Available Skills
-
-| Skill | Platform | Triggers |
-|-------|----------|----------|
-| `/viruagent-tistory` | Tistory Blog | 티스토리, tistory |
-| `/viruagent-naver` | Naver Blog | 네이버, naver blog |
-| `/viruagent-insta` | Instagram | 인스타, instagram, 좋아요, 댓글, 팔로우 |
-
-## Quick Reference
-
-```bash
-# Check available providers
-npx viruagent-cli list-providers
-
-# Check CLI schema
-npx viruagent-cli --spec
-```
-
-All responses are JSON: `{ "ok": true, "data": {...} }` on success, `{ "ok": false, "error": "...", "message": "...", "hint": "..." }` on failure.
-
-## Routing Rules
-
-- User says "블로그 써줘" without specifying platform → ask which platform (Tistory or Naver)
-- User says "티스토리" or "tistory" → use `/viruagent-tistory`
-- User says "네이버" or "naver" → use `/viruagent-naver`
-- User says "인스타" or mentions like/comment/follow → use `/viruagent-insta`
-
-## Writing Rules (Shared)
-
-These rules apply to both Tistory and Naver blog publishing:
-
-- **Title**: Include the primary keyword. 10~20 characters. Short and impactful.
-- **Length**: 3000~4000 characters. Aim for depth, not padding.
-- **Paragraphs**: 3~5 sentences each. Do NOT write 1~2 sentence paragraphs repeatedly.
-- **Introduction**: 2~3 paragraphs that set context and build reader empathy.
-- **Body sections**: Each h2 section must have 2~3 substantial paragraphs. Do NOT jump straight to bullet lists.
-- **Lists**: Use sparingly — only for 3+ concrete, scannable items.
-- **Evidence**: Each body section should include at least one of: expert quote, data point, real example.
-- **Perspective shift**: Include at least one moment that reframes the reader's thinking.
-- **Transitions**: Connect sections with bridge sentences.
-- **Bold**: Use `<strong>` for key terms (2~3 per section max).
-- **Subheadings**: Use `<h2>` for ALL section titles. Do NOT use `<h3>`.
-- **Tone**: Conversational but substantive.
-- **Closing**: End with a specific, actionable suggestion.
-- **SEO**: Primary keyword in title, first paragraph, and at least one `<h2>`.
-- **Tags**: Exactly 5, comma-separated, matching post language.
-
-## Error Recovery
-
-| Error | Action |
-|---|---|
-| `NOT_LOGGED_IN` / `SESSION_EXPIRED` | Run `login` again |
-| `MISSING_CONTENT` | Ensure `--content` or `--content-file` is provided |
-| `PROVIDER_NOT_FOUND` | Check with `list-providers` |
-| `INVALID_POST_ID` | Verify post ID with `list-posts` |
-
-## Important Notes
-
-- Always use `--dry-run` before actual publish to validate parameters
-- Content must be valid HTML
-- Default provider is `tistory`
-- For `--content-file`, use absolute paths