| name | ocr |
| description | Processes documents through case.dev OCR for text and table extraction. Supports PDF and image files up to 500MB with page-level and word-level output. Use when the user mentions "OCR", "text extraction", "scan document", "digitize", "extract text from PDF", or needs word-level positional data from documents. |
case.dev OCR
Production-grade document OCR with table extraction and word-level positional data. Processes PDFs and images (PNG, JPG, TIFF, BMP, WEBP) up to 500MB.
Requires the casedev CLI. See setup skill for installation and auth.
Process a Document
casedev ocr process --document-url "https://example.com/contract.pdf" --json
Flags: --document-url (required), --document-id (optional tag), --engine (override).
Returns a job ID and initial status.
Check Job Status
casedev ocr status JOB_ID --json
Statuses: queued -> processing -> completed or failed.
Watch Until Complete
casedev ocr watch JOB_ID --json
Flags: --interval (default: 3s), --timeout (default: 900s).
Word-Level Data
casedev ocr words --vault VAULT_ID --object OBJECT_ID --json
Requires the document to be in a vault with completed OCR ingestion.
Flags: --page (specific page), --word-start, --word-end (index range).
Returns per-page word arrays with text, word index, and confidence scores.
Common Workflows
OCR a vault document
casedev vault object upload ./scanned-contract.pdf --vault VAULT_ID --json
casedev vault object list --vault VAULT_ID --json
casedev ocr words --vault VAULT_ID --object OBJECT_ID --json
OCR an external document
casedev ocr process --document-url "https://storage.example.com/doc.pdf" --json
casedev ocr watch JOB_ID --json
Troubleshooting
"Invalid file type for OCR": Only PDFs and images supported. Check content type with casedev vault object list.
Job stuck in "processing": Increase timeout with --timeout 1800. Large documents (100+ pages) take longer.
"OCR job failed": Document may be corrupted or unsupported. Re-upload and retry.
