CursorでIronOCRを使う方法
AIエージェントが書くIronOCRコードの多くは、見た目は正しく、しばしば実行されます。 その一部はそうではありません。 バーコード収集を有効にせずにバーコードを読み取るコードは、バーコードを返しません。 ドイツ語を言語として設定するが、ドイツ語の言語パックをインストールしないコードはLanguagePackExceptionをスローします。 モデルは訓練データから書きます。それが速い理由であり、このような詳細を間違える理由でもあります。
CursorはVS CodeをベースにしたAIコードエディターです。 ドキュメントをリンクし、リポジトリにコミットされたルールファイルを適用できるので、その提案はIronOCRのAPIとチームの慣習に従います。 IronOCRは、ローカルでテキスト、バーコード、テーブル構造を読み取るC#ライブラリです。
各クリーンアップフィルターは、入力に対するメソッドでもフィルター列挙型の値でもあり、その名前だけではどちらが必要なのかを示しません。 不良スキャン、テキストレイヤーなしでPDFを読む、テーブル構造を保存するなどの正確な変更を行う際に最も重要になります。
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.
ライセンスキーガイドは、キーを適用するすべての方法を示しています。
最小限のワークフロー(5ステップ)
- NuGetからC# OCRライブラリをダウンロード
- IronOCRのドキュメントリンクを保持するフォルダスコープのルールをコミットしてください。
- 同じルールでIronOCRパッケージに名前を付け、
Directory.Packages.props内でそのバージョンを維持してください。 - 各リクエストを関連するコードとサンプルスキャンに向けてください。
- 抽出された値を既知のページと比較してコンパイルしてください。
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.
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.
グロブを慎重に選択してください。 常に適用されるルールはすべてのチャットセッションに結びつき、追加のコンテキストを使用するので、OCRコードを保持するフォルダにIronOCRルールをスコープしてください。
AGENTS.mdを読み取ります。 これはfrontmatterがなく、したがってグロブもないため、ルートファイルはリポジトリ全体に適用されます。 その指示範囲を限定するため、そのサブディレクトリにさらに1つ追加してください。ルールはエージェントリクエストに適用されます。 Cursorのドキュメントによれば、これらはタブのオートコンプリートに影響を与えず、ユーザールールはインライン編集に適用されません。 それらの機能からの提案をルールに対して自分で確認してください。
Tesseractの設定をIronOCRにマップする方法
TesseractコマンドラインをIronOCRコードよりもよく知っているモデルは、IronOCR設定に属する場所にTesseractフラグや変数名を書くことがあります。
| テッセラクト | IronOCR |
|---|---|
--psm 7 | Configuration.PageSegmentationMode = TesseractPageSegmentationMode.SingleLine |
--oem 1 | 設定するものはありません。 LSTMは唯一のエンジンです。 |
-c tessedit_char_whitelist=... | Configuration.WhiteListCharacters |
他の-c変数 | Configuration.TesseractVariables |
-l eng+deu | AddSecondaryLanguage(OcrLanguage.German) |
--tessdata-dir, TESSDATA_PREFIX | 1つの.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.
どのモードが変更に適していますか?
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.
バーコードは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.
どのファイルが関連しているかわからない場合、メンションを省略するとエージェントがコードベースを検索します。
コンテキストにもサンプルスキャンを含めてください。 フィルターを通して実際のファイルを実行すると、それらを修正する組み合わせが分かります。 当社の倉庫セットでは、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.
次に、ビルドをクリックするか、以下のリクエストをエージェントに送信してください。
@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.
クラウドエージェント(旧称:バックグラウンドエージェント)は有料プランが必要で、クラウド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.
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.
コンテナの例外が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.
プロンプトが実運用で生成したものは何ですか?
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がない状態で、コンテナのプロンプトはその説明と提案で評価されました。
実行記録は、他のガイドと並行してこのガイドのバージョン、時間、テストマシンをリストしています。
トラブルシューティング
- 生成されたコードがライセンス例外をスローする場合、IronOCRでライセンスキーを適用する
- ある読み取りがテキストを返すがバーコードを返さない場合、IronOCRでバーコードを読む
- 読み取られた値がスキャンと一致しない場合、OCR精度を向上させる
- ローカルで動作するがLinuxコンテナ内で失敗する場合、Docker上のIronOCR
質問ありますか?
質問がある場合は、support@ironsoftware.com にお問い合わせください。
Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。