OpenQR

OpenQR

Gerador de QR code gratuito, open-source e sem marca d'água. Funciona inteiramente no seu navegador — sem rastreamento, sem cadastro, sem limites.

A maioria dos geradores de QR code online te atrai com "grátis" e depois adiciona uma marca d'água, limita o tamanho do download, esconde a exportação vetorial atrás de um paywall, ou roteia seu código pelos servidores deles para que ele morra quando você parar de pagar. Um QR code é apenas um padrão aberto (ISO/IEC 18004) que não custa nada para gerar. O OpenQR mantém isso assim.

Este repositório é a ferramenta geradora básica — a implementação open-source de referência. Ele é deliberadamente pequeno e fácil de fazer fork.

Versão hospedada: API gratuita, servidor MCP e códigos editáveis

Tudo neste repositório é e permanece gratuito, sem marca d'água e sem expiração. A versão hospedada em openqr.uk adiciona uma camada de conta opcional para quem quer códigos editáveis e automação:

• QR codes dinâmicos / editáveis com análise de escaneamento. Mude o destino depois de imprimir. 3 gratuitos em uma conta gratuita (7 dias de escaneamentos por país); ilimitados no Pro por £9/mês ou £72/ano, que também desbloqueia histórico completo de análises, detalhes por cidade e região, detalhamento por dispositivo e referenciador com exportação CSV, um subdomínio personalizado e códigos protegidos por senha.
• API REST gratuita. Gere códigos e gerencie códigos dinâmicos programaticamente. Especificação OpenAPI em /openapi.json; documentação interativa em openqr.uk/api.
• Servidor MCP hospedado em https://openqr.uk/mcp (HTTP Streamable, 17 ferramentas). Gere e gerencie QR codes diretamente do Claude, Cursor ou qualquer cliente MCP. Listado no Registro MCP oficial. Clientes com capacidade remota se conectam a essa URL diretamente; clientes somente stdio podem fazer a ponte com npx -y @open-qr/mcp e OPENQR_API_KEY configurados (detalhes).

O gerador estático neste repositório nunca chama nada disso. Ele permanece 100% no lado do cliente (veja Privacidade), e nada disso é necessário para usar ou auto-hospedar o gerador.

Ferramentas

O servidor MCP hospedado em https://openqr.uk/mcp expõe estas 17 ferramentas. Toda ferramenta exige uma chave de API gratuita — crie uma em openqr.uk/api e passe-a como Authorization: Bearer oqr_... na conexão MCP.

Ferramenta	O que faz
generate_qr	Gera um QR code estático a partir de qualquer texto ou URL. Retorna uma imagem PNG ou marcação SVG.
create_dynamic_qr	Cria um QR code editável cujo destino você pode alterar depois sem reimprimir.
update_dynamic_qr	Altera o destino, o rótulo, o link curto personalizado, as tags ou a pasta de um código dinâmico.
get_dynamic_qr	Obtém os detalhes completos de um código: destino, link curto, rótulo, tipo, tags, pasta, status, data de criação.
get_scans	Estatísticas de escaneamento de um código dinâmico.
list_dynamic_qr	Lista seus códigos dinâmicos com id, URL curta, destino, rótulo e status.
delete_dynamic_qr	Exclui permanentemente um código dinâmico. O link curto dele para de funcionar.
bulk_create_dynamic_qr	Cria até 200 códigos dinâmicos de uma vez.
list_folders	Lista suas pastas.
create_folder	Cria uma pasta para organizar códigos.
delete_folder	Exclui uma pasta. Os códigos dela são desarquivados, não excluídos.
list_themes	Lista temas de estilo salvos. Aplique um passando seu id ou nome como theme.
create_theme	Salva um tema de estilo reutilizável (cores, estilos de pontos e cantos).
delete_theme	Exclui um tema salvo. Códigos já estilizados com ele mantêm sua aparência.
get_subdomain	Mostra o subdomínio personalizado na conta e se ele está suspenso.
set_subdomain	Reivindica ou altera o subdomínio personalizado para que os códigos também sejam resolvidos em {name}.oqr.to. Somente Pro.
clear_subdomain	Libera o subdomínio personalizado. Os códigos continuam ativos no link curto comum.

Ele também expõe 5 recursos e 4 prompts:

• Recursos são predefinições de estilo de QR code integradas em openqr://preset/classic, /teal, /high-contrast, /dots e /classy. Leia um e passe seu estilo para create_theme.
• Prompts são create_tracked_qr, bulk_qr_for_print, brand_a_qr e qr_scan_report.

Recursos

• Sem marcas d'água, sem limites de tamanho, sem cadastro — todo recurso é gratuito
• Privado por design — os códigos são gerados inteiramente no seu navegador; o conteúdo nunca toca um servidor
• Exporte para qualquer lugar — PNG / WebP até 4096px, além de SVG e PDF vetoriais reais
• Estilização completa — cores, gradientes, estilos de pontos e cantos, incorporação de logotipo, molduras "Scan me"
• Entrada inteligente — cole um link ou texto e o tipo é detectado automaticamente
• Payloads ricos — URL, texto, e-mail, telefone, SMS, WhatsApp, Wi-Fi e um seletor de localização baseado em mapa
• Cópia com um clique, links de design compartilháveis, claro/escuro, responsivo, acessível por teclado

Início rápido

pnpm install
pnpm dev        # http://localhost:3011

Build e auto-hospedagem

pnpm build
pnpm start      # serves on :3011 (standalone output)

É um aplicativo Next.js padrão — hospede em qualquer lugar (um VPS, um Raspberry Pi, Cloudflare, atrás de qualquer proxy reverso). Ele não precisa de variáveis de ambiente, banco de dados ou segredos para funcionar.

Incorporação

O componente <Generator/> é autossuficiente e configurável:

import { Generator } from "@/components/generator/generator";

// Full page (default OpenQR logo header):
<Generator />

// Embedded widget, your own branding, no default header:
<Generator embedded header={<MyLogo />} />

// Inject your own post-download call-to-action:
<Generator renderSuccess={(variant) => <MySupportCluster variant={variant} />} />

A ferramenta vem com zero análise de dados. Se você quiser eventos de UI anônimos (por exemplo, qual formato de exportação foi usado — nunca o conteúdo do QR), injete um manipulador:

import { setTrackHandler } from "@/lib/analytics";
setTrackHandler((action, name, category) => myAnalytics.track(category, action, name));

Privacidade

A geração de QR codes acontece 100% no seu navegador. As únicas chamadas externas opcionais estão na ferramenta Localização: blocos de mapa da CARTO e consultas de endereço via Nominatim do OpenStreetMap. Nada mais sai do dispositivo.

Pilha tecnológica

Next.js 16 (App Router) · React 19 · TypeScript (estrito) · Tailwind v4 · qr-code-styling · Leaflet · pnpm.

Contribuindo

Veja CONTRIBUTING.md. Mantenha simples, acessível, no lado do cliente e gratuito — nenhum recurso deve exigir pagamento para remover uma marca d'água ou desbloquear um formato.

Licença

AGPL-3.0 © 2026 Sam Moreton.

Você é livre para usar, estudar, modificar, auto-hospedar e redistribuir o OpenQR sob a AGPL-3.0. Se você executar uma versão modificada como um serviço de rede, a AGPL exige que você disponibilize seu código-fonte sob a mesma licença. Se isso não atender ao seu caso de uso, uma licença comercial está disponível — veja NOTICE.