viruagent-cli 0.8.0 → 0.8.1

package/README.ko.md

@@ -24,13 +24,13 @@
 
 ## 지원 플랫폼
 
-| 플랫폼 | 로그인 | 주요 기능 | 가이드 |
-|--------|--------|----------|--------|
-| **Tistory** | Playwright (카카오) | 글 발행, 임시저장, 카테고리, 이미지 업로드 | [가이드](docs/ko/guide-tistory.md) |
-| **Naver Blog** | Playwright (네이버) | 글 발행, 카테고리, SE Editor, 이미지 업로드 | [가이드](docs/ko/guide-naver.md) |
-| **Naver Cafe** | HTTP (브라우저 불필요) | 카페 가입 (캡차 자동해결), 글쓰기, 게시판 조회 | [가이드](docs/ko/guide-naver.md) |
-| **Instagram** | HTTP (브라우저 불필요) | 좋아요, 댓글, 팔로우, 포스팅, 프로필, 피드 | [가이드](docs/ko/guide-instagram.md) |
-| **X (Twitter)** | HTTP (쿠키 인증) | 트윗, 좋아요, 리트윗, 팔로우, 검색, 타임라인, 미디어 업로드 | [가이드](docs/ko/guide-x.md) |
+| 플랫폼 | 주요 기능 | 가이드 |
+|--------|----------|--------|
+| **Tistory** | 글 발행, 임시저장, 카테고리, 이미지 업로드 | [가이드](docs/ko/guide-tistory.md) |
+| **Naver Blog** | 글 발행, 카테고리, SE Editor, 이미지 업로드 | [가이드](docs/ko/guide-naver.md) |
+| **Naver Cafe** | 카페 가입 (모바일 5회 캡차 면제), 글쓰기, 게시판 조회, 이미지 업로드 (슬라이드/콜라주) | [가이드](docs/ko/guide-naver-cafe.md) |
+| **Instagram** | 좋아요, 댓글, 팔로우, 포스팅, 프로필, 피드 | [가이드](docs/ko/guide-instagram.md) |
+| **X (Twitter)** | 트윗, 좋아요, 리트윗, 팔로우, 검색, 타임라인, 미디어 업로드 | [가이드](docs/ko/guide-x.md) |
 
 ## 동작 방식
 
@@ -135,13 +135,14 @@ npx viruagent-cli login --provider x --auth-token <토큰> --ct0 <ct0>
 | "X에서 AI 도구 검색해줘" | search → 결과 반환 |
 | "X에서 IT 개발자 좋아요하고 팔로우해줘" | search → like + follow (딜레이 자동 적용) |
 | "내 X 타임라인 보여줘" | getFeed → 최신 트윗 표시 |
-| "이 네이버 카페 가입해줘" | cafe-id → cafe-join (캡차 자동해결) |
+| "이 네이버 카페 가입해줘" | cafe-id → cafe-join (모바일 5회 캡차 면제) |
 | "네이버 카페에 글 써줘" | cafe-list → cafe-write |
 
 ## 플랫폼별 가이드
 
 - **[Tistory 가이드](docs/ko/guide-tistory.md)** — 블로그 발행, 이미지 업로드, 카테고리
 - **[Naver Blog 가이드](docs/ko/guide-naver.md)** — SE Editor, 블로그 발행, 이미지 업로드
+- **[Naver Cafe 가이드](docs/ko/guide-naver-cafe.md)** — 카페 가입 (모바일 5회 캡차 면제), 글쓰기, 슬라이드/콜라주
 - **[Instagram 가이드](docs/ko/guide-instagram.md)** — 18개 API 메서드, rate limit 규칙, AI 댓글
 - **[X (Twitter) 가이드](docs/ko/guide-x.md)** — GraphQL API, queryId 동적 동기화, rate limit 규칙
 
@@ -165,7 +166,7 @@ npx viruagent-cli login --provider x --auth-token <토큰> --ct0 <ct0>
 | Rate Limiting | 유저별 영속 카운터 + 랜덤 딜레이 |
 | 이미지 검색 | DuckDuckGo, Wikimedia Commons |
 | 네이버 에디터 | SE Editor 컴포넌트 모델 + RabbitWrite API |
-| 네이버 카페 API | 순수 HTTP (가입, 글쓰기, 게시판 조회, 2Captcha 자동해결) |
+| 네이버 카페 API | 순수 HTTP (가입, 글쓰기, 게시판 조회, 사용자 캡차 입력) |
 | 출력 형식 | JSON envelope (`{ ok, data }` / `{ ok, error, hint }`) |
 
 ## Contributing

package/README.md

@@ -24,14 +24,14 @@ Designed not for humans, but for **AI agents**.
 
 ## Supported Platforms
 
-| Platform | Login | Features | Guide |
-|----------|-------|----------|-------|
-| **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) |
-| **Naver Cafe** | HTTP (No Browser) | Cafe Join (auto-captcha), Write Post, Board List | [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) |
-| **Reddit** | OAuth2 / Cookie | Post, Comment, Upvote, Search, Subscribe, Subreddit | [Guide](docs/en/guide-reddit.md) |
+| Platform | Features | Guide |
+|----------|----------|-------|
+| **Tistory** | Publish, Draft, Categories, Image Upload | [Guide](docs/en/guide-tistory.md) |
+| **Naver Blog** | Publish, Categories, SE Editor, Image Upload | [Guide](docs/en/guide-naver.md) |
+| **Naver Cafe** | Cafe Join (captcha-free for 5 joins), Write Post, Board List, Image Upload (slide/collage) | [Guide](docs/en/guide-naver-cafe.md) |
+| **Instagram** | Like, Comment, Follow, Post, Profile, Feed, Rate Limit | [Guide](docs/en/guide-instagram.md) |
+| **X (Twitter)** | Tweet, Like, Retweet, Follow, Search, Timeline, Media Upload | [Guide](docs/en/guide-x.md) |
+| **Reddit** | Post, Comment, Upvote, Search, Subscribe, Subreddit | [Guide](docs/en/guide-reddit.md) |
 
 ## How It Works
 
@@ -136,13 +136,14 @@ npx viruagent-cli login --provider x --auth-token <token> --ct0 <ct0>
 | "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) |
+| "Join this Naver cafe" | cafe-id → cafe-join (captcha-free for 5 joins) |
 | "Write a post on Naver cafe" | cafe-list → cafe-write |
 
 ## 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
+- **[Naver Cafe Guide](docs/en/guide-naver-cafe.md)** — Cafe join (captcha-free for 5 joins), write post, slide/collage images
 - **[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
 
@@ -166,7 +167,7 @@ npx viruagent-cli login --provider x --auth-token <token> --ct0 <ct0>
 | 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) |
+| Naver Cafe API | Pure HTTP (join, write, board list, manual captcha) |
 | Output Format | JSON envelope (`{ ok, data }` / `{ ok, error, hint }`) |
 
 ## Contributing

package/bin/index.js

@@ -290,7 +290,8 @@ addProviderOption(cafeJoinCmd);
 cafeJoinCmd
   .option('--cafe-url <url>', 'Cafe URL or slug')
   .option('--nickname <nick>', 'Nickname to use (default: auto)')
-  .option('--captcha-api-key <key>', '2Captcha API key for auto-solve')
+  .option('--captcha-value <text>', 'Captcha answer text (from AI agent reading the image)')
+  .option('--captcha-key <key>', 'Captcha key (returned by previous captcha_required response)')
   .option('--answers <answers>', 'Comma-separated answers for join questions')
   .action((opts) => execute('cafe-join', opts));
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viruagent-cli",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "AI-agent-optimized CLI for blog/SNS publishing and engagement (Tistory, Naver, Instagram, X/Twitter, Reddit)",
   "private": false,
   "type": "commonjs",

package/skills/va-naver/SKILL.md

@@ -23,7 +23,7 @@ Naver 블로그 퍼블리싱을 위한 viruagent-cli 가이드. 항상 `--provid
 | list-categories | va-naver-categories | 카테고리 조회 |
 | list-posts, read-post | va-naver-posts | 글 목록/읽기 |
 | cafe-id | va-naver-cafe-id | 카페 ID 추출 |
-| cafe-join | va-naver-cafe-join | 카페 가입 (캡차 자동해결) |
+| cafe-join | va-naver-cafe-join | 카페 가입 (모바일 5회 캡차 면제) |
 | cafe-list | va-naver-cafe-list | 카페 게시판 목록 |
 | cafe-write | va-naver-cafe-write | 카페 글쓰기 (슬라이드/콜라주) |
 

package/skills/va-naver-cafe-join/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: va-naver-cafe-join
-description: "Naver: 카페 가입 (캡차 자동 해결, 질문 자동 답변)"
+description: "Naver: 카페 가입 (모바일 5회 캡차 면제, 이후 사용자 입력)"
 metadata:
   category: "command"
   provider: "naver"
@@ -10,7 +10,7 @@ metadata:
 
 # va-naver-cafe-join — 카페 가입
 
-네이버 카페에 가입한다. 캡차가 있으면 2Captcha API로 자동 해결한다.
+네이버 카페에 가입한다. 모바일 헤더 사용으로 처음 5회까지 캡차 없이 가입 가능. 캡차 발생 시 사용자에게 입력을 요청한다.
 
 ## 실행
 
@@ -18,7 +18,8 @@ metadata:
 npx viruagent-cli cafe-join --provider naver \
   --cafe-url <url_or_slug> \
   [--nickname <닉네임>] \
-  [--captcha-api-key <2captcha_key>] \
+  [--captcha-value <텍스트>] \
+  [--captcha-key <키>] \
   [--answers "답1,답2"]
 ```
 
@@ -28,7 +29,8 @@ npx viruagent-cli cafe-join --provider naver \
 |--------|------|------|--------|
 | `--cafe-url` | O | 카페 URL 또는 슬러그 | - |
 | `--nickname` | - | 사용할 닉네임 | 자동 생성 |
-| `--captcha-api-key` | - | 2Captcha API 키 (캡차 자동 해결) | - |
+| `--captcha-value` | - | 캡차 이미지 텍스트 (사용자 입력) | - |
+| `--captcha-key` | - | 캡차 세션 키 (captcha_required 응답에서 제공) | - |
 | `--answers` | - | 가입 질문 답변 (쉼표 구분) | 모두 "네" |
 
 ### 가입 유형
@@ -40,15 +42,18 @@ npx viruagent-cli cafe-join --provider naver \
 
 ### 캡차 처리
 
-- `--captcha-api-key` 미제공 시: 캡차 필요한 카페는 `captcha_required` 반환
-- `--captcha-api-key` 제공 시: 2Captcha로 자동 해결 (최대 3회 재시도)
+- 모바일 버전(`x-cafe-product: mweb`) 가입은 **처음 5회까지 캡차가 발생하지 않음**
+- 캡차 발생 시: `captcha_required` 상태와 `captchaImageUrl` 반환
+- 사용자가 이미지 URL을 브라우저에서 열어 텍스트를 확인
+- `--captcha-value <텍스트> --captcha-key <키>`와 함께 재실행
+- 틀린 경우 `captcha_invalid`와 새 이미지 URL 제공 → 반복
 
 ## 에러 처리
 
 | 에러 | 조치 |
 |------|------|
 | `ALREADY_JOINED` | 이미 가입된 카페 |
-| `CAPTCHA_REQUIRED` | `--captcha-api-key` 옵션 추가 |
+| `CAPTCHA_REQUIRED` | `captchaImageUrl` 확인 후 `--captcha-value`/`--captcha-key`와 재실행 |
 | `NOT_LOGGED_IN` | `login --provider naver` 먼저 실행 |
 
 ## See Also

package/skills/va-shared/SKILL.md

@@ -64,7 +64,7 @@ SKILLS_DIR: <viruagent-cli 설치 경로>/skills/
 | va-naver-categories | `va-naver-categories/SKILL.md` | 카테고리 조회 |
 | va-naver-posts | `va-naver-posts/SKILL.md` | 글 목록/읽기 |
 | va-naver-cafe-id | `va-naver-cafe-id/SKILL.md` | 카페 ID 추출 |
-| va-naver-cafe-join | `va-naver-cafe-join/SKILL.md` | 카페 가입 (캡차 자동해결) |
+| va-naver-cafe-join | `va-naver-cafe-join/SKILL.md` | 카페 가입 (모바일 5회 캡차 면제) |
 | va-naver-cafe-list | `va-naver-cafe-list/SKILL.md` | 카페 게시판 목록 |
 | va-naver-cafe-write | `va-naver-cafe-write/SKILL.md` | 카페 글쓰기 (슬라이드/콜라주) |
 | va-insta | `va-insta/SKILL.md` | Instagram 개요 + 레이트리밋 |

package/src/providers/naver/cafeApiClient.js

@@ -198,39 +198,6 @@ const createCafeApiClient = ({ sessionPath }) => {
     return buffer.toString('base64');
   };
 
-  const solveCaptchaWith2Captcha = async (imageBase64, apiKey) => {
-    const submitRes = await fetch('https://2captcha.com/in.php', {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
-      body: new URLSearchParams({
-        key: apiKey,
-        method: 'base64',
-        body: imageBase64,
-        json: '1',
-      }),
-    });
-    const submitData = await submitRes.json();
-    if (submitData.status !== 1) {
-      throw createError('CAPTCHA_SUBMIT_FAILED', `2Captcha submit failed: ${submitData.request}`);
-    }
-
-    const captchaId = submitData.request;
-
-    // Poll for result (max 120s)
-    for (let i = 0; i < 24; i++) {
-      await new Promise((r) => setTimeout(r, 5000));
-      const pollRes = await fetch(
-        `https://2captcha.com/res.php?key=${apiKey}&action=get&id=${captchaId}&json=1`,
-      );
-      const pollData = await pollRes.json();
-      if (pollData.status === 1) return pollData.request;
-      if (pollData.request !== 'CAPCHA_NOT_READY') {
-        throw createError('CAPTCHA_POLL_FAILED', `2Captcha poll failed: ${pollData.request}`);
-      }
-    }
-    throw createError('CAPTCHA_TIMEOUT', '2Captcha timeout (120s)');
-  };
-
   const submitJoin = async (cafeId, { alimCode, clubTempId, applyPayload }) => {
     const cookieStr = getCookieStr();
     const queryParams = new URLSearchParams({
@@ -582,7 +549,6 @@ const createCafeApiClient = ({ sessionPath }) => {
     checkNickname,
     validateCaptcha,
     downloadCaptchaImage,
-    solveCaptchaWith2Captcha,
     submitJoin,
     getBoardList,
     getEditorInfo,

package/src/providers/naver/index.js

@@ -241,7 +241,7 @@ const createNaverProvider = ({ sessionPath, account }) => {
       });
     },
 
-    async cafeJoin({ cafeUrl, nickname, captchaApiKey, answers } = {}) {
+    async cafeJoin({ cafeUrl, nickname, captchaValue, captchaKey: inputCaptchaKey, answers } = {}) {
       return withProviderSession(async () => {
         if (!cafeUrl) {
           const err = new Error('cafeUrl is required');
@@ -262,60 +262,41 @@ const createNaverProvider = ({ sessionPath, account }) => {
           finalNickname = `user${Math.floor(Math.random() * 9000 + 1000)}`;
         }
 
-        // 4. Handle captcha
-        let captchaKey = form.captchaKey;
-        let captchaValue = '';
+        // 4. Handle captcha — prompt user for manual input
+        let captchaKey = inputCaptchaKey || form.captchaKey;
+        let resolvedCaptchaValue = captchaValue || '';
 
-        if (form.needCaptcha) {
-          if (!captchaApiKey) {
-            return {
-              provider: 'naver',
-              mode: 'cafe-join',
-              status: 'captcha_required',
-              cafeId: id,
-              slug,
-              cafeName: form.cafeName,
-              captchaImageUrl: form.captchaImageUrl,
-              captchaKey: form.captchaKey,
-              message: 'Captcha is required. Provide --captcha-api-key for auto-solve or solve manually.',
-            };
-          }
-
-          // Auto-solve with 2Captcha (max 3 attempts)
-          let solved = false;
-          let captchaImageUrl = form.captchaImageUrl;
-
-          for (let attempt = 0; attempt < 3; attempt++) {
-            const imgBase64 = await cafeApi.downloadCaptchaImage(captchaImageUrl);
-            captchaValue = await cafeApi.solveCaptchaWith2Captcha(imgBase64, captchaApiKey);
-            const validateResult = await cafeApi.validateCaptcha(captchaKey, captchaValue);
-
-            if (validateResult.valid) {
-              solved = true;
-              break;
-            }
-
-            // Update captcha for retry
-            if (validateResult.captchaKey) {
-              captchaKey = validateResult.captchaKey;
-              captchaImageUrl = validateResult.captchaImageUrl;
-            } else {
-              const newForm = await cafeApi.getJoinForm(id);
-              captchaKey = newForm.captchaKey;
-              captchaImageUrl = newForm.captchaImageUrl;
-            }
-            captchaValue = '';
-          }
+        if (form.needCaptcha && !resolvedCaptchaValue) {
+          return {
+            provider: 'naver',
+            mode: 'cafe-join',
+            status: 'captcha_required',
+            cafeId: id,
+            slug,
+            cafeName: form.cafeName,
+            captchaKey: form.captchaKey,
+            captchaImageUrl: form.captchaImageUrl,
+            nickname: finalNickname,
+            message: 'Captcha required. Open the captchaImageUrl in a browser, read the text, and re-run with --captcha-value <text> --captcha-key <key>',
+          };
+        }
 
-          if (!solved) {
+        // Validate captcha if provided
+        if (form.needCaptcha && resolvedCaptchaValue) {
+          const validateResult = await cafeApi.validateCaptcha(captchaKey, resolvedCaptchaValue);
+          if (!validateResult.valid) {
+            const newForm = await cafeApi.getJoinForm(id);
             return {
               provider: 'naver',
               mode: 'cafe-join',
-              status: 'captcha_failed',
+              status: 'captcha_invalid',
               cafeId: id,
               slug,
               cafeName: form.cafeName,
-              message: 'Captcha solve failed after 3 attempts.',
+              captchaKey: newForm.captchaKey,
+              captchaImageUrl: newForm.captchaImageUrl,
+              nickname: finalNickname,
+              message: 'Captcha answer was wrong. Open the new captchaImageUrl, read the text, and retry with --captcha-value <text> --captcha-key <key>',
             };
           }
         }

package/src/runner.js

@@ -346,7 +346,8 @@ const runCommand = async (command, opts = {}) => {
       return withProvider(() => provider.cafeJoin({
         cafeUrl: opts.cafeUrl,
         nickname: opts.nickname || undefined,
-        captchaApiKey: opts.captchaApiKey || undefined,
+        captchaValue: opts.captchaValue || undefined,
+        captchaKey: opts.captchaKey || undefined,
         answers: opts.answers ? parseList(opts.answers) : undefined,
       }))();