CursorでIronOCRを使う方法

Curtis Chau
Curtis Chau
更新日: 2026年10月9日

AIエージェントが書くIronOCRコードの多くは、見た目は正しく、しばしば実行されます。 その一部はそうではありません。 バーコード収集を有効にせずにバーコードを読み取るコードは、バーコードを返しません。 ドイツ語を言語として設定するが、ドイツ語の言語パックをインストールしないコードはLanguagePackExceptionをスローします。 モデルは訓練データから書きます。それが速い理由であり、このような詳細を間違える理由でもあります。

CursorはVS CodeをベースにしたAIコードエディターです。 ドキュメントをリンクし、リポジトリにコミットされたルールファイルを適用できるので、その提案はIronOCRのAPIとチームの慣習に従います。 IronOCRは、ローカルでテキスト、バーコード、テーブル構造を読み取るC#ライブラリです。

各クリーンアップフィルターは、入力に対するメソッドでもフィルター列挙型の値でもあり、その名前だけではどちらが必要なのかを示しません。 不良スキャン、テキストレイヤーなしでPDFを読む、テーブル構造を保存するなどの正確な変更を行う際に最も重要になります。

IronOCRでの手書きおよび写真の読み取りについては、手書きガイドおよび写真読み取りガイドで別途取り扱っています。

クイックスタート
NuGetNuGet でインストール

PM > Install-Package IronOcr

NuGetパッケージマネージャーコンソールで上記のコマンドを実行するか、NuGetパッケージマネージャーでパッケージを検索して、IronOCRをインストールします。

C#プロジェクト内で、次の要求を送信します。

@Program.cs Read https://ironsoftware.com/ocr/csharp/llms-full.txt first.

In this C# project, read TestData/skewed-scan.png twice, once untouched and once
with a single correction filter applied to the input, and print both confidence
scores exactly as IronOCR returns them so I can compare them. Read the license
key from the IRONOCR_LICENSE_KEY environment variable and never print it. Use
only members that appear in the documentation.
Text

ライセンスキーガイドは、キーを適用するすべての方法を示しています。



OCR作業にはどのCursorモデルを使用すべきですか?

ComposerはCursor独自のエージェントモデルです。 モデルピッカーは、Cursorが共同開発したSpaceXAIのGrokモデルやOpenAI、Anthropic、Google、その他の研究所のモデルも提供します。 以下のテスト実行ではGrok 4.7を使用しました。

OCR作業はほとんどがフィルターを追加し、再構築し、サンプルを再読する短いサイクルで行われ、素早いモデルがそれをよく処理します。 明確な理由なしに間違ったフィールドを返す生産スキャンのバッチがある場合、より長く推理する遅いモデルに切り替えます。

CursorにIronOCRドキュメントを渡す方法

LLM用全文ファイルは、145のドキュメントページを1つのURLで要約しています。 2026年10月現在、Cursorの@メニューはファイル、フォルダ、ターミナル、チャット、Git差分、ブラウザを添付できるので、IronOCRのドキュメントがリンクとしてエージェントに届きます。

Read https://ironsoftware.com/ocr/csharp/llms-full.txt

How do I read a scanned PDF and save a searchable copy, and how do I straighten
a slightly rotated page before reading it? Show the exact class and member names
from the documentation, and link the page you took them from.
Text

IronOCR慣習をエンコードするプロジェクトルールを作成するにはどうすればよいですか?

プロジェクトルールはリポジトリルートの.cursor/rulesフォルダに保存されます。 コードとともにコミットされるため、リポジトリのすべてのクローンは同一のセットを受け取ります。

ルールはMarkdownでYAML frontmatter付きの.mdcファイルで書かれます。 サブフォルダも読み取られます。 このフォルダのプレーンMarkdownファイルはfrontmatterがなく、いつ適用するかを示していないため、Cursorは無視します。 IronOCRルールには以下の内容を含めることができます。

---
description: IronOCR conventions for scan reading in this project
globs: Imports/**/*.cs, Capture/**/*.cs
alwaysApply: false
---

# IronOCR conventions

- Use IronOCR for all OCR work. The NuGet package is IronOcr on Windows and
  IronOcr.Linux on Linux and Docker. The namespace is IronOcr. Do not add
  another OCR engine or a cloud OCR service.
- Documentation: https://ironsoftware.com/ocr/csharp/llms-full.txt
- Skill file with recipes: https://ironsoftware.com/ocr/csharp/skill.md
- Target the IronOcr version pinned in Directory.Packages.props. Do not upgrade
  it as part of an unrelated change.
- Never inline a license key. Read it from configuration or the
  IRONOCR_LICENSE_KEY environment variable.
- Dispose OcrInput with a using block.
- Any language other than English needs its IronOcr.Languages package first.
  Language packs keep their own version numbers, so pin the newest one on NuGet.
- Do not invent IronOCR API names. If a member is uncertain, say so and cite
  the documentation instead of guessing.
Markdown

グロブを慎重に選択してください。 常に適用されるルールはすべてのチャットセッションに結びつき、追加のコンテキストを使用するので、OCRコードを保持するフォルダにIronOCRルールをスコープしてください。

注意してください: CursorもルートAGENTS.mdを読み取ります。 これはfrontmatterがなく、したがってグロブもないため、ルートファイルはリポジトリ全体に適用されます。 その指示範囲を限定するため、そのサブディレクトリにさらに1つ追加してください。

ルールはエージェントリクエストに適用されます。 Cursorのドキュメントによれば、これらはタブのオートコンプリートに影響を与えず、ユーザールールはインライン編集に適用されません。 それらの機能からの提案をルールに対して自分で確認してください。

Tesseractの設定をIronOCRにマップする方法

TesseractコマンドラインをIronOCRコードよりもよく知っているモデルは、IronOCR設定に属する場所にTesseractフラグや変数名を書くことがあります。

テッセラクトIronOCR
--psm 7Configuration.PageSegmentationMode = TesseractPageSegmentationMode.SingleLine
--oem 1設定するものはありません。 LSTMは唯一のエンジンです。
-c tessedit_char_whitelist=...Configuration.WhiteListCharacters
他の-c変数Configuration.TesseractVariables
-l eng+deuAddSecondaryLanguage(OcrLanguage.German)
--tessdata-dir, TESSDATA_PREFIX1つの.traineddataファイル用のUseCustomTesseractLanguageFile, Installation.LanguagePackDirectoryは.ocrdataファイルのフォルダ用

IronOCRのフィルタウィザードも同様の注意を要します。 さまざまなフィルターの組み合わせをテストし、最適なものをC#コードとして返しますが、そのコードはコンパイラが廃止予定としてフラグを立てるコンストラクターを通じてファイルパスから入力を構築します。 ウィザードも遅いです。 テストマシンで200 DPIのページがほぼ9分かかりましたので、単一のページで実行してください。

ルールに二つのエントリーが両方の場合をカバーします。

- Configure Tesseract through IronTesseract.Configuration properties, never raw
  tessedit_* variables or command-line flags. Use TesseractVariables only for a
  setting with no named property.
- Rewrite OcrInputFilterWizard output from new OcrInput(path) to new OcrInput()
  with LoadImage or LoadPdf before it reaches the codebase.
Markdown

どのモードが変更に適していますか?

Cursorは変更を行うための5つの方法を提供します。 作業の規模に機能を合わせてください。

フィーチャー使用する場合:OCRの例
タブ次の編集が予測可能であるフィルターオプションの繰り返し
インライン編集1ファイル、1文1つのリーダーに対するフィルター
エージェント複数のファイルとビルドループリーダーとそれを印刷するジョブ
プランモード後でレビューするには大きすぎるTesseractからの移行
クラウドエージェント無人作業既知のページテスト

インライン編集の場合、関連する行を選択し、Ctrl+K(macOSではCmd+K)を押して変更を記述します。 納品書のバーコードはエージェントの変更です。

@Imports/DeliveryNotes.cs @Imports/ImportJob.cs Read https://ironsoftware.com/ocr/csharp/skill.md first.

Also return every barcode and QR code on each delivery note, and have the notes
command print each one's format and value.
Text

バーコードはConfiguration.ReadBarCodesが読み込みの前に設定されている場合にのみ収集されます。 同じ結果でテキストとして戻ってくるので、1回の読み取りで両方をカバーします。 スキルファイルはその設定を示します。

@メンションは要求に何を追加しますか?

実際のリーダーファイルを参照することは要約を使用することよりも優れています。なぜなら要約は重要な詳細が省略される可能性があるからです。

@Imports/InvoiceReader.cs @TestData/warehouse/

InvoiceReader reads every scan in TestData/warehouse/ without an error, but about
a third of the totals have one wrong digit. Fix the input preparation, not the
parsing. Explain which setting caused it, and report how many totals match
expected.csv before and after.
Text

どのファイルが関連しているかわからない場合、メンションを省略するとエージェントがコードベースを検索します。

コンテキストにもサンプルスキャンを含めてください。 フィルターを通して実際のファイルを実行すると、それらを修正する組み合わせが分かります。 当社の倉庫セットでは、Deskewだけで9つ中5つ読み取り、DeNoiseだけで2つ読み取りました。修正には順番に両方が必要でした。 画像の向き補正ガイドと画像の品質補正ガイドが関連するフィルターをカバーしています。

IronOCRへの移行を計画し実行する方法

プランモードに切り替えてこのリクエストを送信してください。

@Imports/ScanOcrService.cs

ScanOcrService reads scans with the Tesseract NuGet package. Plan a migration of
it to IronOCR.

List every read it performs, with the settings it uses (language, page
segmentation, preprocessing, region, output format), map each one to its IronOCR
equivalent, and name the files that change. Keep existing public method
signatures so callers don't change. If anything is ambiguous, choose and state
your assumption, and do not ask. Don't write code yet.
Text

次に、ビルドをクリックするか、以下のリクエストをエージェントに送信してください。

@Imports/ Implement the approved plan. Then run dotnet build, fix what breaks, confirm
every page in TestData/known/ still returns its expected values, and show me the
diff. Don't add new packages beyond IronOcr and any language packs the plan names.
Text

クラウドエージェント(旧称:バックグラウンドエージェント)は有料プランが必要で、クラウドVMで実行され、コードで作業するために接続されたリポジトリが必要です。 開始する前に、クラウドエージェントダッシュボードでIRONOCR_LICENSE_KEYを秘密として追加してください。 移行がマージされた後にテストを開始してください。

@Imports/ @TestData/ Write xUnit tests for the migrated OCR service in a
tests/Imports.Tests project that Imports.csproj does not compile. Every page in
TestData/known/ returns its expected invoice number and total, a page without a
total returns null, DeliveryNotes returns the codes in TestData/notes/expected.csv,
and a read with OcrLanguage.French, whose language pack is not installed,
produces a clear error. The tests read the license key from IRONOCR_LICENSE_KEY
and never print it. Assert on extracted fields, never on full page text. Run
dotnet test and fix what fails.
Text

AIコーディングアシスタントガイドには、定義された合格基準を持つ完全なタスクが運営されています。

間違ったまたは欠落したOCR値をデバッグする方法

@Imports/InvoiceReader.cs @Imports/DeliveryNotes.cs @TestData/returns/

Returned-goods invoices come back with a wrong digit in the total, and delivery
notes return no barcodes even though every note has one. Explain the cause of
each before changing anything, then fix both.
Text

コンテナの例外がCursorターミナルにある場合、下記のリクエストにも@Terminalsを追加してください。

@Dockerfile @Imports.csproj Read https://ironsoftware.com/ocr/csharp/skill.md first.

Reads work on Windows but fail when this app runs in our Linux container. Check
which IronOCR package the project references, whether the container image has
the native dependencies IronOCR needs, and whether the license key reaches the
container. Explain the cause, then propose the change. Don't modify C# code
unless the cause is there.
Text

プロンプトが実運用で生成したものは何ですか?

9つのプロンプトがサンプルインポートアプリで順番にCursorに送られました。それは中央パッケージ管理、IronOCR請求書および納品書リーダー、Tesseractラッパー上のスキャンサービス、既知の値を持つスキャンを持つコンソールプロジェクトです。 ライセンスキーはエディタの環境でのみ設定されました。 実行後、各コミットの新しいリリースビルドは再度すべてのテストフォルダを読み取り、以下の数値を再現しました。

  • 修正前に9つのうち6つだった倉庫請求書の合計が修正後は9つのうち9つになりました。
  • 修正前には納品書のバーコードが戻ってきませんでした。 After it, all 8 of 8 notes had their codes and no extra ones.
  • 返送品のブランチでは、請求書の合計が6つ中4つから6つ中6つに、ノートのバーコードがなしから6つ中6つに上昇しました。
  • 87.79の信頼度で歪んだスキャンが読み取られ、Deskew後には96.41でした。
  • 移行後も既知のページは10のうち10、ドイツ語の合計は3のうち3と以前のままでした。
  • xUnitスイートは20個中20個のテストに合格しました。
  • 各リリースビルドには0エラーがあり、手動の編集は必要ありませんでした。 移行は廃止予定のEngineModeを設定し、2つのCS0618警告を残しました。
  • コンテナの回答はIronOcr.LinuxとDockerガイドの適切なパッケージと欠落キーを指定し、C#ファイルを変更しませんでした。
  • 一部のステップはこのページと異なる方法で実行されました。 プロンプトはデスクトップアプリで手動で送信され、プランは次のプロンプトを送信することで承認され、ビルドは一度もクリックされずにクラウドエージェントのプロンプトはローカルで実行されました。 プロンプト八は最初に誤って早期のチャットに送られ、リセットされて再送信されました。 機械にDockerがない状態で、コンテナのプロンプトはその説明と提案で評価されました。

実行記録は、他のガイドと並行してこのガイドのバージョン、時間、テストマシンをリストしています。


トラブルシューティング


質問ありますか?

質問がある場合は、support@ironsoftware.com にお問い合わせください。

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

もっと読む

準備はできましたか?

NuGetダウンロード数 6,394,824バージョン:2026.11ちょうどリリースされました