Iflytek PDF Image OCR

What it does

When your agent uses it

• User asks to OCR images
• Extract text from images/PDFs
• Convert PDF to Word/Markdown
• Perform any OCR tasks on images

Example prompts

• “/iflytek-pdf-image-ocr”

Requirements

• Python 3
• A credential in IFLY_API_KEY
• A credential in IFLY_API_SECRET

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

1. 1Generate RFC1123 format date: EEE, dd MMM yyyy HH:mm:ss GMT
2. 2Create signature origin: host: {host}\ndate: {date}\nPOST {path} HTTP/1.1
3. 3Calculate signature: HMAC-SHA256(signature_origin, apiSecret)
4. 4Build authorization: hmac username="{apiKey}", algorithm="hmac-sha256", headers="host date request-line", signature="{signature}"
5. 5Encode authorization in base64
6. 6Send as query parameters: ?authorization={auth}&host={host}&date={date}

What it can do on your machine

Read from SKILL.md and the folder at commit 58dc114. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 2 files in scripts/ (Python), which the agent can run.

  Shell commands in SKILL.md call:

  • python3

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Hosts in commands or code, which the agent is likely to contact:

  • bjcdn.openstorage.cn

  Also links to:

  • console.xfyun.cn

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • API_SECRET
  • API_KEY
  • IFLY_API_KEY
  • IFLY_API_SECRET

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Iflytek PDF Image OCR loads about 2.3k tokens when it runs. Until then it costs about 91 tokens; SKILL.md has 719 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~91

When it runs · the whole SKILL.md, loaded when a task matches

~2.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from iflytek/iFly-Skills at commit 58dc114, republished under its Apache-2.0 licence (© iflytek). 719 words, ~2,299 tokens.

name

iflytek-pdf-image-ocr

description

ifly-pdf-image-ocr skill supporting both image OCR (AI-powered LLM OCR) and PDF document recognition. Use when user asks to OCR images, extract text from images/PDFs, convert PDF to Word/Markdown, or perform any OCR tasks on images or PDFs. Supports multi-language text extraction, document layout understanding, and various output formats.

metadata.homepage

https://www.xfyun.cn/services/ocr

metadata.openclaw

{"emoji":"📄","dimensions":["文档OCR","PDF识别"],"user_instructions":["OCR这个PDF","提取图片中的文字","帮我把这个文档转成文字"],"requires":{"bins":["python3"],"env":["IFLY_APP_ID","IFL…

# OCR an image and extract text
python3 scripts/image_ocr.py /path/to/image.jpg

# Save result to file
python3 scripts/image_ocr.py /path/to/image.jpg -o output.txt

# Specify output format
python3 scripts/image_ocr.py /path/to/image.jpg --format json
python3 scripts/image_ocr.py /path/to/image.jpg --format markdown

# Convert PDF to Word (default)
python3 scripts/pdf_ocr.py document.pdf

# Convert PDF to Markdown
python3 scripts/pdf_ocr.py document.pdf --format markdown

# Convert PDF to JSON
python3 scripts/pdf_ocr.py document.pdf --format json

# From public URL
python3 scripts/pdf_ocr.py --pdf-url "https://example.com/doc.pdf" --format word

# Required for both Image OCR and PDF OCR
export IFLY_APP_ID="your_app_id"

# Required for Image OCR
export IFLY_API_KEY="your_api_key"

# Required for PDF OCR
export IFLY_API_SECRET="your_api_secret"

{
  "header": {
    "code": 0,
    "message": "success"
  },
  "payload": {
    "result": {
      "text": "Base64-encoded OCR text..."
    }
  }
}

{
  "flag": true,
  "code": 0,
  "desc": "成功",
  "data": {
    "taskNo": "25082744936879",
    "status": "CREATE",
    "tip": "任务创建成功"
  }
}

{
  "flag": true,
  "code": 0,
  "desc": "成功",
  "data": {
    "taskNo": "25082759289333",
    "exportFormat": "word",
    "status": "FINISH",
    "downUrl": "http://bjcdn.openstorage.cn/...",
    "tip": "已完成",
    "pageList": [...]
  }
}

© iflytek, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (scripts) in skills/iflytek-pdf-image-ocr of iflytek/iFly-Skills.

• SKILL.md
• README.md
• _meta.json
• scripts/image_ocr.py
• scripts/pdf_ocr.py

Open the folder on GitHubat commit 58dc114