viruagent-cli 0.6.0 → 0.6.2

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

@@ -1,7 +1,7 @@
 ---
 name: va-tistory-publish
-version: 1.0.0
-description: "Tistory: 블로그 글 발행 (HTML 콘텐츠 + 이미지)"
+version: 2.0.0
+description: "Tistory: 블로그 글 발행 — 5종 포맷 템플릿 (story/howto/list/review/qa)"
 metadata:
   category: "command"
   provider: "tistory"
@@ -17,13 +17,13 @@ metadata:
 ```bash
 npx viruagent-cli publish \
   --provider tistory \
-  --title "Post Title" \
+  --title "제목 (25~35자, 핵심 키워드 앞배치)" \
   --content "<h2>...</h2><p>...</p>" \
   --category <id> \
   --tags "tag1,tag2,tag3,tag4,tag5" \
   --visibility public \
-  --related-image-keywords "keyword1,keyword2" \
-  --image-upload-limit 2 \
+  --related-image-keywords "keyword1 keyword2 keyword3" \
+  --image-upload-limit 3 \
   --minimum-image-count 1
 ```
 
@@ -38,46 +38,392 @@ npx viruagent-cli publish \
 | `--tags` | 쉼표 구분 태그 (5개) | - |
 | `--visibility` | public / private | public |
 | `--related-image-keywords` | 이미지 검색 키워드 (영어) | - |
-| `--image-upload-limit` | 최대 이미지 수 | 1 |
+| `--image-upload-limit` | 최대 이미지 수 | 3 |
 | `--minimum-image-count` | 최소 이미지 수 | 1 |
 | `--dry-run` | 파라미터만 검증 | false |
 
-## HTML 템플릿
+---
+
+## 티스토리 SEO 핵심 원칙 (구글 기준)
+
+- **제목**: 25~35자, 핵심 키워드를 앞쪽에 배치. 숫자/연도 포함 시 CTR +23%
+- **글자 수**: 정보성 글 3,000~5,000자, 경쟁 키워드 5,000자 이상
+- **H태그 계층**: 블로그 타이틀이 h1 → 본문은 `h2` → `h3` → `h4` 순서. **본문에 h1 사용 금지**
+- **소제목 간격**: 600~1,000자(약 300~500단어)마다 h3 1개
+- **목차**: 3개 이상 섹션이면 앵커 링크 목차 삽입 (Featured Snippet 진입 확률 상승)
+- **이미지 alt 태그**: 반드시 `핵심키워드 + 설명` 형식으로 작성
+- **내부 링크**: 실제 발행된 URL이 제공된 경우에만 삽입. URL 없으면 섹션 전체 생략 (가짜 링크 절대 금지)
+- **E-E-A-T**: 직접 경험 기반 문장, 데이터/출처 인용, 작성자 관점 명시
+
+### Tistory HTML 규칙
+- `data-ke-*` 속성 사용 — Tistory 에디터가 자동 처리하므로 일반 HTML로 작성
+- 이미지 삽입 후 alt 속성 추가 필수
+- `<blockquote>` 사용 가능 (티스토리가 스타일 자동 적용)
+
+### 피해야 할 패턴
+- 본문에 `<h1>` 직접 사용 (블로그 타이틀과 중복)
+- `<h2>` 건너뛰고 `<h3>` 바로 사용
+- 균일한 3단락 공식 반복 — AI 탐지 위험
+- 이미지 alt 태그 비워두기 (이미지 SEO 가치 전체 손실)
+
+---
+
+## 서론 후킹 패턴 3종 (첫 3문장이 체류시간 결정)
+
+### 패턴 A — 공감형 (범용, 정보성 글)
+```html
+<p>[독자가 이미 겪고 있는 상황을 1문장으로 정확히 표현]</p>
+<p>그런데 사실 그 이유는 생각보다 단순합니다. [반전 핵심 한 줄]</p>
+<p>이 글에서는 [구체적 약속 — 읽으면 얻는 것]을 다룹니다.</p>
+```
+
+### 패턴 B — 손실 회피형 (경쟁 키워드, 클릭 유지)
+```html
+<blockquote>[모르면 손해인 핵심 한 줄. 구체적 수치 포함]</blockquote>
+<p>실제로 [통계나 사례 — 신뢰 부여]. 대부분은 이 차이를 모르고 넘어갑니다.</p>
+<p>지금부터 [해결책 예고]를 정리해 드립니다.</p>
+```
+
+### 패턴 C — 질문형 (전문성 어필, 심화 콘텐츠)
+```html
+<p>[독자가 검색창에 치는 질문을 그대로 첫 문장으로]</p>
+<p>[데이터나 통계로 문제의 크기를 보여줌]. 저도 처음엔 이 답을 찾는 데 [시간]이 걸렸습니다.</p>
+<p>지금부터 [핵심 내용 예고]합니다.</p>
+```
+
+---
+
+## 목차 블록 (3개 이상 섹션이면 항상 삽입)
+
+```html
+<h2>목차</h2>
+<ul>
+  <li><a href="#section1">[섹션 1 제목]</a></li>
+  <li><a href="#section2">[섹션 2 제목]</a></li>
+  <li><a href="#section3">[섹션 3 제목]</a></li>
+  <li><a href="#section4">[섹션 4 제목]</a></li>
+</ul>
+<p>&nbsp;</p>
+```
+
+---
+
+## 포맷 5종 템플릿
+
+글 성격에 맞는 포맷을 선택하세요. **기본 추천: story형** (체류시간 최고, AI 탐지 회피 최적).
+
+---
+
+### 1. story형 — 스토리텔링 (체류시간 최고, AI 탐지 낮음)
+경험 후기, 사례 공유, 인사이트 전달에 적합.
+
+```html
+<!-- 후킹: 패턴 A 또는 C -->
+<blockquote>[임팩트 한 줄 — 독자의 상황을 대변하는 문장]</blockquote>
+<p>&nbsp;</p>
+
+<p>[독자 공감 + 내 경험으로 연결 — 3~5문장. "저도 그랬습니다" 식으로 시작]</p>
+<p>[이 글에서 다룰 내용 예고 — 구체적으로]</p>
+<p>&nbsp;</p>
+
+<!-- 목차 삽입 -->
+<h2>목차</h2>
+<ul>
+  <li><a href="#s1">[섹션 1]</a></li>
+  <li><a href="#s2">[섹션 2]</a></li>
+  <li><a href="#s3">[섹션 3]</a></li>
+</ul>
+<p>&nbsp;</p>
+
+<h2 id="s1">[섹션 1 — 문제 상황 묘사]</h2>
+<h3>[세부 관점 1]</h3>
+<p>[직접 겪은 구체적 상황 — 날짜, 수치, 감정 포함. 3~5문장]</p>
+<p>[그 상황에서 발견한 인사이트 — 독자가 몰랐던 관점]</p>
+<p>&nbsp;</p>
+
+<h2 id="s2">[섹션 2 — 전환점 또는 발견]</h2>
+<h3>[세부 관점 1]</h3>
+<p>[문제를 어떻게 바라보게 됐는지 — BAB 구조의 After 단계]</p>
+<p>[구체적 수치나 결과 언급]</p>
+<p>&nbsp;</p>
+<h3>[세부 관점 2]</h3>
+<p>[추가 설명 — 짧은 문장. 긴 문장과 섞어서]</p>
+<p>&nbsp;</p>
+
+<h2 id="s3">[섹션 3 — 실전 적용법]</h2>
+<h3>[방법 1]</h3>
+<p>[독자가 바로 쓸 수 있는 방법 — 단계보다 맥락 중심으로]</p>
+<p>[예상 실패 포인트와 극복법 — 경험 기반으로]</p>
+<p>&nbsp;</p>
+<h3>[방법 2]</h3>
+<p>[동일 구조]</p>
+<p>&nbsp;</p>
+
+<h2>[섹션 4 — 의외의 발견 또는 여담]</h2>
+<p>[예상 못한 결과나 부가적 인사이트 — 이 섹션이 인간미를 만듦]</p>
+<p>&nbsp;</p>
+
+<!-- 내부 링크: 실제 발행된 URL만 사용. 모르면 섹션 전체 생략 -->
+
+<p>[핵심 요약 1~2문장] [독자에게 구체적 행동 제안] [공유/댓글 유도]</p>
+```
+
+---
+
+### 2. howto형 — 튜토리얼 (정보 쿼리 1위, 체류시간 높음)
+설치법, 사용법, 단계별 가이드에 적합.
+
+```html
+<!-- 후킹: 패턴 B -->
+<blockquote>[이 글 하나로 [X]할 수 있습니다 — 구체적 약속]</blockquote>
+<p>&nbsp;</p>
+
+<p>[왜 이 방법이 필요한지 — 기존 방식의 문제점. 2~3문장]</p>
+<p>[이 글을 끝까지 읽으면 얻는 것]</p>
+<p>&nbsp;</p>
+
+<!-- 목차 -->
+<h2>목차</h2>
+<ul>
+  <li><a href="#prep">준비물</a></li>
+  <li><a href="#step1">1단계 — [단계명]</a></li>
+  <li><a href="#step2">2단계 — [단계명]</a></li>
+  <li><a href="#step3">3단계 — [단계명]</a></li>
+  <li><a href="#faq">자주 묻는 질문</a></li>
+</ul>
+<p>&nbsp;</p>
+
+<h2 id="prep">시작 전 준비물</h2>
+<p>[왜 필요한지 이유 포함]</p>
+<ul>
+  <li>[준비물 1] — [이유]</li>
+  <li>[준비물 2] — [이유]</li>
+</ul>
+<p>&nbsp;</p>
+
+<h2 id="step1">1단계 — [단계명]</h2>
+<h3>무엇을 하는 단계인가</h3>
+<p>[맥락 제공 — 왜 이 단계가 필요한지]</p>
+<h3>실행 방법</h3>
+<p>[구체적 방법 — 이미지 직후 텍스트 설명]</p>
+<p>[이 단계에서 흔히 하는 실수와 예방법]</p>
+<p>&nbsp;</p>
+
+<h2 id="step2">2단계 — [단계명]</h2>
+<h3>무엇을 하는 단계인가</h3>
+<p>[맥락 제공]</p>
+<h3>실행 방법</h3>
+<p>[방법 + 주의사항]</p>
+<p>&nbsp;</p>
+
+<h2 id="step3">3단계 — [단계명]</h2>
+<p>[동일 구조]</p>
+<p>&nbsp;</p>
+
+<h2 id="faq">자주 묻는 질문</h2>
+<h3>[가장 흔한 질문]</h3>
+<p>[구체적 답변]</p>
+<h3>[두 번째 질문]</h3>
+<p>[구체적 답변]</p>
+<p>&nbsp;</p>
+
+<!-- 내부 링크: 실제 발행된 URL만 사용. 모르면 섹션 전체 생략 -->
+
+<p>[완료 축하 + 다음 단계 제안]</p>
+```
+
+---
+
+### 3. list형 — 리스트 정리 (CTR 높음, 초기 트래픽 확보)
+"베스트 N", "추천 N선", 비교 정리글에 적합.
+
+```html
+<!-- 후킹: 패턴 B -->
+<blockquote>[N가지 중 실제로 쓸 만한 건 [X]개입니다 — 기대 역전]</blockquote>
+<p>&nbsp;</p>
+
+<p>[선별 기준 명시 — "제가 직접 [기간] 동안 사용/테스트한 기준"]</p>
+<p>[이 글에서 다루는 범위]</p>
+<p>&nbsp;</p>
+
+<!-- 목차 -->
+<h2>목차</h2>
+<ul>
+  <li><a href="#item1">1. [항목명]</a></li>
+  <li><a href="#item2">2. [항목명]</a></li>
+  <li><a href="#compare">한눈에 비교</a></li>
+  <li><a href="#conclusion">상황별 추천</a></li>
+</ul>
+<p>&nbsp;</p>
+
+<h2 id="item1">1. [항목명] — [핵심 특징 한 줄]</h2>
+<h3>왜 1위인가</h3>
+<p>[단순 설명이 아닌 직접 경험 기반 이유]</p>
+<h3>장단점</h3>
+<p>[장점 — 구체적 수치나 사례]</p>
+<p>[단점 솔직하게 1~2줄 — 없으면 신뢰도 하락]</p>
+<p>&nbsp;</p>
+
+<h2 id="item2">2. [항목명] — [핵심 특징 한 줄]</h2>
+<h3>특징과 실사용 경험</h3>
+<p>[앞 항목과 차별점 명시]</p>
+<p>&nbsp;</p>
+
+<!-- 3~N개 동일 패턴 -->
+
+<h2 id="compare">한눈에 비교</h2>
+<p>[표 또는 항목별 비교 요약]</p>
+<p>&nbsp;</p>
+
+<h2 id="conclusion">결론 — 상황별 추천</h2>
+<h3>[상황 A]에는 [항목 X]</h3>
+<p>[이유]</p>
+<h3>[상황 B]에는 [항목 Y]</h3>
+<p>[이유]</p>
+<p>&nbsp;</p>
+
+<!-- 내부 링크: 실제 발행된 URL만 사용. 모르면 섹션 전체 생략 -->
+
+<p>[내 개인 픽 + 이유] [댓글 유도 — "여러분이 써본 것 중 좋았던 건?"]</p>
+```
+
+---
+
+### 4. review형 — 분석/리뷰 (전문성 최고, AI 탐지 낮음)
+도구 분석, 서비스 리뷰, 책/영상 리뷰에 적합.
+
+```html
+<!-- 후킹: 패턴 C -->
+<blockquote>결론부터 말하면: [한 줄 평가 — 긍정/부정 명확하게]</blockquote>
+<p>&nbsp;</p>
+
+<p>[어떤 계기로 사용/분석하게 됐는지 — 배경 스토리. 2~3문장]</p>
+<p>[리뷰 관점/기준 명시 — "저는 [직군/상황]의 입장에서 평가했습니다"]</p>
+<p>&nbsp;</p>
+
+<!-- 목차 -->
+<h2>목차</h2>
+<ul>
+  <li><a href="#summary">한줄 요약</a></li>
+  <li><a href="#feature1">[분석 1]</a></li>
+  <li><a href="#feature2">[분석 2]</a></li>
+  <li><a href="#vs">경쟁 제품과 비교</a></li>
+  <li><a href="#recommend">이런 분께 추천</a></li>
+</ul>
+<p>&nbsp;</p>
+
+<h2 id="summary">한줄 요약</h2>
+<p>[장점 2~3가지 + 단점 1~2가지 솔직하게]</p>
+<p>&nbsp;</p>
+
+<h2 id="feature1">[분석 섹션 1 — 가장 중요한 특징]</h2>
+<h3>[세부 항목 1]</h3>
+<p>[특징 설명 → 실제 사용 경험 → 내 평가 순서]</p>
+<p>[수치나 비교 대상 포함]</p>
+<h3>[세부 항목 2]</h3>
+<p>[동일 구조]</p>
+<p>&nbsp;</p>
+
+<h2 id="feature2">[분석 섹션 2]</h2>
+<p>[동일 구조]</p>
+<p>&nbsp;</p>
+
+<h2 id="vs">경쟁 제품/서비스와 비교</h2>
+<h3>[어떤 상황에서 이게 나은가]</h3>
+<p>[이유]</p>
+<h3>[어떤 상황에서 다른 게 나은가]</h3>
+<p>[솔직하게]</p>
+<p>&nbsp;</p>
+
+<h2 id="recommend">이런 분께 추천합니다</h2>
+<h3>추천하는 경우</h3>
+<p>[타겟 명확히]</p>
+<h3>추천하지 않는 경우</h3>
+<p>[맞지 않는 상황도 언급 — 신뢰도 상승]</p>
+<p>&nbsp;</p>
+
+<!-- 내부 링크: 실제 발행된 URL만 사용. 모르면 섹션 전체 생략 -->
+
+<p>[최종 점수나 별점 + 총평 1~2문장]</p>
+```
+
+---
+
+### 5. qa형 — Q&A (Featured Snippet 최적, 롱테일 키워드)
+개념 설명, FAQ, "~가 뭔가요?" 쿼리에 적합.
 
 ```html
-<!-- 1. Hook -->
-<blockquote data-ke-style="style2">[한 문장 임팩트]</blockquote>
-<p data-ke-size="size16">&nbsp;</p>
-
-<!-- 2. 서론 (2~3단락) -->
-<p data-ke-size="size18">[맥락과 공감, 3~5문장]</p>
-<p data-ke-size="size18">[이 글에서 다룰 내용]</p>
-<p data-ke-size="size16">&nbsp;</p>
-
-<!-- 3. 본문 (3~4 섹션) -->
-<h2>[섹션 제목]</h2>
-<p data-ke-size="size18">[3~5문장, 근거 포함]</p>
-<p data-ke-size="size18">[분석과 시사점]</p>
-<p data-ke-size="size16">&nbsp;</p>
-
-<!-- 4. 핵심 정리 -->
-<h2>핵심 정리</h2>
+<!-- 후킹: 패턴 C -->
+<p>[가장 많이 검색되는 질문을 첫 문장으로 — 검색창 그대로]</p>
+<p>[이 질문이 중요한 이유 + 이 글에서 다룰 범위]</p>
+<p>&nbsp;</p>
+
+<!-- 목차 -->
+<h2>목차</h2>
 <ul>
-  <li>[핵심 1]</li>
-  <li>[핵심 2]</li>
-  <li>[핵심 3]</li>
+  <li><a href="#q1">[질문 1]</a></li>
+  <li><a href="#q2">[질문 2]</a></li>
+  <li><a href="#q3">[질문 3]</a></li>
+  <li><a href="#q4">[질문 4 — 심화]</a></li>
+  <li><a href="#summary">핵심 정리</a></li>
 </ul>
-<p data-ke-size="size16">&nbsp;</p>
+<p>&nbsp;</p>
 
-<!-- 5. 마무리 -->
-<p data-ke-size="size18">[구체적 실행 제안]</p>
+<h2 id="q1">[핵심 질문 1]</h2>
+<p>[직접 답변 — 첫 문장에 핵심 답 먼저. 구글 스니펫 추출 고려]</p>
+<h3>더 자세히</h3>
+<p>[부연 설명 — 왜 그런지, 어떤 경우에 해당하는지]</p>
+<p>[실제 사례나 예시]</p>
+<p>&nbsp;</p>
+
+<h2 id="q2">[핵심 질문 2]</h2>
+<p>[답 먼저, 설명 나중]</p>
+<h3>예시</h3>
+<p>[구체적 예시]</p>
+<p>&nbsp;</p>
+
+<h2 id="q3">[핵심 질문 3]</h2>
+<p>[동일 구조]</p>
+<p>&nbsp;</p>
+
+<h2 id="q4">[심화 질문 — 독자가 생각 못 했던 질문]</h2>
+<p>[이 섹션이 전문성 어필 포인트]</p>
+<p>&nbsp;</p>
+
+<h2 id="summary">핵심 정리</h2>
+<ul>
+  <li>[Q1 핵심 답 — 한 줄]</li>
+  <li>[Q2 핵심 답 — 한 줄]</li>
+  <li>[Q3 핵심 답 — 한 줄]</li>
+  <li>[Q4 핵심 답 — 한 줄]</li>
+</ul>
+<p>&nbsp;</p>
+
+<!-- 내부 링크: 실제 발행된 URL만 사용. 모르면 섹션 전체 생략 -->
+
+<p>[추가 궁금한 점은 댓글로 — 독자 참여 유도]</p>
 ```
 
+---
+
+## 포맷 선택 가이드
+
+| 글 주제 | 추천 포맷 |
+|---------|---------|
+| 도구/서비스 소개, 경험 공유 | **story** |
+| 설치법, 사용법, 단계별 방법 | **howto** |
+| 추천 목록, 비교 정리 | **list** |
+| 심층 분석, 솔직 리뷰 | **review** |
+| 개념 설명, 자주 묻는 질문 | **qa** |
+
+---
+
 ## 이미지 규칙
 
-- `--related-image-keywords`에 영어 키워드 2~3개 항상 포함
-- `--image-upload-limit 2`, `--minimum-image-count 1` 설정
-- `--no-auto-upload-images`는 사용자 명시 요청 시만
+- `--related-image-keywords`에 영어 키워드 2~3개
+- `--image-upload-limit 3`, `--minimum-image-count 1` 기본값
+- 이미지는 설명 단락 **위**에 배치 — "시각 → 텍스트" 순서
+- 이미지 alt 태그: `핵심키워드 + 설명` 형식 필수
 
 ## 발행 후 검증
 

package/src/providers/chromeManager.js

@@ -0,0 +1,186 @@
+const { exec } = require('child_process');
+const http = require('http');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { chromium } = require('playwright');
+
+const CHROME_PROFILE_DIR = path.join(os.homedir(), '.viruagent-cli', 'chrome-profile');
+const CDP_PORT = 9224;
+
+// openchrome uses port 9222 and keeps an always-on Chrome with existing sessions.
+// If installed, login requires no 2FA and reuses your browser's saved accounts.
+// Install: npx openchrome-mcp setup
+const OPENCHROME_PORT = 9222;
+const OPENCHROME_PROFILE = path.join(os.homedir(), '.openchrome', 'profile');
+
+const CHROME_PATHS = [
+  '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+  '/Applications/Chromium.app/Contents/MacOS/Chromium',
+  '/usr/bin/google-chrome',
+  '/usr/bin/google-chrome-stable',
+  '/usr/bin/chromium-browser',
+];
+
+function findChrome() {
+  for (const p of CHROME_PATHS) {
+    if (fs.existsSync(p)) return p;
+  }
+  throw new Error('Google Chrome not found. Please install Chrome and try again.');
+}
+
+function isCDPAvailable(port) {
+  return new Promise((resolve) => {
+    const req = http.get(`http://localhost:${port}/json/version`, (res) => {
+      resolve(res.statusCode === 200);
+    });
+    req.on('error', () => resolve(false));
+    req.setTimeout(1500, () => { req.destroy(); resolve(false); });
+  });
+}
+
+function isOpenChromeInstalled() {
+  return fs.existsSync(OPENCHROME_PROFILE);
+}
+
+/**
+ * Resolve the best available Chrome CDP port.
+ *
+ * Priority:
+ *   1. openchrome (port 9222) — already running with saved sessions, no 2FA needed.
+ *   2. openchrome installed → start it via `npx openchrome-mcp serve`.
+ *   3. Fallback: launch our own Chrome with a dedicated profile (first-time login requires 2FA).
+ *
+ * TIP: Install openchrome for a seamless login experience (no 2FA, sessions persist).
+ *      → npx openchrome-mcp setup
+ */
+async function resolveChromeCDP(ownProfileDir = CHROME_PROFILE_DIR) {
+  // 1. openchrome already running
+  if (await isCDPAvailable(OPENCHROME_PORT)) {
+    return { port: OPENCHROME_PORT, source: 'openchrome' };
+  }
+
+  // 2. openchrome installed but Chrome not running → launch Chrome with openchrome profile
+  if (isOpenChromeInstalled()) {
+    console.error('[viruagent] Launching Chrome with openchrome profile...');
+    const chrome = findChrome();
+    // Use same flags as openchrome to ensure stability
+    const child = exec(`"${chrome}" \
+      --remote-debugging-port=${OPENCHROME_PORT} \
+      --user-data-dir="${OPENCHROME_PROFILE}" \
+      --no-first-run \
+      --no-default-browser-check \
+      --no-restore-last-session \
+      --start-maximized \
+      --disable-backgrounding-occluded-windows \
+      --disable-blink-features=AutomationControlled \
+      --disable-background-networking \
+      --disable-sync \
+      --disable-translate \
+      about:blank`);
+    child.unref();
+    for (let i = 0; i < 20; i++) {
+      await new Promise((r) => setTimeout(r, 500));
+      if (await isCDPAvailable(OPENCHROME_PORT)) {
+        console.error('[viruagent] openchrome Chrome ready.');
+        return { port: OPENCHROME_PORT, source: 'openchrome' };
+      }
+    }
+    // failed — fall through to own Chrome
+  }
+
+  // 3. Fallback: our own Chrome with dedicated profile
+  // Kill any stale Chrome on CDP_PORT first to ensure correct profile is used
+  const chrome = findChrome();
+  fs.mkdirSync(ownProfileDir, { recursive: true });
+
+  exec(`"${chrome}" \
+    --remote-debugging-port=${CDP_PORT} \
+    --user-data-dir="${ownProfileDir}" \
+    --no-first-run \
+    --no-default-browser-check \
+    --disable-sync \
+    --disable-background-networking`);
+
+  for (let i = 0; i < 20; i++) {
+    await new Promise((r) => setTimeout(r, 500));
+    if (await isCDPAvailable(CDP_PORT)) {
+      return { port: CDP_PORT, source: 'own' };
+    }
+  }
+
+  throw new Error('Chrome failed to start. Please check your Chrome installation.');
+}
+
+async function launchChrome(ownProfileDir = CHROME_PROFILE_DIR) {
+  const { port, source } = await resolveChromeCDP(ownProfileDir);
+
+  if (source === 'own') {
+    console.error(
+      '\n[TIP] Install openchrome for seamless logins (no 2FA, sessions always persist):\n' +
+      '       npx openchrome-mcp setup\n'
+    );
+  }
+
+  return port;
+}
+
+async function connectChrome(port) {
+  // Retry a few times — Chrome may need a moment after launch before contexts are ready
+  for (let attempt = 0; attempt < 5; attempt++) {
+    try {
+      const browser = await chromium.connectOverCDP(`http://localhost:${port}`);
+      const context = browser.contexts()[0];
+      if (!context) {
+        await browser.close().catch(() => {});
+        await new Promise((r) => setTimeout(r, 1000));
+        continue;
+      }
+      const page = context.pages()[0] || (await context.newPage());
+      return { browser, context, page };
+    } catch {
+      await new Promise((r) => setTimeout(r, 1000));
+    }
+  }
+  throw new Error('Failed to connect to Chrome. Please try again.');
+}
+
+/**
+ * Extract ALL cookies including httpOnly via CDP Network.getAllCookies.
+ * Unlike context.cookies(), this bypasses the JS sandbox restriction.
+ */
+async function extractAllCookies(context, page) {
+  const cdp = await context.newCDPSession(page);
+  const { cookies } = await cdp.send('Network.getAllCookies');
+  return cookies;
+}
+
+function filterCookies(cookies, domains) {
+  return cookies.filter((c) => domains.some((d) => c.domain.includes(d)));
+}
+
+function cookiesToSessionFormat(cookies) {
+  return cookies.map((c) => ({
+    name: c.name,
+    value: c.value,
+    domain: c.domain,
+    path: c.path || '/',
+    expires: typeof c.expires === 'number' ? c.expires : -1,
+    httpOnly: c.httpOnly || false,
+    secure: c.secure || false,
+    sameSite: c.sameSite || 'Lax',
+  }));
+}
+
+module.exports = {
+  CHROME_PROFILE_DIR,
+  CDP_PORT,
+  OPENCHROME_PORT,
+  launchChrome,
+  connectChrome,
+  isCDPAvailable,
+  isOpenChromeInstalled,
+  extractAllCookies,
+  filterCookies,
+  cookiesToSessionFormat,
+};

package/src/providers/insta/index.js

@@ -5,12 +5,12 @@ const { readInstaCredentials } = require('./utils');
 const { createInstaWithProviderSession } = require('./session');
 const { createAskForAuthentication } = require('./auth');
 
-const createInstaProvider = ({ sessionPath }) => {
+const createInstaProvider = ({ sessionPath, account }) => {
   const instaApi = createInstaApiClient({ sessionPath });
 
   const askForAuthentication = createAskForAuthentication({ sessionPath });
 
-  const withProviderSession = createInstaWithProviderSession(askForAuthentication);
+  const withProviderSession = createInstaWithProviderSession(askForAuthentication, account);
   const smart = createSmartComment(instaApi);
 
   return {
@@ -29,7 +29,7 @@ const createInstaProvider = ({ sessionPath }) => {
             userId,
             hasSession: Boolean(sessionid?.value),
             sessionPath,
-            metadata: getProviderMeta('insta') || {},
+            metadata: getProviderMeta('insta', account) || {},
           };
         } catch (error) {
           return {
@@ -37,7 +37,7 @@ const createInstaProvider = ({ sessionPath }) => {
             loggedIn: false,
             sessionPath,
             error: error.message,
-            metadata: getProviderMeta('insta') || {},
+            metadata: getProviderMeta('insta', account) || {},
           };
         }
       });
@@ -65,7 +65,7 @@ const createInstaProvider = ({ sessionPath }) => {
         userId: result.userId,
         username: result.username,
         sessionPath: result.sessionPath,
-      });
+      }, account);
 
       return result;
     },
@@ -509,7 +509,7 @@ const createInstaProvider = ({ sessionPath }) => {
     },
 
     async logout() {
-      clearProviderMeta('insta');
+      clearProviderMeta('insta', account);
       return {
         provider: 'insta',
         loggedOut: true,