viruagent-cli 0.4.0 → 0.4.2

package/README.ko.md

@@ -26,9 +26,9 @@
 
 | 플랫폼 | 로그인 | 주요 기능 | 가이드 |
 |--------|--------|----------|--------|
-| **Tistory** | Playwright (카카오) | 글 발행, 임시저장, 카테고리, 이미지 업로드 | [가이드](docs/guide-tistory.md) |
-| **Naver Blog** | Playwright (네이버) | 글 발행, 카테고리, SE Editor, 이미지 업로드 | [가이드](docs/guide-naver.md) |
-| **Instagram** | HTTP (브라우저 불필요) | 좋아요, 댓글, 팔로우, 포스팅, 프로필, 피드 | [가이드](docs/guide-instagram.md) |
+| **Tistory** | Playwright (카카오) | 글 발행, 임시저장, 카테고리, 이미지 업로드 | [가이드](docs/ko/guide-tistory.md) |
+| **Naver Blog** | Playwright (네이버) | 글 발행, 카테고리, SE Editor, 이미지 업로드 | [가이드](docs/ko/guide-naver.md) |
+| **Instagram** | HTTP (브라우저 불필요) | 좋아요, 댓글, 팔로우, 포스팅, 프로필, 피드 | [가이드](docs/ko/guide-instagram.md) |
 
 ## 동작 방식
 
@@ -93,7 +93,7 @@ npx viruagent-cli login --provider insta --username <인스타 ID> --password <
 ```
 > "인스타 로그인해줘" — 에이전트가 알아서 처리
 >
-> 전체 API 레퍼런스와 rate limit 규칙은 [Instagram 가이드](docs/guide-instagram.md)를 참고하세요.
+> 전체 API 레퍼런스와 rate limit 규칙은 [Instagram 가이드](docs/ko/guide-instagram.md)를 참고하세요.
 
 ## 사용법
 
@@ -110,9 +110,9 @@ npx viruagent-cli login --provider insta --username <인스타 ID> --password <
 
 ## 플랫폼별 가이드
 
-- **[Tistory 가이드](docs/guide-tistory.md)** — 블로그 발행, 이미지 업로드, 카테고리
-- **[Naver Blog 가이드](docs/guide-naver.md)** — SE Editor, 블로그 발행, 이미지 업로드
-- **[Instagram 가이드](docs/guide-instagram.md)** — 18개 API 메서드, rate limit 규칙, AI 댓글
+- **[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 댓글
 
 ## 지원 환경
 

package/README.md

@@ -26,9 +26,9 @@ Designed not for humans, but for **AI agents**.
 
 | Platform | Login | Features | Guide |
 |----------|-------|----------|-------|
-| **Tistory** | Playwright (Kakao) | Publish, Draft, Categories, Image Upload | [Guide](docs/guide-tistory.md) |
-| **Naver Blog** | Playwright (Naver) | Publish, Categories, SE Editor, Image Upload | [Guide](docs/guide-naver.md) |
-| **Instagram** | HTTP (No Browser) | Like, Comment, Follow, Post, Profile, Feed, Rate Limit | [Guide](docs/guide-instagram.md) |
+| **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) |
 
 ## How It Works
 
@@ -93,7 +93,7 @@ npx viruagent-cli login --provider insta --username <id> --password <pw>
 ```
 > "Login to Instagram" — Agent handles it automatically
 >
-> See the [Instagram Guide](docs/guide-instagram.md) for full API reference and rate limit rules.
+> See the [Instagram Guide](docs/en/guide-instagram.md) for full API reference and rate limit rules.
 
 ## Usage
 
@@ -110,9 +110,9 @@ npx viruagent-cli login --provider insta --username <id> --password <pw>
 
 ## Platform Guides
 
-- **[Tistory Guide](docs/guide-tistory.en.md)** — Blog publishing, image upload, categories
-- **[Naver Blog Guide](docs/guide-naver.en.md)** — SE Editor, blog publishing, image upload
-- **[Instagram Guide](docs/guide-instagram.en.md)** — 18 API methods, rate limits, AI commenting
+- **[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
 
 ## Supported Environments
 

package/bin/index.js

@@ -212,6 +212,12 @@ analyzePostCmd
   .option('--post-id <shortcode>', 'Post shortcode')
   .action((opts) => execute('analyze-post', opts));
 
+const resolveChallengeCmd = program
+  .command('resolve-challenge')
+  .description('Resolve Instagram challenge (auto-verify identity)');
+addProviderOption(resolveChallengeCmd);
+resolveChallengeCmd.action((opts) => execute('resolve-challenge', opts));
+
 const rateLimitCmd = program
   .command('rate-limit-status')
   .description('Show current rate limit usage');

package/package.json

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

package/src/providers/insta/apiClient.js

@@ -174,9 +174,36 @@ const createInstaApiClient = ({ sessionPath }) => {
       if (location.includes('/accounts/login')) {
         throw new Error('세션이 만료되었습니다. 다시 로그인해 주세요.');
       }
+      if (location.includes('/challenge')) {
+        // challenge 자동 해결 시도
+        const resolved = await resolveChallenge();
+        if (resolved) {
+          // 해결 후 원래 요청 재시도
+          return fetch(url, { ...options, headers, redirect: 'manual' });
+        }
+        throw new Error('challenge_required: 본인 인증이 필요합니다. 브라우저에서 수동으로 처리해 주세요.');
+      }
       throw new Error(`리다이렉트 발생: ${res.status} → ${location}`);
     }
 
+    // challenge_required JSON 응답 처리
+    if (res.status === 400 && !options.allowError) {
+      const cloned = res.clone();
+      try {
+        const data = await cloned.json();
+        if (data.message === 'challenge_required') {
+          const resolved = await resolveChallenge();
+          if (resolved) {
+            return fetch(url, { ...options, headers, redirect: 'manual' });
+          }
+          throw new Error('challenge_required: 본인 인증이 필요합니다.');
+        }
+      } catch (e) {
+        if (e.message.includes('challenge_required')) throw e;
+        // JSON 파싱 실패는 무시하고 원래 흐름
+      }
+    }
+
     if (res.status === 401 || res.status === 403) {
       throw new Error(`인증 오류 (${res.status}). 다시 로그인해 주세요.`);
     }
@@ -316,6 +343,35 @@ const createInstaApiClient = ({ sessionPath }) => {
     };
   };
 
+  // ── Challenge 자동 해결 ──
+
+  const resolveChallenge = async () => {
+    try {
+      const cookies = getCookies();
+      const res = await fetch('https://www.instagram.com/api/v1/challenge/web/action/', {
+        method: 'POST',
+        headers: {
+          'User-Agent': USER_AGENT,
+          'X-IG-App-ID': IG_APP_ID,
+          'X-CSRFToken': getCsrfToken(),
+          'X-Requested-With': 'XMLHttpRequest',
+          'X-Instagram-AJAX': '1',
+          Referer: 'https://www.instagram.com/challenge/',
+          Origin: 'https://www.instagram.com',
+          'Content-Type': 'application/x-www-form-urlencoded',
+          Cookie: cookiesToHeader(cookies),
+        },
+        body: 'choice=0',
+        redirect: 'manual',
+      });
+      if (!res.ok) return false;
+      const data = await res.json();
+      return data.status === 'ok';
+    } catch {
+      return false;
+    }
+  };
+
   const parseLikeResponse = async (res) => {
     if (res.ok) return res.json();
     if (res.status === 400) {
@@ -611,6 +667,7 @@ const createInstaApiClient = ({ sessionPath }) => {
     configurePost,
     publishPost,
     deletePost,
+    resolveChallenge,
     resetState,
     getRateLimitStatus: () => {
       const status = {};

package/src/providers/insta/auth.js

@@ -99,10 +99,61 @@ const createAskForAuthentication = ({ sessionPath }) => async ({
 
   const loginData = await loginRes.json();
 
-  if (loginData.checkpoint_url) {
-    throw new Error(
-      '2단계 인증(checkpoint)이 필요합니다. 브라우저에서 먼저 인증을 완료해 주세요.',
-    );
+  if (loginData.checkpoint_url || loginData.message === 'challenge_required') {
+    // challenge 자동 해결 시도 (choice=0 = 본인입니다)
+    const challengeRes = await fetch('https://www.instagram.com/api/v1/challenge/web/action/', {
+      method: 'POST',
+      headers: {
+        'User-Agent': USER_AGENT,
+        'X-CSRFToken': csrfToken,
+        'X-Requested-With': 'XMLHttpRequest',
+        'X-Instagram-AJAX': '1',
+        'X-IG-App-ID': IG_APP_ID,
+        Referer: 'https://www.instagram.com/challenge/',
+        Origin: 'https://www.instagram.com',
+        'Content-Type': 'application/x-www-form-urlencoded',
+        Cookie: cookieHeader,
+      },
+      body: 'choice=0',
+      redirect: 'manual',
+    });
+    const challengeData = await challengeRes.json().catch(() => ({}));
+    if (challengeData.status !== 'ok') {
+      throw new Error(
+        'challenge_required: 자동 해결 실패. 브라우저에서 본인 인증을 완료해 주세요. ' +
+        (loginData.checkpoint_url || ''),
+      );
+    }
+    // challenge 해결 후 재로그인
+    const retryRes = await fetch('https://www.instagram.com/api/v1/web/accounts/login/ajax/', {
+      method: 'POST',
+      headers: {
+        'User-Agent': USER_AGENT,
+        'X-CSRFToken': csrfToken,
+        'X-Requested-With': 'XMLHttpRequest',
+        'X-IG-App-ID': IG_APP_ID,
+        'Content-Type': 'application/x-www-form-urlencoded',
+        Referer: 'https://www.instagram.com/accounts/login/',
+        Origin: 'https://www.instagram.com',
+        Cookie: cookieHeader,
+      },
+      body: body.toString(),
+      redirect: 'manual',
+    });
+    const retryCookies = parseCookiesFromHeaders(retryRes.headers);
+    cookies = mergeCookies(cookies, retryCookies);
+    const retryData = await retryRes.json().catch(() => ({}));
+    if (retryData.authenticated) {
+      saveInstaSession(sessionPath, cookies);
+      return {
+        provider: 'insta',
+        loggedIn: true,
+        userId: retryData.userId || null,
+        username: resolvedUsername,
+        sessionPath,
+        challengeResolved: true,
+      };
+    }
   }
 
   if (loginData.two_factor_required) {

package/src/providers/insta/index.js

@@ -271,6 +271,16 @@ const createInstaProvider = ({ sessionPath }) => {
       });
     },
 
+    async resolveChallenge() {
+      const resolved = await instaApi.resolveChallenge();
+      return {
+        provider: 'insta',
+        mode: 'resolveChallenge',
+        resolved,
+        message: resolved ? 'Challenge 해결 완료' : 'Challenge 해결 실패. 브라우저에서 수동으로 처리해 주세요.',
+      };
+    },
+
     rateLimitStatus() {
       return {
         provider: 'insta',

package/src/runner.js

@@ -237,6 +237,9 @@ const runCommand = async (command, opts = {}) => {
       }
       return withProvider(() => provider.analyzePost({ postId: opts.postId }))();
 
+    case 'resolve-challenge':
+      return withProvider(() => provider.resolveChallenge())();
+
     case 'rate-limit-status':
       return withProvider(() => Promise.resolve(provider.rateLimitStatus()))();