> ## 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タスクを一覧表示し、確認し、ローカルで実行し、ステータスを確認してデータをエクスポートします。
このページでは、一般的な抽出フローに沿って、タスクの検索、確認、実行、監視、結果のエクスポートまでを行います。
v0.1.28 では、タスクグループのワークフロー、テンプレートタスクのワークフロー、クラウドスケジュール、データの可視性拡張も追加されました。これらの新しい領域の正確なコマンドは、スクリプトで使用する前に `octoparse capabilities --json` または v0.1.28 のコマンドヘルプで確認してください。
## タスクを一覧表示する
```bash theme={null}
octoparse task list
```
ページネーションを使用します。
```bash theme={null}
octoparse task list --page 2 --page-size 20
```
返されるタスク数を制限します。
```bash theme={null}
octoparse task list --limit 10
```
キーワードで検索します。
```bash theme={null}
octoparse task list --keyword news --page 1 --page-size 10
```
機械可読な出力には `--json` を使用します。
```bash theme={null}
octoparse task list --json
```
## タスクを確認する
タスクリストから取得したタスクIDを使用します。
```bash theme={null}
octoparse task inspect
```
`task inspect` は、タスク定義、フィールド名、関連するタスクメタデータを表示します。
実行前にタスクを検証します。
```bash theme={null}
octoparse task validate
```
`task validate` は、タスクが現在のCLIランタイムと互換性があり、ローカルで実行できるかどうかを確認します。検証に失敗した場合は、タスク定義を確認し、Octoparseでタスクを更新するか、Octoparseサポートに連絡してください。
## タスクグループを使う
タスクグループを使うと、関連するタスクをまとめ、グループに属するタスクを探しやすくなります。
確認が必要：タスクグループの一覧表示やグループ内のタスク確認を行う正確な v0.1.28 コマンドは、ローカルCLI 0.1.24 のヘルプにはありませんでした。
## タスクをローカルで実行する
```bash theme={null}
octoparse run
```
ヘッドレスモードで実行します。
```bash theme={null}
octoparse run --headless
```
保存する最大行数に達したらローカル抽出を停止します。
```bash theme={null}
octoparse run --max-rows 100
```
バックグラウンドで実行します。
```bash theme={null}
octoparse run --detach
```
デタッチした後は、`octoparse local status`、`octoparse local pause`、`octoparse local resume`、`octoparse local stop` を使って実行を管理します。
ローカル実行の成果物をカスタムディレクトリに書き込みます。
```bash theme={null}
octoparse run --output ./runs
```
`--output` を使用した場合は、後で `data history` や `data export` を実行するときにも同じパスを指定してください。
## ローカル実行を確認または制御する
```bash theme={null}
octoparse local status
```
ローカル実行ステータスはこのCLI内でのみ追跡され、Octoparseデスクトップクライアントのステータスとは同期されません。これはローカル実行にのみ適用されます。
```bash theme={null}
octoparse local pause
octoparse local resume
```
```bash theme={null}
octoparse local stop
```
```bash theme={null}
octoparse local history
```
```bash theme={null}
octoparse local cleanup
```
`octoparse local cleanup` は、古いローカル実行状態と一時ファイルを削除します。現在実行中のタスクは停止しません。
## クラウド実行を開始または確認する
```bash theme={null}
octoparse cloud start
```
```bash theme={null}
octoparse cloud status
```
```bash theme={null}
octoparse cloud history
```
```bash theme={null}
octoparse cloud stop
```
## クラウドスケジュールを設定する
クラウドスケジュールは、毎日の監視や毎週のレポート収集など、定期的に実行したいタスクに便利です。
確認が必要：正確な v0.1.28 のスケジュールコマンド、頻度の値、タイムゾーンの動作、制限は、ローカルCLI 0.1.24 のヘルプにはありませんでした。
## データを確認・エクスポートする
エクスポート前にデータを確認します。
* **レコード数（Count）**：データが存在するか、何行利用できるかを確認します。
* **プレビュー（Preview）**：エクスポート前にサンプル行を確認します。
* **未エクスポート（Unexported）**：まだエクスポートされていないデータを特定します。
* **エクスポート（Export）**：完全な結果を取得します。
確認が必要：レコード数、プレビュー、未エクスポートデータの正確な v0.1.28 コマンドは、ローカルCLI 0.1.24 のヘルプにはありませんでした。既存のエクスポートコマンドは以下のとおりです。
ローカルデータをXLSXとしてエクスポートします。
```bash theme={null}
octoparse data export --source local --format xlsx
```
クラウドデータをCSVとしてエクスポートします。
```bash theme={null}
octoparse data export --source cloud --format csv
```
特定のファイルにエクスポートします。
```bash theme={null}
octoparse data export --source local --format csv --file ./result.csv
```
ローカル抽出時にカスタム出力ディレクトリを使用した場合は、ローカル履歴を読み取るときやローカルデータをエクスポートするときに、同じ `--output` の値を使用してください。
```bash theme={null}
octoparse run --output ./runs
octoparse data history --source local --output ./runs
octoparse data export --source local --output ./runs --format xlsx
```
## 次のステップ
detectを使って、デスクトップアプリなしで任意のURLからタスクファイルを生成します。
タスク、detect、ローカル実行、クラウド実行、認証、エクスポート関連のコマンドを確認します。
スクリプトや自動化でJSON出力、JSONLストリーム、終了コードを使う方法を確認します。
認証エラー、Chrome問題、Linux arm64、エクスポートエラーの解決方法です。