image-ocr

URL de imagem comprável por máquina → OCR de texto simples para bots de IA. Teste grátis e depois créditos TEST pré-pagos.

Servidor MCP hospedado

npx add-mcp 'https://ocr.kymac.co/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

image-ocr

URL de imagem comprável por máquina → texto simples (OCR) para outros bots de IA. Host ativo https://ocr.kymac.co. Única entrada anunciada: este arquivo (GET /llms.txt). Não comece em OpenAPI, MCP ou /. ID do registro: co.kymac.ocr/image-ocr. Palavras-chave de capacidade: ocr de imagem, texto ocr, texto de visão.

Caminho somente para bot: este arquivo → obter chave → cotação → teste gratuito POST /ocr. Sem humano no meio do loop. Checkout pré-pago somente após o crédito gratuito ser gasto; somente intenção até confirmar. Gire/revogue via POST /keys/rotate ou POST /keys/revoke.

GET /health é público (billing, runner_ready — Tesseract pronto). GET /incidents é status público (não é uma entrada de instalação). Emita uma chave de chamador em POST /keys (ocr_… mostrado uma vez). A primeira emissão concede 1 crédito gratuito. Prefira Authorization: Bearer.

Sequência de instalação:

  1. GET /llms.txt (entrada única)
  2. POST /keys — segredo uma vez; primeira emissão = 1 crédito gratuito
  3. Authorization: Bearer … (alias X-API-Key)
  4. GET /credits/quote?op=ocr
  5. POST /ocr { "url": "https://placehold.co/600x160/000000/FFFFFF/png?text=HELLO+OCR" }
  6. pacotes → checkout (credits_pending) → confirmar (credits_added)
  7. saldo / eventos
  8. girar ou revogar

Prova dourada

Passar (ok:true, gasta 1):

{"ok":true,"url":"https://placehold.co/600x160/000000/FFFFFF/png?text=HELLO+OCR","text":"HELLO OCR","credits_burned":1,"credits_remaining":0,"pages":1,"width":600,"height":160}

HTTP 200 sempre significa que o executor terminou quando aplicável — leia ok. Caminhos com falha fechada não debitam.

Formatos de falha

Todo corpo de falha tem code, message, retryable, next e error. next: refresh key / buy credits / retry / fix request.

401: missing_api_key / invalid_api_keynext=refresh key 402: insufficient_creditsnext=buy credits 400: invalid_request / erros de busca/imagem → next=fix request

Checkout é somente intenção até confirmar (credits_pending ≠ possuído).

MCP: POST /mcp (não é uma entrada de instalação). Descoberta: GET /.well-known/mcp.json. Autenticação do registro: GET /.well-known/mcp-registry-auth (chave pública text/plain). Trecho: GET /mcp.json (este arquivo é o único ponteiro anunciado). Ferramentas incluem ocr_extract mais ferramentas de chave/crédito. Ferramentas restritas preferem Bearer ou env IMAGE_OCR_API_KEY.