Octoparse CLI의 기능
URL에서 작업 생성
URL을 검사하고 자동, 수동 또는 AI 에이전트 워크플로로 로컬 작업 파일을 생성합니다.
작업 검색 및 관리
클라우드 작업 목록을 보고 키워드로 검색하며 작업 세부 정보를 확인하고 작업 그룹을 관리합니다.
템플릿에서 생성
템플릿을 조회하고 검색하며 템플릿 작업을 생성하거나 수정합니다.
로컬에서 작업 실행
내장 로컬 엔진과 독립 실행형 Chrome으로 Octoparse 작업을 실행합니다.
브라우저 모드 선택
독립 실행형 Chrome을 사용하거나 로그인된 Chrome 또는 Edge 프로필을 재사용합니다.
클라우드 작업 실행 및 예약
클라우드 추출을 시작하고 기록을 검토하며 반복 예약을 설정합니다.
데이터 검사 및 내보내기
레코드 수를 확인하고 행을 미리 보며 내보내지 않은 데이터를 검토하고 로컬 또는 클라우드 결과를 내보냅니다.
에이전트로 자동화
JSON 출력, JSONL 이벤트 스트림 및 종료 코드를 사용해 CLI를 스크립트와 AI 에이전트에 통합합니다.
작동 방식
Octoparse CLI는 로컬 추출을 위해 내장 Octoparse 엔진을 직접 실행합니다. 독립 실행형 Chrome을 사용하므로 Electron 데스크톱 클라이언트가 필요하지 않습니다. 클라우드 추출은 백엔드 API를 통해 제어되고, 로컬 추출은 로컬 엔진에서 제어됩니다.로컬 실행 상태는 이 CLI에서 추적하며 Octoparse 데스크톱 클라이언트 상태와 동기화되지 않습니다.
요구 사항
Octoparse CLI를 사용하기 전에 다음을 준비하세요.- Node.js 20 이상
- npm 8 이상
- Octoparse 계정(API 키 또는 OAuth)
- 실행하거나 내보낼 작업에 대한 접근 권한
--task-file 및 .otd 실행을 포함한 기능 명령어에는 인증이 필요합니다. --help, --version, doctor, browser, capabilities, auth 같은 설정 및 진단 명령어는 인증 없이 실행할 수 있습니다.
일반적인 워크플로
1
Octoparse CLI 설치
npm으로 CLI를 전역 설치합니다.
2
인증
OAuth 또는 Octoparse API 키로 로그인합니다. CI에서는
OCTO_ENGINE_API_KEY 환경 변수를 사용하세요.3
작업 생성 또는 검색
octoparse detect <url>로 URL에서 작업 파일을 생성하거나 템플릿에서 작업을 생성합니다. 또는 octoparse task list로 기존 작업 ID를 찾습니다.4
작업 실행 또는 제어
작업을 로컬에서 실행하고 클라우드 실행을 시작 또는 중지하거나 클라우드 예약을 설정하고 실행 상태를 확인합니다.
5
데이터 검사 및 내보내기
데이터 상태와 행 미리보기를 확인하고 내보내지 않은 데이터를 검토하거나 로컬 또는 클라우드 결과에서 수집된 데이터를 내보냅니다.
빠른 명령어 예시
<taskId>는 실제 작업 ID로, <url>은 스크래핑할 페이지로 바꾸세요.
현재 제한 사항
Octoparse CLI v1은 커널 브라우저 또는 레거시 워크플로를 지원하지 않습니다. 커널 브라우저는 이전 Octoparse 런타임 워크플로에서 사용하던 브라우저 모드를 뜻합니다. 레거시 워크플로는 현재 CLI 런타임이 지원하지 않는 이전 Octoparse 작업 정의로 만든 작업을 뜻합니다. 작업이 지원되지 않으면 최신 Octoparse 데스크톱 앱에서 작업을 다시 만들거나 업데이트한 뒤 CLI로 다시 실행하세요.다음 단계
Octoparse CLI 설치
Node.js를 설정하고 npm으로 CLI를 설치한 뒤 로컬 런타임을 확인합니다.
URL에서 작업 생성
detect를 사용해 URL에서 작업 파일을 생성합니다.
모든 명령어 보기
작업, 템플릿, 예약, 감지, 로컬 실행, 클라우드 실행, 인증 및 내보내기 명령어를 확인합니다.