| name | extract |
| description | Extract text and structured data from images and PDFs using OpenAI Vision |
Extraction Skill
Extract text, data, and structured content from images and PDF documents using OpenAI Vision.
Capabilities
- Image OCR: Extract text from images using GPT-4 Vision
- PDF Text Extraction: Parse text from PDF documents
- Structured Output: Output as plain text, Markdown, or JSON
- Custom Prompts: Direct the extraction with specific instructions
Supported Formats
Input
- Images: PNG, JPG, JPEG, GIF, WEBP, BMP, TIFF
- Documents: PDF
Output
- text: Clean, readable plain text
- markdown: Structured Markdown with headings, lists, and tables
- json: Structured JSON with sections, tables, and metadata
Usage
bun run src/index.ts extract --input ./receipt.png --output ./receipt.txt
bun run src/index.ts extract -i ./document.pdf -o ./document.md -f markdown
bun run src/index.ts extract \
--input ./invoice.png \
--format json \
--prompt "Extract invoice number, date, total amount, and line items"
bun run src/index.ts extract \
--input ./handwriting.jpg \
--detail high \
--format text
Options
| Option | Short | Description |
|---|
--input | -i | Input file path (required) |
--output | -o | Output file path (optional) |
--format | -f | Output format: text, markdown, json |
--prompt | -p | Custom extraction prompt |
--model | -m | OpenAI model (default: gpt-4o) |
--detail | -d | Image detail: low, high, auto |
Environment Variables
export OPENAI_API_KEY="your-openai-key"
Examples
Receipt Extraction
bun run src/index.ts extract \
--input ./receipt.jpg \
--format json \
--prompt "Extract store name, date, items with prices, subtotal, tax, and total"
Document to Markdown
bun run src/index.ts extract \
--input ./report.pdf \
--format markdown \
--output ./report.md
Handwritten Notes
bun run src/index.ts extract \
--input ./notes.jpg \
--detail high \
--prompt "Transcribe the handwritten text, preserving the structure"