> ## 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.

# Octoparse CLI 자동화

> 기능 검색, JSON 출력, 환경 자격 증명 및 종료 코드를 사용해 CI, 스크립트 및 AI 에이전트에서 Octoparse CLI를 사용하세요.

스크립트나 에이전트 워크플로에서 사람이 읽는 도움말을 구문 분석하는 대신 기계 판독 가능 출력과 기능 검색을 사용하세요.

## 현재 계약 검색

```bash theme={null}
octoparse capabilities --json
```

응답에는 지원 명령, 인증, 브라우저 모드, 출력 스키마, 수명 주기 이벤트 및 권장 에이전트 레시피가 설명됩니다.

에이전트는 플래그나 JSON 필드에 관한 가정을 하드 코딩하지 말고 워크플로 시작 시 계약을 확인해야 합니다.

## CI에서 인증

```bash theme={null}
OCTO_ENGINE_API_KEY=xxx octoparse task list --json
OCTO_ENGINE_ACCESS_TOKEN=xxx octoparse task list --json
```

자격 증명 우선순위는 액세스 토큰, API 키, `octoparse auth login`에서 저장한 자격 증명 순입니다.

<Warning>자격 증명을 출력하거나 커밋하거나 공유 로그, 스크린샷 또는 생성된 문서에 포함하지 마세요.</Warning>

## 출력 모드 선택

```bash theme={null}
octoparse task list --json
octoparse run <taskId> --json
octoparse run <taskId> --jsonl
```

* `--json`은 하나의 결과 봉투를 반환합니다.
* `--jsonl`은 포그라운드 실행 이벤트를 JSON Lines로 스트리밍합니다.
* 사람용 출력은 대화형 터미널 사용을 위한 것입니다.

스키마, 수명 주기 이벤트, stdout/stderr 동작 및 실패 코드는 [출력 및 종료 코드](../reference/output-and-exit-codes)를 참고하세요.

## 에이전트로 작업 생성

에이전트는 `--auto`가 아니라 `detect --agent` 또는 준비/미리보기/적용 워크플로를 사용해야 합니다.

```bash theme={null}
octoparse detect <url> \
  --agent \
  --agent-command "path/to/trusted-agent" \
  --goal "Extract product titles and prices" \
  --run-sample 5 \
  --json
```

기능 응답의 `machineContract.recipes.createTaskFromUrlWithAgent`를 따르세요. 신뢰할 수 있는 실행 파일만 `--agent-command`에 전달하세요.

## 상태 변경 명령 확인

이름 변경, 이동, 삭제, 업데이트 또는 예약 변경 명령에는 `--yes`가 필요할 수 있습니다. 자동화를 구성하기 전에 `capabilities --json`으로 확인 요구 사항을 검색하세요.

## 내부 명령

`env`는 내부 API 환경을 전환하고 `runs`는 내부 로컬 결과물을 확인합니다. 기본 사용자 워크플로에는 포함되지 않습니다. Octoparse 지원팀의 별도 안내가 없다면 공개 작업 ID 및 lot ID 명령을 사용하세요.