CLI

CamScanner CLI es una herramienta de línea de comandos para terminales, scripts, pruebas y flujos automatizados con control explícito de entradas, parámetros y salidas.

Requisitos

• Node.js y npm; macOS, Linux o Windows en x64/arm64.
• Un navegador para OAuth y permiso para procesar cada archivo.

Instalación

En un proyecto se recomienda instalar localmente y usar npx; la instalación global sirve para varios directorios. No uses --omit=optional, porque los binarios de plataforma son dependencias opcionales.

npm install camscanner-cli
npx camscanner-cli --version

npm install -g camscanner-cli
camscanner-cli --version

Inicio de sesión

camscanner-cli auth status
camscanner-cli auth login
camscanner-cli auth logout

auth login abre el navegador y espera en primer plano.

Estructura de comandos

camscanner-cli <group> <command> [file...] [flags]

Grupo	Uso
image	Mejora, OCR, conversión, traducción, detección, edición y combinación
pdf	Conversión, páginas y marcas de agua
txt	Conversión de texto
doc	Buscar, descargar y mover documentos y consultar carpetas
auth	Estado y autorización

Comandos frecuentes

OCR de imagen / OCR gambar

camscanner-cli image ocr document.jpg
camscanner-cli image ocr document.jpg > result.txt

Imagen a Word o Excel / Gambar ke Word atau Excel

camscanner-cli image convert document.jpg --format word -o result.docx
camscanner-cli image convert table.png --format excel -o result.xlsx

PDF a Word o Markdown / PDF ke Word atau Markdown

camscanner-cli pdf convert report.pdf --format word -o report.docx
camscanner-cli pdf convert paper.pdf --format md -o paper.md

Quitar sombras / Hapus bayangan

camscanner-cli image enhance scan.jpg --mode 5 -o enhanced.jpg

Combinar imágenes / Gabungkan gambar

camscanner-cli image merge-pdf "page1.jpg" "page2.jpg" "page3.jpg" -o merged.pdf

Traducir / Terjemahkan

camscanner-cli image translate menu.jpg --lang en -o menu-en.jpg

Factura o recibo / Faktur atau struk

camscanner-cli image receipt invoice.jpg

Buscar en la nube / Cari cloud

camscanner-cli doc search "contract"

Enumera los archivos y confirma el orden; la combinación admite hasta 100 imágenes y no debe depender de comodines desordenados. Confirma también el resultado de búsqueda antes de descargar o mover.

Salida local y en la nube

Opción	Comportamiento
-o, --output <path>	Guardar en una ruta local
-s, --save	Guardar en CamScanner cloud
--save-title <title>	Título del documento
--save-dir <name>	Carpeta por nombre
--save-dir-id <id>	Carpeta por ID

camscanner-cli pdf convert contract.pdf \
  --format word \
  -o contract.docx \
  -s \
  --save-title "Purchase contract-editable"

-o puede sobrescribir un archivo. No todas las salidas admiten -s; consulta --help.

Scripts, actualización y desinstalación

Usa rutas explícitas, conserva stderr y autoriza OAuth antes de ejecutar sin supervisión. Nunca confirmes credenciales ni directorios de autenticación.

npm update camscanner-cli
npm uninstall camscanner-cli
npm install -g camscanner-cli@latest
npm uninstall -g camscanner-cli

Problemas frecuentes

• Comando no encontrado: usa npx o añade el directorio global de npm a PATH.
• Binario ausente: comprueba SO/arquitectura y reinstala dependencias opcionales.
• Login esperando: termina la autorización en el navegador.
• Guardado en raíz: usa camscanner-cli doc dirs y --save-dir-id.

Límites y seguridad

• Máximo 40 MB por carga. Imágenes JPG/JPEG/PNG; documentos PDF/TXT/Markdown.
• Marcas de agua PDF hasta 100 páginas; PDF con contraseña no compatible.
• Los archivos se envían al servidor; no expongas tokens y confirma alcance, orden y ruta.

Siguiente paso

Consulta Skill, MCP o Capacidades.