viruagent-cli 0.6.2 → 0.7.1

package/README.ko.md

@@ -29,6 +29,7 @@
 | **Tistory** | Playwright (카카오) | 글 발행, 임시저장, 카테고리, 이미지 업로드 | [가이드](docs/ko/guide-tistory.md) |
 | **Naver Blog** | Playwright (네이버) | 글 발행, 카테고리, SE Editor, 이미지 업로드 | [가이드](docs/ko/guide-naver.md) |
 | **Instagram** | HTTP (브라우저 불필요) | 좋아요, 댓글, 팔로우, 포스팅, 프로필, 피드 | [가이드](docs/ko/guide-instagram.md) |
+| **X (Twitter)** | HTTP (쿠키 인증) | 트윗, 좋아요, 리트윗, 팔로우, 검색, 타임라인, 미디어 업로드 | [가이드](docs/ko/guide-x.md) |
 
 ## 동작 방식
 
@@ -50,7 +51,7 @@
 
 ## 빠른 시작
 
-![viru_install](https://github.com/user-attachments/assets/35efb57f-fada-44c0-8dd4-6d586ef33a7c)
+![viruagent-cli demo](demo/demo.gif)
 
 아래 내용을 AI 에이전트에게 그대로 복사해서 보여주세요.
 
@@ -95,6 +96,15 @@ npx viruagent-cli login --provider insta --username <인스타 ID> --password <
 >
 > 전체 API 레퍼런스와 rate limit 규칙은 [Instagram 가이드](docs/ko/guide-instagram.md)를 참고하세요.
 
+### X (Twitter)
+
+```bash
+npx viruagent-cli login --provider x --auth-token <토큰> --ct0 <ct0>
+```
+> 브라우저에서 `auth_token`과 `ct0` 쿠키를 추출하세요. 비밀번호 로그인 없음 — 쿠키 기반 인증만 지원.
+>
+> 전체 API 레퍼런스, GraphQL 동기화, rate limit 규칙은 [X 가이드](docs/ko/guide-x.md)를 참고하세요.
+
 ## 사용법
 
 | 이렇게 말하면 | 에이전트가 알아서 |
@@ -107,12 +117,17 @@ npx viruagent-cli login --provider insta --username <인스타 ID> --password <
 | "이 사람 피드 분석해서 댓글 달아줘" | analyzePost → AI 댓글 생성 → comment |
 | "@user 팔로우해줘" | 로그인 → follow (딜레이 자동 적용) |
 | "인스타 rate limit 확인해줘" | rate-limit-status → 카운터 표시 |
+| "이 내용으로 트윗해줘" | X 로그인 → publish (rate limit 자동 적용) |
+| "X에서 AI 도구 검색해줘" | search → 결과 반환 |
+| "X에서 IT 개발자 좋아요하고 팔로우해줘" | search → like + follow (딜레이 자동 적용) |
+| "내 X 타임라인 보여줘" | getFeed → 최신 트윗 표시 |
 
 ## 플랫폼별 가이드
 
 - **[Tistory 가이드](docs/ko/guide-tistory.md)** — 블로그 발행, 이미지 업로드, 카테고리
 - **[Naver Blog 가이드](docs/ko/guide-naver.md)** — SE Editor, 블로그 발행, 이미지 업로드
 - **[Instagram 가이드](docs/ko/guide-instagram.md)** — 18개 API 메서드, rate limit 규칙, AI 댓글
+- **[X (Twitter) 가이드](docs/ko/guide-x.md)** — GraphQL API, queryId 동적 동기화, rate limit 규칙
 
 ## 지원 환경
 
@@ -129,6 +144,7 @@ npx viruagent-cli login --provider insta --username <인스타 ID> --password <
 | CLI 프레임워크 | Commander.js |
 | 브라우저 자동화 | Playwright (Tistory, Naver만 사용) |
 | Instagram API | 순수 HTTP fetch (브라우저 불필요) |
+| X (Twitter) API | 내부 GraphQL API + queryId 동적 추출 |
 | 세션 관리 | JSON 파일 (`~/.viruagent-cli/`) |
 | Rate Limiting | 유저별 영속 카운터 + 랜덤 딜레이 |
 | 이미지 검색 | DuckDuckGo, Wikimedia Commons |

package/README.md

@@ -29,6 +29,7 @@ Designed not for humans, but for **AI agents**.
 | **Tistory** | Playwright (Kakao) | Publish, Draft, Categories, Image Upload | [Guide](docs/en/guide-tistory.md) |
 | **Naver Blog** | Playwright (Naver) | Publish, Categories, SE Editor, Image Upload | [Guide](docs/en/guide-naver.md) |
 | **Instagram** | HTTP (No Browser) | Like, Comment, Follow, Post, Profile, Feed, Rate Limit | [Guide](docs/en/guide-instagram.md) |
+| **X (Twitter)** | HTTP (Cookie Auth) | Tweet, Like, Retweet, Follow, Search, Timeline, Media Upload | [Guide](docs/en/guide-x.md) |
 
 ## How It Works
 
@@ -50,7 +51,7 @@ User: "Like and comment on all posts from @username"
 
 ## Quick Start
 
-![viru_install](https://github.com/user-attachments/assets/35efb57f-fada-44c0-8dd4-6d586ef33a7c)
+![viruagent-cli demo](demo/demo.gif)
 
 Copy the following to your AI agent:
 
@@ -95,6 +96,15 @@ npx viruagent-cli login --provider insta --username <id> --password <pw>
 >
 > See the [Instagram Guide](docs/en/guide-instagram.md) for full API reference and rate limit rules.
 
+### X (Twitter)
+
+```bash
+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](docs/en/guide-x.md) for full API reference, GraphQL sync, and rate limit rules.
+
 ## Usage
 
 | Say this | Agent handles |
@@ -107,12 +117,17 @@ npx viruagent-cli login --provider insta --username <id> --password <pw>
 | "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 |
 
 ## Platform Guides
 
 - **[Tistory Guide](docs/en/guide-tistory.md)** — Blog publishing, image upload, categories
 - **[Naver Blog Guide](docs/en/guide-naver.md)** — SE Editor, blog publishing, image upload
 - **[Instagram Guide](docs/en/guide-instagram.md)** — 18 API methods, rate limits, AI commenting
+- **[X (Twitter) Guide](docs/en/guide-x.md)** — GraphQL API, dynamic queryId sync, rate limits
 
 ## Supported Environments
 
@@ -129,6 +144,7 @@ npx viruagent-cli login --provider insta --username <id> --password <pw>
 | 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 |

package/bin/index.js

@@ -18,7 +18,7 @@ program
 
 // Global options
 const addProviderOption = (cmd) =>
-  cmd.option('--provider <name>', 'Provider name (tistory, naver, insta)', 'tistory');
+  cmd.option('--provider <name>', 'Provider name (tistory, naver, insta, x, reddit)', 'tistory');
 
 const addDryRunOption = (cmd) =>
   cmd.option('--dry-run', 'Validate params without executing', false);
@@ -49,6 +49,10 @@ loginCmd
   .option('--headless', 'Run browser in headless mode', false)
   .option('--manual', 'Use manual login mode', false)
   .option('--two-factor-code <code>', '2FA verification code')
+  .option('--auth-token <token>', 'Auth token (X provider)')
+  .option('--ct0 <ct0>', 'CT0 token (X provider)')
+  .option('--client-id <id>', 'OAuth Client ID (Reddit)')
+  .option('--client-secret <secret>', 'OAuth Client Secret (Reddit)')
   .action((opts) => execute('login', opts));
 
 const publishCmd = program
@@ -70,6 +74,9 @@ publishCmd
   .option('--minimum-image-count <n>', 'Minimum required images', '1')
   .option('--no-auto-upload-images', 'Disable automatic image uploading')
   .option('--no-enforce-system-prompt', 'Disable system prompt enforcement')
+  .option('--subreddit <name>', 'Subreddit name (Reddit)')
+  .option('--kind <type>', 'Post kind: self or link (Reddit)', 'self')
+  .option('--flair <id>', 'Flair template ID (Reddit)')
   .action((opts) => execute('publish', opts));
 
 const saveDraftCmd = program
@@ -250,6 +257,22 @@ const rateLimitCmd = program
 addProviderOption(rateLimitCmd);
 rateLimitCmd.action((opts) => execute('rate-limit-status', opts));
 
+const subscribeCmd = program
+  .command('subscribe')
+  .description('Subscribe to a subreddit (Reddit)');
+addProviderOption(subscribeCmd);
+subscribeCmd
+  .option('--subreddit <name>', 'Subreddit name')
+  .action((opts) => execute('subscribe', opts));
+
+const unsubscribeCmd = program
+  .command('unsubscribe')
+  .description('Unsubscribe from a subreddit (Reddit)');
+addProviderOption(unsubscribeCmd);
+unsubscribeCmd
+  .option('--subreddit <name>', 'Subreddit name')
+  .action((opts) => execute('unsubscribe', opts));
+
 // --- Utility commands ---
 
 const installSkillCmd = program

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viruagent-cli",
-  "version": "0.6.2",
+  "version": "0.7.1",
   "description": "AI-agent-optimized CLI for blog publishing (Tistory, Naver) and Instagram automation",
   "private": false,
   "type": "commonjs",
@@ -42,6 +42,7 @@
   },
   "dependencies": {
     "commander": "^14.0.3",
-    "playwright": "^1.58.2"
+    "playwright": "^1.58.2",
+    "x-client-transaction-id": "^0.2.0"
   }
 }

package/src/providers/insta/apiClient.js

@@ -167,9 +167,10 @@ const createInstaApiClient = ({ sessionPath }) => {
       ...options.headers,
     };
 
-    const res = await fetch(url, { ...options, headers, redirect: 'manual' });
+    const redirectMode = options.followRedirect ? 'follow' : 'manual';
+    const res = await fetch(url, { ...options, headers, redirect: redirectMode });
 
-    if (res.status === 302 || res.status === 301) {
+    if (!options.followRedirect && (res.status === 302 || res.status === 301)) {
       const location = res.headers.get('location') || '';
       if (location.includes('/accounts/login')) {
         throw new Error('Session expired. Please log in again.');
@@ -608,6 +609,7 @@ const createInstaApiClient = ({ sessionPath }) => {
           Offset: '0',
         },
         body: imageBuffer,
+        followRedirect: true,
       },
     );
     const data = await res.json();