viruagent-cli 0.8.0 → 0.9.0

package/README.ko.md

@@ -24,13 +24,14 @@
 
 ## 지원 플랫폼
 
-| 플랫폼 | 로그인 | 주요 기능 | 가이드 |
-|--------|--------|----------|--------|
-| **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) |
+| **Threads** | 글쓰기, 답글, 좋아요, 팔로우, 이미지 업로드, 검색, 피드 | [가이드](docs/ko/guide-threads.md) |
 
 ## 동작 방식
 
@@ -119,6 +120,13 @@ npx viruagent-cli login --provider x --auth-token <토큰> --ct0 <ct0>
 >
 > 전체 API 레퍼런스, GraphQL 동기화, rate limit 규칙은 [X 가이드](docs/ko/guide-x.md)를 참고하세요.
 
+### Threads
+
+```bash
+npx viruagent-cli login --provider threads --username <인스타 ID> --password <비밀번호>
+```
+> Instagram 계정으로 로그인합니다. 쓰레드는 별도 계정이 없습니다.
+
 ## 사용법
 
 | 이렇게 말하면 | 에이전트가 알아서 |
@@ -135,15 +143,19 @@ 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 |
+| "쓰레드에 글 올려줘" | login → publish (텍스트 또는 이미지) |
+| "이 쓰레드에 답글 달아줘" | comment (rate limit 자동 적용) |
 
 ## 플랫폼별 가이드
 
 - **[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 규칙
+- **[Threads 가이드](docs/ko/guide-threads.md)** — Barcelona API, IGT:2 토큰 인증, rate limit 규칙
 
 ## 지원 환경
 
@@ -165,7 +177,8 @@ npx viruagent-cli login --provider x --auth-token <토큰> --ct0 <ct0>
 | Rate Limiting | 유저별 영속 카운터 + 랜덤 딜레이 |
 | 이미지 검색 | DuckDuckGo, Wikimedia Commons |
 | 네이버 에디터 | SE Editor 컴포넌트 모델 + RabbitWrite API |
-| 네이버 카페 API | 순수 HTTP (가입, 글쓰기, 게시판 조회, 2Captcha 자동해결) |
+| 네이버 카페 API | 순수 HTTP (가입, 글쓰기, 게시판 조회, 사용자 캡차 입력) |
+| Threads API | Barcelona (Instagram Private API), IGT:2 토큰 인증 |
 | 출력 형식 | JSON envelope (`{ ok, data }` / `{ ok, error, hint }`) |
 
 ## Contributing

package/README.md

@@ -24,14 +24,15 @@ 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) |
+| **Threads** | Post, Reply, Like, Follow, Image Upload, Search, Feed | [Guide](docs/en/guide-threads.md) |
 
 ## How It Works
 
@@ -120,6 +121,13 @@ npx viruagent-cli login --provider x --auth-token <token> --ct0 <ct0>
 >
 > See the [X Guide](docs/en/guide-x.md) for full API reference, GraphQL sync, and rate limit rules.
 
+### Threads
+
+```bash
+npx viruagent-cli login --provider threads --username <instagram_id> --password <password>
+```
+> Threads uses your Instagram account. No separate login needed.
+
 ## Usage
 
 | Say this | Agent handles |
@@ -136,15 +144,19 @@ 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 |
+| "Post on Threads" | login → publish (text or image) |
+| "Reply to a thread" | comment (with rate limit) |
 
 ## 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
+- **[Threads Guide](docs/en/guide-threads.md)** — Barcelona API, IGT:2 token auth, rate limits
 
 ## Supported Environments
 
@@ -166,7 +178,8 @@ 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) |
+| Threads API | Barcelona (Instagram Private API), IGT:2 token auth |
 | Output Format | JSON envelope (`{ ok, data }` / `{ ok, error, hint }`) |
 
 ## Contributing

package/bin/index.js

@@ -18,7 +18,7 @@ program
 
 // Global options
 const addProviderOption = (cmd) =>
-  cmd.option('--provider <name>', 'Provider name (tistory, naver, insta, x, reddit)', 'tistory');
+  cmd.option('--provider <name>', 'Provider name (tistory, naver, insta, x, reddit, threads)', 'tistory');
 
 const addDryRunOption = (cmd) =>
   cmd.option('--dry-run', 'Validate params without executing', false);
@@ -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.9.0",
   "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

@@ -13,6 +13,8 @@ triggers:
   - 좋아요
   - 댓글
   - 팔로우
+  - 쓰레드
+  - threads
 metadata:
   category: "router"
   requires:
@@ -32,6 +34,7 @@ viruagent-cli를 사용하는 블로그/SNS 자동화 에이전트입니다.
 | 네이버, naver | `va-naver/SKILL.md` |
 | 카페, cafe, 카페 가입, 카페 글쓰기 | `va-naver-cafe-join/SKILL.md` 또는 `va-naver-cafe-write/SKILL.md` |
 | 인스타, instagram, 좋아요, 댓글, 팔로우 | `va-insta/SKILL.md` |
+| 쓰레드, threads | `va-threads/SKILL.md` |
 | 블로그 써줘 (플랫폼 미지정) | 사용자에게 플랫폼 질문 |
 | 블로거 역할 | `persona-blogger/SKILL.md` |
 | 인플루언서 관리 | `persona-influencer-manager/SKILL.md` |
@@ -64,7 +67,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 개요 + 레이트리밋 |
@@ -75,6 +78,8 @@ SKILLS_DIR: <viruagent-cli 설치 경로>/skills/
 | va-insta-follow | `va-insta-follow/SKILL.md` | 팔로우/언팔 |
 | va-insta-dm | `va-insta-dm/SKILL.md` | DM |
 | va-insta-feed | `va-insta-feed/SKILL.md` | 피드/프로필/분석 |
+| va-threads | `va-threads/SKILL.md` | Threads 개요 + 레이트리밋 |
+| va-threads-publish | `va-threads-publish/SKILL.md` | Threads 글쓰기 |
 
 ### 페르소나 스킬
 

package/skills/va-threads/SKILL.md

@@ -0,0 +1,67 @@
+---
+name: va-threads
+version: 1.0.0
+description: "Threads 자동화: 명령 개요 및 레이트리밋 규칙"
+metadata:
+  category: "overview"
+  provider: "threads"
+  requires:
+    bins: ["viruagent-cli"]
+---
+
+# va-threads — Threads 자동화 개요
+
+Threads 자동화를 위한 viruagent-cli 가이드. 항상 `--provider threads` 사용.
+
+## 명령 목록
+
+| 명령 | 스킬 | 설명 |
+|------|------|------|
+| login | va-threads | 로그인 (Instagram 계정) |
+| publish | va-threads-publish | 글쓰기 (텍스트/이미지) |
+| like | va-threads | 좋아요 |
+| comment | va-threads | 답글 |
+| follow | va-threads | 팔로우 |
+| search | va-threads | 검색 |
+| get-profile | va-threads | 프로필 조회 |
+| get-feed | va-threads | 피드 조회 |
+
+## Rate Limit Safety (신규 계정 기준)
+
+| 액션 | 딜레이 | 시간당 | 일일 |
+|------|--------|--------|------|
+| Post | 2~5min | 5 | 25 |
+| Like | 20~40s | 15 | 500 |
+| Reply | 5~7min | 5 | 100 |
+| Follow | 1~2min | 15 | 250 |
+
+모든 딜레이는 랜덤화되어 자동 적용. 카운터는 세션별 userId로 영속화.
+
+## 레이트리밋 확인
+
+```bash
+npx viruagent-cli rate-limit-status --provider threads
+```
+
+대량 작업 전 반드시 확인.
+
+## 중요 사항
+
+- Instagram 계정을 공유하므로 Instagram rate limit에 영향을 줄 수 있음
+- Barcelona User-Agent + Bloks API 사용
+- IGT:2 토큰이 주요 인증 수단
+- 세션 + 카운터: `~/.viruagent-cli/sessions/threads-session.json`
+
+## 환경변수
+
+```
+THREADS_USERNAME=
+THREADS_PASSWORD=
+# 또는
+INSTA_USERNAME=
+INSTA_PASSWORD=
+```
+
+## See Also
+
+va-shared, va-threads-publish

package/skills/va-threads-publish/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: va-threads-publish
+version: 1.0.0
+description: "Threads 글쓰기: 텍스트/이미지 포스팅"
+metadata:
+  category: "publish"
+  provider: "threads"
+  requires:
+    bins: ["viruagent-cli"]
+---
+
+# va-threads-publish — Threads 글쓰기
+
+Threads에 텍스트/이미지를 발행하는 가이드.
+
+## 명령어
+
+```bash
+# 텍스트만
+npx viruagent-cli publish --provider threads \
+  --content "<텍스트>"
+
+# 이미지 첨부
+npx viruagent-cli publish --provider threads \
+  --content "<텍스트>" \
+  --image-urls "<이미지URL>"
+```
+
+## 글쓰기 규칙 (Threads 최적화)
+
+### 분량
+- **최적 길이**: 100~300자 (짧고 임팩트 있게)
+- Threads는 짧은 텍스트 중심 — 블로그처럼 길게 쓰지 않음
+
+### 첫 줄이 전부다
+- **숫자**: "3가지만 알면 됩니다"
+- **반전**: "잘못 알고 있었습니다"
+- **질문**: "이거 해보셨나요?"
+- **공감**: "저만 이런 거 아니죠?"
+
+### 해시태그
+- Threads는 해시태그 효과가 Instagram보다 약함
+- 최대 5개, 본문 하단에 배치
+- 검색 기능이 제한적이므로 키워드를 본문에 자연스럽게 녹이기
+
+### 이미지
+- 이미지 1장 첨부 가능
+- `--image-urls`에 직접 URL 지정
+- 고해상도 (1080x1080 이상) 권장
+
+## 발행 예시
+
+```bash
+# 짧은 의견
+npx viruagent-cli publish --provider threads \
+  --content "AI가 코드 리뷰해주는 시대.
+
+그런데 아직도 혼자 다 보고 있다면
+도구를 바꿀 때입니다."
+
+# 이미지 포함
+npx viruagent-cli publish --provider threads \
+  --content "오늘의 작업 환경. 카페에서 코딩하는 게 제일 잘 됨." \
+  --image-urls "https://example.com/workspace.jpg"
+```
+
+## 주의사항
+
+- 글 최대 500자 (초과 시 잘림)
+- 발행 간격: 최소 2~5분 (rate limit)
+- 로그인 안 된 경우: `login --provider threads` 먼저 실행
+- Instagram 계정 공유이므로 Instagram challenge 발생 가능
+
+## See Also
+
+va-threads, va-shared

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>',
             };
           }
         }