> ## Documentation Index
> Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 2026년 4월 릴리스 노트

> 2026년 4월 Octoparse 통합 기능의 업데이트와 개선 사항을 확인하세요.

<Update label="v0.1.28" description="CLI 업데이트" tags={["CLI"]}>
  ## 작업 그룹 및 확장된 작업 관리

  * **작업 그룹** — 이제 CLI 워크플로에서 작업을 그룹화하고 그룹 내 작업을 검토하는 등 작업 그룹 관리를 지원합니다.
  * **확장된 작업 관리** — 작업 워크플로가 목록 조회, 검사, 검증 및 실행을 넘어 확장되었습니다.

  ## 템플릿 관리

  * **템플릿 검색 및 관리** — CLI에서 템플릿을 조회하고 검색하며 템플릿 작업을 생성하고 수정할 수 있습니다.
  * 이 워크플로는 “템플릿 작업” 또는 “템플릿에서 생성된 작업”으로 표현해야 하며 임의의 사용자 지정 워크플로 생성으로 취급하지 마세요.

  ## 클라우드 예약

  * **클라우드 예약** — 일일 모니터링 또는 주간 보고서 같은 반복 추출을 위해 작업의 클라우드 예약을 설정할 수 있습니다.

  ## 더 안전해진 고위험 명령어

  * **강화된 확인** — 우발적인 삭제 또는 상태 변경 작업을 줄이기 위해 고위험 명령어에 더 엄격한 확인이 필요합니다.

  ## 데이터 미리보기 및 내보내기 가시성

  * **데이터 가시성** — 이제 데이터 명령어에서 레코드 수, 미리보기, 내보내지 않은 데이터 및 내보내기 워크플로를 지원합니다.

  ## 감지기 안정성 개선

  * **감지기 안정성** — v0.1.28에서 감지기 워크플로의 안정성이 향상되었습니다. 복잡한 페이지, 로그인 흐름 또는 특이한 레이아웃은 여전히 감지 후 검토가 필요할 수 있습니다.

  <Note>
    작업 그룹, 템플릿 작업 관리, 클라우드 예약, 데이터 수/미리보기/내보내지 않은 데이터 조회 및 강화된 확인에 대한 정확한 v0.1.28 명령어 이름과 플래그는 복사하여 사용할 예시를 추가하기 전에 `octoparse capabilities --json` 또는 v0.1.28 명령어 도움말에서 확인해야 합니다.
  </Note>
</Update>

<Update label="2026년 4월 24일" description="주간 업데이트" tags={["MCP Server"]}>
  ## 새로운 기능

  * **이중 모드 `execute_task`** — 이제 [`execute_task`](/docs/ko/mcp/execute-task) 도구가 클라이언트에 가장 적합한 실행 경로를 자동으로 선택합니다. MCP Task를 지원하는 클라이언트는 실행 중 실시간 진행 상황 업데이트와 스트리밍 결과를 받습니다. 다른 클라이언트는 즉시 작업 ID를 받고 결과를 폴링할 수 있어 장시간 스크래핑도 세션을 차단하지 않습니다.
  * **API 키 인증** — 이제 OAuth뿐 아니라 API 키로도 [Octoparse MCP 서버](/docs/ko/mcp)에 연결할 수 있습니다. API 키는 Claude Code, VS Code, TRAE, OpenClaw 같은 헤드리스 또는 자동화 환경의 설정을 간소화합니다. [Octoparse 계정 센터](https://www.octoparse.kr/console/account-center/api-keys)에서 키를 생성하세요.

  ## 업데이트

  * **MCP 무료 체험 크레딧** — 이제 무료 및 Basic 계정은 MCP 추출용으로 **매주 2,000개 레코드**를 받으며 시작을 위해 업그레이드할 필요가 없습니다. [사전 요구 사항](/docs/ko/mcp#사전-요구-사항)을 참고하세요.
  * **Gemini 지원** — 이제 Gemini가 MCP 서버에서 완전히 지원되는 클라이언트입니다. [설정 가이드](/docs/ko/mcp#지원-클라이언트)를 참고하세요.
</Update>

<Update label="2026년 4월 3일" description="주간 업데이트" tags={["CLI"]}>
  ## 새로운 기능

  * **`octoparse detect`** — Octoparse 확장 브라우저를 열어 URL을 검사하고 로컬 작업 파일을 생성하는 새 명령어입니다. 자동 영역 선택용 `--auto`, 안내형 브라우저 상호작용용 `--manual`, AI 에이전트 워크플로용 `--agent` 및 준비-미리보기-적용 방식을 지원합니다. [URL에서 작업 생성](/docs/ko/cli/guides/detect)을 참고하세요.
  * **OAuth 로그인** — `octoparse auth login --oauth`가 브라우저 기반 OAuth 흐름을 열고 액세스 및 새로 고침 토큰을 로컬에 저장합니다. API 키를 수동으로 관리하지 않으려는 경우 유용합니다.
  * **`auth info` 명령어** — 새로운 `octoparse auth info` 하위 명령어가 활성 세션의 자세한 계정 및 자격 증명 정보를 표시합니다.
  * **`OCTO_ENGINE_ACCESS_TOKEN`** — Bearer 토큰 인증을 위한 새로운 환경 변수입니다. 자격 증명 저장이 바람직하지 않은 단기 CI 작업에 유용합니다.

  ## 업데이트

  * **JSONL 이벤트 유형 확장** — 이제 `run --jsonl`이 기존 이벤트에 더해 `captcha`, `proxy`, `download.started`, `download.succeeded`, `download.failed` 이벤트를 내보냅니다. [출력 및 종료 코드](/docs/ko/cli/reference/output-and-exit-codes)를 참고하세요.
  * **내보내기용 `--lot-id` 플래그** — 이제 `data export`와 `local export`가 최신 실행 대신 특정 실행 로트를 내보내는 `--lot-id <lotId>`를 지원합니다.
  * **진단용 `--chrome-path`** — 이제 `doctor`와 `browser doctor`가 특정 Chrome 설치를 테스트하는 `--chrome-path`를 지원합니다.
  * **Linux arm64 설명 보강** — Chrome for Testing에 Linux arm64 패키지가 없으므로 Linux arm64에서는 로컬 추출(`run`, `detect`)이 지원되지 않습니다. 클라우드 추출은 모든 플랫폼에서 작동합니다.
</Update>