> ## 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 카탈로그에 이미 있다면 템플릿을 사용하세요.

<Note>CLI v0.1.33 이상에서 템플릿 명령을 사용하려면 자격 증명을 구성해야 합니다. 템플릿을 검색하거나 확인하기 전에 `octoparse auth login`을 실행하세요.</Note>

## 템플릿 카탈로그 검색

```bash theme={null}
octoparse template search "Amazon" --page 1 --page-size 20
octoparse template search "Google Maps" --sort 1 --json
```

템플릿 검색에는 Octoparse 웹사이트와 동일한 카탈로그와 기본 순위가 사용됩니다.

## 템플릿 확인

```bash theme={null}
octoparse template view <templateId>
octoparse template version <templateId> --json
```

작업을 생성하기 전에 `template view`로 정규화된 매개변수와 생성된 예제를 검토하세요.

<Note>CLI 명령과 공개 JSON 출력은 `templateId`를 사용합니다. `templateRegistrationId`는 내부 API 필드이므로 CLI 통합에 사용해서는 안 됩니다.</Note>

## 템플릿 작업 생성

반복되는 `--param` 플래그로 단순 값을 전달합니다.

```bash theme={null}
octoparse template-task create <templateId> \
  --name "My template task" \
  --param keyword=laptop \
  --param country=US \
  --json
```

구조화된 매개변수는 JSON을 직접 전달하거나 파일을 사용하세요.

```bash theme={null}
octoparse template-task create <templateId> --params '{"keyword":"laptop"}' --json
octoparse template-task create <templateId> --params-file params.json --json
```

원격 작업을 생성하지 않고 요청을 미리 봅니다.

```bash theme={null}
octoparse template-task create <templateId> --params-file params.json --dry-run --json
```

## 템플릿 매개변수 업데이트

```bash theme={null}
octoparse template-task update <taskId> --params-file params.json --yes --json
```

템플릿 작업을 업데이트하면 원격 상태가 변경되며 `--yes`가 필요합니다.

## 다음 단계

<CardGroup cols={2}>
  <Card title="작업 관리" href="/docs/ko/cli/guides/tasks-and-groups">생성한 작업을 나열하고 이름 변경, 이동, 복사 및 검증합니다.</Card>
  <Card title="로컬에서 실행" href="/docs/ko/cli/guides/local-runs">내장 로컬 엔진으로 템플릿 작업을 실행합니다.</Card>
</CardGroup>