> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# クイックスタート

License を取得し、Docker で FineParser を実行して、5 分以内に最初の Document を DocLang へ解析してみましょう。

<h2 id="before-you-begin">
  始める前に
</h2>

* [Docker](https://docs.docker.com/get-docker/) がインストールされ、実行されていること
* 解析対象の PDF または画像ファイル
* FineParser の License file。[fineparser.ai](https://www.fineparser.ai/#pricing) でプランに登録すると、`.fineparserlicense` ファイルが発行されます。[License とプラン](/ja/fine-parser/basics/licenses-and-plans)を参照してください。
* ABBYY の License server への外向き通信。ネットワークで送信が制限されている場合は、まず[ネットワーク要件](/ja/fine-parser/reference/data-privacy#network-requirements)に記載された範囲を許可してください。

<Steps>
  <Step title="Licenseを取得する">
    [fineparser.ai](https://www.fineparser.ai/#pricing) でプランに登録します。Free プランでは月あたり 1,000 ページまで利用できます。アカウントごとに `.fineparserlicense` ファイルが 1 つ発行されます。
  </Step>

  <Step title="FineParser を起動する">
    License file の内容を `FINEPARSER_LICENSE_DATA` 環境変数に渡し、ポート 8080 を公開します。

    ```bash theme={null}
    docker run -d --name fineparser -p 8080:8080 \
      -e FINEPARSER_LICENSE_DATA="$(cat acme.fineparserlicense)" \
      -v fineparser-output:/app/output \
      abbyyteam/fineparser
    ```

    このボリュームには解析結果が保存されます。指定しない場合、コンテナーの終了とともに結果も失われます。

    <Note>
      Apple シリコン Mac などの ARM ホストでは、上記のコマンドに `--platform linux/amd64` を追加してください。現時点でイメージは amd64 のみに対応しており、エミュレーションで動作するため速度は低下します。[ARM での実行](/ja/fine-parser/basics/configuration#running-on-arm)を参照してください。
    </Note>

    次に、License が受け付けられたことを確認します。

    ```bash theme={null}
    curl -s localhost:8080/healthz
    # {"code":"ok","ready":true,"telemetry":true}
    ```

    `ready` が `false` の場合は、レスポンスの `detail` フィールドにその理由が示されます。[License の確認](/ja/fine-parser/basics/configuration#confirming-the-license)を参照してください。
  </Step>

  <Step title="Document を送信する">
    ```bash theme={null}
    curl -s -X POST http://localhost:8080/parse \
      -F "file=@invoice.pdf" \
      -F "outputType=doclang"
    ```

    FineParser は Document を受け付け、直ちに job ID を返します。

    ```json theme={null}
    {"jobId":"6c4f1f0e-...","file":"invoice.pdf"}
    ```
  </Step>

  <Step title="完了を待つ">
    `status` が `successful` になるまで、ID を使って job をポーリングします。

    ```bash theme={null}
    curl -s http://localhost:8080/jobs/6c4f1f0e-...
    ```

    ```json theme={null}
    {"status":"successful","file":"6c4f1f0e-.../invoice.pdf.doclang"}
    ```

    1 ページの invoice であれば数秒で完了します。`status` が `failed` の場合は、レスポンスにその理由を示す `error` が含まれます。
  </Step>

  <Step title="結果をダウンロードする">
    `file` の値を `/jobs/` の後ろに付け加えます。

    ```bash theme={null}
    curl -OJ http://localhost:8080/jobs/6c4f1f0e-.../invoice.pdf.doclang
    ```

    このファイルには、Document の構造とテキストが DocLang 形式で格納されています。

    ```xml theme={null}
    <doclang>
      <heading level="1">Invoice 4471</heading>
      <table>
        <ched/>Item<ched/>Qty<ched/>Amount<nl/>
        <fcel/>Consulting<fcel/>12<fcel/>$4,800.00<nl/>
      </table>
    </doclang>
    ```

    形式を変更するには、送信の Step で `doclang` を `json` または `txt` に置き換えます。
  </Step>
</Steps>

<h2 id="next-steps">
  次のステップ
</h2>

<CardGroup cols={2}>
  <Card title="REST API" icon="code" href="/ja/fine-parser/concepts/rest-api">
    送信、ポーリング、ダウンロード、そしてすべてのレスポンスコード。
  </Card>

  <Card title="出力形式" icon="file-code" href="/ja/fine-parser/basics/output-formats">
    DocLang、JSON、またはプレーンテキスト。
  </Card>

  <Card title="Configuration" icon="sliders" href="/ja/fine-parser/basics/configuration">
    Recognition mode、Languages、ポートの設定。
  </Card>

  <Card title="AI コーディングエージェント" icon="robot" href="/ja/fine-parser/getting-started/ai-agents">
    Claude Code や Codex からこのドキュメントを参照できるようにします。
  </Card>
</CardGroup>