> ## 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 명령어 레퍼런스

> Octoparse CLI 인증, 브라우저, 작업, 템플릿, 감지, 로컬 실행, 클라우드 예약, 자동화 및 데이터 명령어의 구문을 빠르게 확인하세요.

이 페이지를 구문 색인으로 활용하세요. 설정, 동작, 예시 및 문제 해결 방법은 연결된 가이드를 참고하세요.

대부분의 기능 명령어에는 인증이 필요합니다. `<taskId>`와 같은 꺾쇠괄호는 필수 자리 표시자를 나타냅니다.

## 명령어 그룹

| 목적            | 명령어                                 | 가이드                                                |
| ------------- | ----------------------------------- | -------------------------------------------------- |
| 설치 및 인증       | `auth`, `doctor`                    | [인증](../quick-start/get-api-key-and-log-in)        |
| 브라우저 선택       | `browser`                           | [브라우저 모드](../guides/browser-modes)                 |
| 작업 관리         | `task`, `task-group`                | [작업 및 그룹](../guides/tasks-and-groups)              |
| 템플릿 사용        | `template`, `template-task`         | [템플릿 사용](../guides/templates)                      |
| URL에서 생성      | `detect`                            | [URL에서 작업 생성](../guides/detect)                    |
| 로컬 실행         | `run`, `local`                      | [로컬 실행](../guides/local-runs)                      |
| 클라우드 실행       | `cloud`, `schedule`                 | [클라우드 실행 및 예약](../guides/cloud-runs-and-schedules) |
| 데이터 검사 및 내보내기 | `data`                              | [데이터 및 내보내기](../guides/data)                       |
| 자동화           | `capabilities`, `--json`, `--jsonl` | [자동화 및 에이전트](../guides/automation)                 |

## 도움말 및 진단

```bash theme={null}
octoparse --help
octoparse --version
octoparse capabilities --json
octoparse doctor --json
octoparse browser status --json
```

## 인증

```bash theme={null}
octoparse auth login
octoparse auth login --oauth
octoparse auth login <apiKey>
octoparse auth login --stdin
octoparse auth status --json
octoparse auth info --json
octoparse auth logout
```

## 작업 및 그룹

```bash theme={null}
octoparse task list [--page <n>] [--page-size <n>] [--limit <n>] [--keyword <text>] [--task-group <groupId>] [--template-id <id>] [--json]
octoparse task show <taskId> [--json]
octoparse task copy <taskId> [--task-group <groupId>] [--json]
octoparse task rename <taskId> --name <name> --yes [--json]
octoparse task move <taskId> --task-group <groupId> --yes [--json]
octoparse task delete <taskId> --yes [--json]
octoparse task inspect <taskId> [--task-file <file.json|file.xml|file.otd>] [--json]
octoparse task validate <taskId> [--task-file <file.json|file.xml|file.otd>] [--json]

octoparse task-group list [--json]
octoparse task-group create <name> [--json]
octoparse task-group update <groupId> --name <name> --yes [--json]
octoparse task-group delete <groupId> --yes [--json]
octoparse task-group set-default <groupId> --yes [--json]
```

## 템플릿

```bash theme={null}
octoparse template search <keyword> [--page <n>] [--page-size <n>] [--sort <n>] [--json]
octoparse template view <templateId> [--json]
octoparse template version <templateId> [--json]
octoparse template-task create <templateId> [--name <taskName>] [--task-group <groupId>] [--param key=value]... [--params <json>|--params-file <file>] [--dry-run] [--json]
octoparse template-task update <taskId> [--params <json>|--params-file <file>] --yes [--json]
```

## 감지 및 브라우저

```bash theme={null}
octoparse detect <url> --auto [--goal <text>] [--output task.json] [--json]
octoparse detect <url> --manual [--goal <text>] [--output task.json]
octoparse detect <url> --agent --agent-command <cmd> [--goal <text>] [--run-sample <n>] [--json]

octoparse browser use independent|user [--browser-id chrome|edge] [--profile <name>] [--json]
octoparse browser status [--browser-id chrome|edge] [--profile <name>] [--json]
octoparse browser profiles [--browser-id chrome|edge] [--json]
octoparse browser install [--browser-id chrome|edge] [--profile <name>] [--force-close] [--json]
```

## 로컬 실행

```bash theme={null}
octoparse run <taskId> [--task-file <file>] [--output <dir>] [--max-rows <n>] [--detach] [--headless] [--json|--jsonl]
octoparse local status <taskId> [--output <dir>] [--json]
octoparse local pause <taskId> [--json]
octoparse local resume <taskId> [--json]
octoparse local stop <taskId> [--json]
octoparse local history <taskId> [--output <dir>] [--json]
octoparse local cleanup [--json]
```

## 클라우드 실행 및 예약

```bash theme={null}
octoparse cloud start <taskId> [--json]
octoparse cloud stop <taskId> [--json]
octoparse cloud status <taskId> [--json]
octoparse cloud history <taskId> [--json]

octoparse schedule cloud get <taskId> [--json]
octoparse schedule cloud next --type <type> --date <value> --time <value> [--month <value>] [--json]
octoparse schedule cloud update <taskId> --type <type> --date <value> --time <value> [--month <value>] [--enabled true|false] --yes [--json]
octoparse schedule cloud start <taskId> --yes [--json]
octoparse schedule cloud stop <taskId> --yes [--json]
```

## 데이터

```bash theme={null}
octoparse data history <taskId> [--source local|cloud] [--output <dir>] [--json]
octoparse data count <taskId> [--source local|cloud] [--unexported] [--json]
octoparse data preview <taskId> [--source local|cloud] [--limit <n>] [--offset <n>] [--unexported] [--json]
octoparse data export <taskId> [--source local|cloud] [--file <result.xlsx>] [--lot-id <lotId>] [--output <dir>] [--format xlsx|csv|html|json|xml] [--unexported] [--json]
```

## 내부 명령어

`env`와 `runs`는 내부 지원 및 아티팩트 검사 명령어입니다. Octoparse 지원팀에서 별도로 안내하지 않는 한 공개 작업 ID, 로트 ID, `local`, `data` 워크플로를 사용하세요.

<Tip>
  설치된 버전의 도움말은 `octoparse <command> --help`로 확인하고, 자동화 메타데이터는 `octoparse capabilities --json`을 사용하세요.
</Tip>