viruagent-cli 0.6.2 → 0.7.0

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) |
 
 ## 동작 방식
 
@@ -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
 
@@ -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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viruagent-cli",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "description": "AI-agent-optimized CLI for blog publishing (Tistory, Naver) and Instagram automation",
   "private": false,
   "type": "commonjs",