OpenQR

resmi

QR kodları oluşturun ve tarama analizleriyle dinamik (düzenlenebilir) QR kodlarını barındırılan bir MCP sunucusu (17 araç) ve ücretsiz bir REST API üzerinden yönetin.

OpenQR MCP ile neler yapabilirsiniz?

  • Statik QR kodlar oluşturungenerate_qr ile herhangi bir metin veya URL'den QR kodu isteyin; PNG veya SVG olarak döndürülür.
  • Düzenlenebilir dinamik kodlar oluşturuncreate_dynamic_qr kullanarak hedefini daha sonra yeniden yazdırmadan değiştirebileceğiniz bir QR oluşturun.
  • Kodları güncelleyin ve yönetinupdate_dynamic_qr ile hedefleri, etiketleri, etiketleri veya klasörleri değiştirin; list_dynamic_qr ve delete_dynamic_qr ile listeleyin veya silin.
  • Baskı kampanyaları için toplu oluşturmabulk_create_dynamic_qr ile aynı anda 200'e kadar dinamik kod oluşturun.
  • Klasörler ve temalarla düzenleyincreate_folder ile klasörler oluşturun ve tutarlı marka uygulamak için create_theme ile yeniden kullanılabilir stil ön ayarları kaydedin.
  • Tarama analizlerini takip edinget_scans kullanarak herhangi bir dinamik kod için ülke düzeyinde veriler dahil tarama istatistiklerini çekin.

Dokümantasyon

OpenQR

Ücretsiz, açık kaynaklı, filigransız QR kod üretici. Tamamen tarayıcınızda çalışır — takip yok, kayıt yok, sınır yok.

License: AGPL-3.0 Next.js No watermark

Çoğu çevrimiçi QR üretici sizi "ücretsiz" ile kandırır ve sonra filigran ekler, indirme boyutunuzu sınırlar, vektör dışa aktarımını ödeme duvarının arkasına saklar veya kodunuzu kendi sunucuları üzerinden yönlendirir, böylece ödemeyi bıraktığınızda kodunuz ölür. QR kodu, üretilmesi hiçbir maliyet gerektirmeyen açık bir standarttır (ISO/IEC 18004). OpenQR bunu böyle korur.

Bu depo, temel üretici araçtır — referans açık kaynaklı uygulama. Bilerek küçük ve çatallanması kolaydır.

Barındırılan sürüm: ücretsiz API, MCP sunucusu ve düzenlenebilir kodlar

Bu depodaki her şey ücretsizdir ve öyle kalır; filigran yok, süre sınırı yok. openqr.uk adresindeki barındırılan yapı, düzenlenebilir kodlar ve otomasyon isteyenler için isteğe bağlı bir hesap katmanı ekler:

  • Dinamik / düzenlenebilir QR kodlar tarama analizleriyle birlikte. Yazdırdıktan sonra hedefi değiştirin. Ücretsiz hesapta 3 ücretsiz (ülkeye göre 7 günlük tarama); Pro'da ayda £9 veya yılda £72 ile sınırsız; bu ayrıca tam analiz geçmişi, şehir ve bölge detayı, cihaz ve yönlendiren kaynak dökümleri ile CSV dışa aktarımı, markalı alt alan adı ve parola korumalı kodlar sunar.
  • Ücretsiz REST API. Kodları programatik olarak oluşturun ve dinamik kodları yönetin. OpenAPI şeması /openapi.json; etkileşimli dokümanlar openqr.uk/api adresinde.
  • Barındırılan MCP sunucusu https://openqr.uk/mcp adresinde (Streamable HTTP, 17 araç). QR kodlarını doğrudan Claude, Cursor veya herhangi bir MCP istemcisinden oluşturun ve yönetin. Resmi MCP Kayıt Defteri'nde listelenmiştir. Uzaktan bağlantı destekleyen istemciler doğrudan bu URL'ye bağlanır; yalnızca stdio destekleyen istemciler npx -y @open-qr/mcp ve OPENQR_API_KEY ayarlarıyla bu sunucuya köprü kurabilir (ayrıntılar).

Bu depodaki statik üretici bunların hiçbirini asla çağırmaz. %100 istemci tarafında kalır (bkz. Gizlilik) ve bunların hiçbiri üreticiyi kullanmak veya kendi kendine barındırmak için gerekli değildir.

Araçlar

https://openqr.uk/mcp adresindeki barındırılan MCP sunucusu bu 17 aracı sunar. Her araç ücretsiz bir API anahtarı gerektiriropenqr.uk/api adresinden bir tane oluşturun ve MCP bağlantısında Authorization: Bearer oqr_... olarak iletin.

AraçNe yapar
generate_qrHerhangi bir metin veya URL'den statik bir QR kodu oluşturur. PNG görüntüsü veya SVG işaretlemesi döndürür.
create_dynamic_qrHedefini daha sonra yeniden yazdırmadan değiştirebileceğiniz düzenlenebilir bir QR kodu oluşturur.
update_dynamic_qrDinamik bir kodun hedefini, etiketini, özel kısa bağlantısını, etiketlerini veya klasörünü değiştirir.
get_dynamic_qrBir kodun tüm ayrıntılarını alır: hedef, kısa bağlantı, etiket, tür, etiketler, klasör, durum, oluşturma tarihi.
get_scansDinamik bir kod için tarama istatistikleri.
list_dynamic_qrDinamik kodlarınızı kimlik, kısa URL, hedef, etiket ve durumla listeler.
delete_dynamic_qrDinamik bir kodu kalıcı olarak siler. Kısa bağlantısı çalışmayı durdurur.
bulk_create_dynamic_qrAynı anda 200'e kadar dinamik kod oluşturur.
list_foldersKlasörlerinizi listeler.
create_folderKodları düzenlemek için bir klasör oluşturur.
delete_folderBir klasörü siler. Kodları klasörden çıkarılır, silinmez.
list_themesKayıtlı stil temalarını listeler. Kimliğini veya adını theme olarak ileterek birini uygulayın.
create_themeYeniden kullanılabilir bir stil teması kaydeder (renkler, nokta ve köşe stilleri).
delete_themeKayıtlı bir temayı siler. Onunla zaten stillendirilmiş kodlar görünümlerini korur.
get_subdomainHesaptaki markalı alt alan adını ve askıya alınıp alınmadığını gösterir.
set_subdomainMarkalı alt alan adını talep eder veya değiştirir, böylece kodlar {name}.oqr.to adresinde de çözümlenir. Yalnızca Pro.
clear_subdomainMarkalı alt alan adını serbest bırakır. Kodlar düz kısa bağlantıda canlı kalır.

Ayrıca 5 kaynak ve 4 istem sunar:

  • Kaynaklar, openqr://preset/classic, /teal, /high-contrast, /dots ve /classy adreslerindeki yerleşik QR stil ön ayarlarıdır. Birini okuyun ve stilini create_theme'a iletin.
  • İstemler create_tracked_qr, bulk_qr_for_print, brand_a_qr ve qr_scan_report'tür.

Özellikler

  • Filigran yok, boyut sınırı yok, kayıt yok — her özellik ücretsizdir
  • Tasarım gereği gizli — kodlar tamamen tarayıcınızda oluşturulur; içerik asla bir sunucuya dokunmaz
  • Her yere dışa aktarın — 4096 piksele kadar PNG / WebP, ayrıca gerçek vektör SVG ve PDF
  • Tam stillendirme — renkler, gradyanlar, nokta ve köşe stilleri, logo yerleştirme, "Beni tara" çerçeveleri
  • Akıllı giriş — bir bağlantı veya metin yapıştırın, tür otomatik algılanır
  • Zengin yükler — URL, metin, e-posta, telefon, SMS, WhatsApp, Wi-Fi ve harita tabanlı konum seçici
  • Tek tıkla kopyalama, paylaşılabilir tasarım bağlantıları, açık/koyu, duyarlı, klavye erişilebilir

Hızlı başlangıç

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

Derleme ve kendi kendine barındırma

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

Standart bir Next.js uygulamasıdır — her yerde barındırın (bir VPS, bir Raspberry Pi, Cloudflare, herhangi bir ters proxy arkasında). Çalışması için ortam değişkeni, veritabanı veya sır gerekmez.

Gömme

<Generator/> bileşeni kendi kendine yeterlidir ve yapılandırılabilir:

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} />} />

Araç sıfır analiz ile gelir. Anonim UI olayları istiyorsanız (ör. hangi dışa aktarma biçimi kullanıldı — asla QR içeriği değil), bir işleyici enjekte edin:

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

Gizlilik

QR oluşturma %100 tarayıcınızda gerçekleşir. Tek isteğe bağlı giden çağrılar Konum aracındadır: CARTO'dan harita döşemeleri ve OpenStreetMap'in Nominatim'i aracılığıyla adres aramaları. Başka hiçbir şey cihazdan çıkmaz.

Teknoloji yığını

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

Katkıda bulunma

BKZ. CONTRIBUTING.md. Basit, erişilebilir, istemci tarafında ve ücretsiz tutun — hiçbir özellik filigranı kaldırmak veya bir biçimin kilidini açmak için ödeme gerektirmemelidir.

Lisans

AGPL-3.0 © 2026 Sam Moreton.

OpenQR'ı AGPL-3.0 altında kullanmakta, incelemekte, değiştirmekte, kendi kendine barındırmakta ve yeniden dağıtmakta özgürsünüz. Değiştirilmiş bir sürümü ağ hizmeti olarak çalıştırırsanız, AGPL kaynak kodunuzu aynı lisans altında kullanılabilir kılmanızı gerektirir. Bu kullanım durumunuza uymuyorsa, bir ticari lisans mevcuttur — bkz. NOTICE.