OpenQR
resmiQR 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şturun —
generate_qrile herhangi bir metin veya URL'den QR kodu isteyin; PNG veya SVG olarak döndürülür. - Düzenlenebilir dinamik kodlar oluşturun —
create_dynamic_qrkullanarak hedefini daha sonra yeniden yazdırmadan değiştirebileceğiniz bir QR oluşturun. - Kodları güncelleyin ve yönetin —
update_dynamic_qrile hedefleri, etiketleri, etiketleri veya klasörleri değiştirin;list_dynamic_qrvedelete_dynamic_qrile listeleyin veya silin. - Baskı kampanyaları için toplu oluşturma —
bulk_create_dynamic_qrile aynı anda 200'e kadar dinamik kod oluşturun. - Klasörler ve temalarla düzenleyin —
create_folderile klasörler oluşturun ve tutarlı marka uygulamak içincreate_themeile yeniden kullanılabilir stil ön ayarları kaydedin. - Tarama analizlerini takip edin —
get_scanskullanarak 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.
Ç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/mcpadresinde (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 istemcilernpx -y @open-qr/mcpveOPENQR_API_KEYayarları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ı gerektirir — openqr.uk/api
adresinden bir tane oluşturun ve MCP bağlantısında Authorization: Bearer oqr_... olarak iletin.
| Araç | Ne yapar |
|---|---|
generate_qr | Herhangi 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_qr | Hedefini daha sonra yeniden yazdırmadan değiştirebileceğiniz düzenlenebilir bir QR kodu oluşturur. |
update_dynamic_qr | Dinamik bir kodun hedefini, etiketini, özel kısa bağlantısını, etiketlerini veya klasörünü değiştirir. |
get_dynamic_qr | Bir 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_scans | Dinamik bir kod için tarama istatistikleri. |
list_dynamic_qr | Dinamik kodlarınızı kimlik, kısa URL, hedef, etiket ve durumla listeler. |
delete_dynamic_qr | Dinamik bir kodu kalıcı olarak siler. Kısa bağlantısı çalışmayı durdurur. |
bulk_create_dynamic_qr | Aynı anda 200'e kadar dinamik kod oluşturur. |
list_folders | Klasörlerinizi listeler. |
create_folder | Kodları düzenlemek için bir klasör oluşturur. |
delete_folder | Bir klasörü siler. Kodları klasörden çıkarılır, silinmez. |
list_themes | Kayıtlı stil temalarını listeler. Kimliğini veya adını theme olarak ileterek birini uygulayın. |
create_theme | Yeniden kullanılabilir bir stil teması kaydeder (renkler, nokta ve köşe stilleri). |
delete_theme | Kayıtlı bir temayı siler. Onunla zaten stillendirilmiş kodlar görünümlerini korur. |
get_subdomain | Hesaptaki markalı alt alan adını ve askıya alınıp alınmadığını gösterir. |
set_subdomain | Markalı alt alan adını talep eder veya değiştirir, böylece kodlar {name}.oqr.to adresinde de çözümlenir. Yalnızca Pro. |
clear_subdomain | Markalı 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,/dotsve/classyadreslerindeki yerleşik QR stil ön ayarlarıdır. Birini okuyun ve stilinicreate_theme'a iletin. - İstemler
create_tracked_qr,bulk_qr_for_print,brand_a_qrveqr_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.