Código QR por línea de comandos: instalar y usar la CLI de sameqr

Por qué la línea de comandos

Una CLI (Command Line Interface) es un programa que manejas con comandos de texto en el terminal. Un comando se puede repetir, escribir en un script, encadenar con otras herramientas y ejecutar desde un agente de programación. La CLI de sameqr lleva Same-QR justo ahí. No tiene más dependencias y solo necesita Node.js a partir de la versión 18.

Paso 1: instalar

La CLI llega a través de npm, el gestor de paquetes de Node.js:

npm install -g sameqr
sameqr --version

Paso 2: crear una clave de API

En el panel, en Cuenta, encuentras la sección «Acceso para CLI, scripts y agentes». Crea allí una clave. Para empezar basta «lectura + escritura»: crear, modificar nombres y textos. Quien también quiera cambiar los destinos de códigos QR existentes, desactivar páginas o eliminarlas elige «completo». Empieza por sqr_live_ y solo se muestra una vez. Guárdala de inmediato en tu gestor de contraseñas.

Paso 3: iniciar sesión

La clave nunca se pasa como argumento, porque si no quedaría en el historial del shell. «sameqr login» la pide de forma oculta, la comprueba y la guarda legible solo para ti en ~/.config/sameqr/config.json. Como alternativa, define la variable de entorno SAMEQR_API_KEY, que siempre tiene prioridad.

sameqr login
sameqr whoami

«sameqr whoami» muestra tu cuenta, el plan y cuántos códigos QR puedes crear.

Paso 4: crear el primer código QR

sameqr qr create --name "Speisekarte Tische" --url https://example.com/karte
sameqr qr list
sameqr qr update <id> --url https://example.com/winterkarte
sameqr qr stats <id>

Con --slug fijas al crearlo un enlace corto propio, con --label añades etiquetas. Sus identificadores los muestra «sameqr labels list». Cambiar el destino, desactivar y eliminar requieren una clave «completo». La CLI pregunta entonces en el terminal; en scripts sin terminal solo funciona con un --yes explícito. A través de la API se permiten como máximo 10 cambios así por hora y 30 por día.

Paso 5: páginas de invitados y cartas de restaurante

sameqr seite create --vorlage speisekarte --name "Gasthof zum Löwen"
sameqr karte import karte-1.jpg karte-2.jpg --seite menu/gasthof-zum-loewen
sameqr seite publish menu/gasthof-zum-loewen
sameqr qr create --name "Tischaufsteller" --seite menu/gasthof-zum-loewen

«seite create» muestra la dirección de la nueva página, en el ejemplo menu/gasthof-zum-loewen. La necesitas para los comandos siguientes. La página se crea como borrador. «karte import» lee las fotos con IA y añade los grupos detectados a la página, sin sobrescribir nada. Revisa el borrador antes de publicar. Para publicar, los datos del responsable deben estar rellenados. El último comando crea un código QR que apunta directamente a la página. Otras plantillas: preisliste, zeiten, links, aktion, weingut, etikett y kontakt.

Paso 6: en scripts con --json

Si añades --json a un comando, la respuesta llega como JSON. Los errores también salen entonces como JSON en la salida de errores, y el código de retorno indica el tipo: 3 significa sin sesión iniciada, 4 permisos insuficientes, 2 una entrada incorrecta. Así un script reacciona de forma precisa, en lugar de interpretar texto.

sameqr qr list --json

Conclusión: por qué Same-QR

La CLI de sameqr lleva todas las funciones de Same-QR al terminal: códigos QR, estadísticas, páginas de invitados, cartas de restaurante a partir de fotos, etiquetas y proyectos. Es ligera, trata tu clave con cuidado y habla JSON para scripts y agentes de programación. Y funciona en todos los planes.

Empieza ya: regístrate gratis en sameqr.com, 20 códigos QR dinámicos son gratis para siempre. API, CLI y servidor MCP están en todos los planes, y la documentación está en sameqr.com/entwickler.

Preguntas frecuentes