> ## 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 워크플로로 결과를 내보내세요.

이 가이드에서는 작업을 찾아 로컬에서 실행하고 결과를 확인한 다음 데이터를 내보내는 가장 짧은 전체 CLI 워크플로를 안내합니다.

시작하기 전에 [설치](/docs/ko/cli/quick-start/installation)와 [인증](/docs/ko/cli/quick-start/get-api-key-and-log-in)을 완료하세요.

## 작업 찾기

계정에서 사용할 수 있는 작업을 나열합니다.

```bash theme={null}
octoparse task list
```

정확한 작업 ID를 복사해야 할 때는 JSON 출력을 사용하세요.

```bash theme={null}
octoparse task list --limit 10 --json
```

선택한 작업을 확인합니다.

```bash theme={null}
octoparse task show <taskId> --json
octoparse task validate <taskId>
```

## 로컬에서 작업 실행

```bash theme={null}
octoparse run <taskId>
```

첫 소규모 실행에서는 제한된 행 수에 도달하면 중지합니다.

```bash theme={null}
octoparse run <taskId> --max-rows 20
```

서버나 자동화 환경에서는 독립 헤드리스 브라우저를 사용하세요.

```bash theme={null}
octoparse run <taskId> --headless --max-rows 20 --json
```

<Note>로컬 브라우저 기반 추출은 macOS x64/arm64, Windows x64 및 Linux x64를 지원합니다. Linux arm64는 지원하지 않습니다.</Note>

## 결과 확인

로컬 기록과 행 수를 확인합니다.

```bash theme={null}
octoparse data history <taskId> --source local --json
octoparse data count <taskId> --source local
octoparse data preview <taskId> --source local --limit 5
```

## 데이터 내보내기

```bash theme={null}
octoparse data export <taskId> --source local --format xlsx
```

다른 형식이나 파일 이름을 선택합니다.

```bash theme={null}
octoparse data export <taskId> --source local --format csv --file result.csv
```

지원 형식은 `xlsx`, `csv`, `html`, `json`, `xml`입니다.

## 선택 사항: 클라우드에서 실행

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

클라우드 추출은 Octoparse 인프라에서 실행되므로 로컬 브라우저 프로세스를 계속 열어 둘 필요가 없습니다.

## 계속 학습하기

<CardGroup cols={2}>
  <Card title="작업 및 그룹 관리" href="../guides/tasks-and-groups">작업을 복사하고 이름 변경, 이동, 삭제 및 구성합니다.</Card>
  <Card title="브라우저 모드 구성" href="../guides/browser-modes">필요할 때 로그인된 Chrome 또는 Edge 프로필을 재사용합니다.</Card>
  <Card title="로컬 실행 제어" href="../guides/local-runs">로컬 실행을 분리, 일시 중지, 재개, 중지 및 확인합니다.</Card>
  <Card title="클라우드 작업 실행 및 예약" href="../guides/cloud-runs-and-schedules">클라우드 기록과 반복 예약을 관리합니다.</Card>
</CardGroup>