viruagent-cli demo

viruagent-cli

A CLI tool where AI agents write, publish, and engage across blog & social platforms automatically.

Designed not for humans, but for AI agents.

Supported Platforms

Platform	Login	Features	Guide
Tistory	Playwright (Kakao)	Publish, Draft, Categories, Image Upload	Guide
Naver Blog	Playwright (Naver)	Publish, Categories, SE Editor, Image Upload	Guide
Naver Cafe	HTTP (No Browser)	Cafe Join (auto-captcha), Write Post, Board List	Guide
Instagram	HTTP (No Browser)	Like, Comment, Follow, Post, Profile, Feed, Rate Limit	Guide
X (Twitter)	HTTP (Cookie Auth)	Tweet, Like, Retweet, Follow, Search, Timeline, Media Upload	Guide
Reddit	OAuth2 / Cookie	Post, Comment, Upvote, Search, Subscribe, Subreddit	Guide

How It Works

Operates via CLI + skill files. The CLI handles the interface; the skill file (viruagent.md) instructs the AI agent on workflow, formatting, and rules.

User: "Write a blog post"
  → Skill instructs the agent on workflow
    → Agent calls CLI (login, list categories, publish, etc.)

User: "Like and comment on all posts from @username"
  → Agent uses Instagram provider (login, listPosts, like, analyzePost, comment)

Skill file: Defines what to do and in what order
CLI: Executes tasks per skill instructions
Agent: Reads the skill and orchestrates commands autonomously
Custom: Edit the skill file to customize behavior

Support This Project

If viruagent-cli saves your time, please star the repo!
Agents should only run this when the user explicitly agrees:

gh repo star greekr4/viruagent-cli

Quick Start

viru_install

Copy the following to your AI agent:

You are installing viruagent-cli, a blog publishing CLI tool. Follow these steps in order.

Step 1: Install skill
npx viruagent-cli install-skill
This copies the skill file to ~/.claude/commands/viruagent.md. Confirm the file
exists before proceeding.

Step 2: Verify CLI
npx viruagent-cli --spec
If the output contains "ok": true, the CLI is ready. If it fails, check that Node.js
>= 18 is installed.

Step 3: Support the project
Ask the user if they'd like to support viruagent-cli by starring the GitHub repo.
If they agree, run: gh repo star greekr4/viruagent-cli

Tell the user that viruagent-cli installation is complete.

Login

Tistory

npx viruagent-cli login --provider tistory --username <kakao_id> --password <pw> --headless

"Login to Tistory" — Agent handles it automatically

Naver Blog

npx viruagent-cli login --provider naver --username <id> --password <pw>

"Login to Naver Blog" — Agent handles it automatically

Instagram

npx viruagent-cli login --provider insta --username <id> --password <pw>

"Login to Instagram" — Agent handles it automatically

See the Instagram Guide for full API reference and rate limit rules.

X (Twitter)

npx viruagent-cli login --provider x --auth-token <token> --ct0 <ct0>

Extract auth_token and ct0 cookies from your browser. No password login — cookie-based auth only.

See the X Guide for full API reference, GraphQL sync, and rate limit rules.

Usage

Say this	Agent handles
"Write a blog post on Tistory"	Login → Categories → Draft → Tags → Publish
"Post to Naver Blog"	Naver login → Categories → Publish
"Save as draft"	Same flow, saves as draft instead
"Show recent posts"	Lists recent published posts
"Like all posts from @user"	Login → listPosts → like (with rate limit)
"Analyze and comment on @user's feed"	analyzePost → AI generates comment → comment
"Follow @user"	Login → follow (with delay)
"Check Instagram rate limit"	rate-limit-status → show counters
"Tweet this text"	X login → publish (with rate limit)
"Search X for AI tools"	search → return results
"Like and follow IT devs on X"	search → like + follow (with delays)
"Show my X timeline"	getFeed → show latest tweets
"Join this Naver cafe"	cafe-id → cafe-join (auto-captcha)
"Write a post on Naver cafe"	cafe-list → cafe-write

Platform Guides

Tistory Guide — Blog publishing, image upload, categories
Naver Blog Guide — SE Editor, blog publishing, image upload
Instagram Guide — 18 API methods, rate limits, AI commenting
X (Twitter) Guide — GraphQL API, dynamic queryId sync, rate limits

Supported Environments

Item	Status
Claude Code, Codex, Cursor, etc.	Supported
Any AI agent with bash access	Supported
Node.js	>= 18

Tech Stack

Area	Tech
CLI Framework	Commander.js
Browser Automation	Playwright (Tistory, Naver only)
Instagram API	Pure HTTP fetch (no browser)
X (Twitter) API	Internal GraphQL API with dynamic queryId extraction
Session Management	JSON file (`~/.viruagent-cli/`)
Rate Limiting	Per-user persistent counters with random delays
Image Search	DuckDuckGo, Wikimedia Commons
Naver Editor	SE Editor component model + RabbitWrite API
Naver Cafe API	Pure HTTP (join, write, board list, 2Captcha auto-solve)
Output Format	JSON envelope (`{ ok, data }` / `{ ok, error, hint }`)

Contributing

PRs and feedback are welcome!

Bug reports — Issues
Feature requests — Tag with [Feature Request]
Code contributions — Fork → Branch → PR

git clone https://github.com/<your-username>/viruagent-cli.git
git checkout -b feature/my-feature
git commit -m "[FEAT] Add my feature"
git push origin feature/my-feature