FreeQrly
للوكلاء

رموز QR، بدون المتصفح.

FreeQrly يتحدث HTTP و MCP. ولّد رموز QR ثابتة من أي وكيل أو سكربت أو سير عمل — بدون مفتاح، بدون تسجيل، بدون انتهاء. إذا استطعت إرسال طلب، تستطيع صنع رمز.

طرق الاتصال

🧰 خادم MCP

أضف https://freeqrly.com/mcp إلى عميل MCP الخاص بك. أداة واحدة — generate_qr — بدون مصادقة. يعمل مع Claude Code وCursor وأي شيء يتحدث HTTP القابل للبث.

🌐 HTTP API

نقطة نهاية GET بسيطة تُرجع SVG. CORS مفتوح تمامًا، لذا تستطيع المتصفحات وcurl والدوال بلا خادم استدعاءها مباشرة.

📜 مهارة الوكيل

مهارة SKILL.md مع وصفات الحمولة تعيش في المستودع في skills/qr-generator/. وجّه وكيلك إليها وسيعرف الباقي.

🤖 llms.txt

/llms.txt يصف الموقع كاملًا للزواحف والمساعدين — نقاط النهاية وتنسيقات الحمولة وخريطة الصفحات في ملف واحد.

HTTP API

GET https://freeqrly.com/api/qr?data=TEXT&size=1024&margin=4&color=2F4A62&bgcolor=ffffff&ecc=M

يُرجع image/svg+xml. فقط data هو المطلوب؛ وكل شيء آخر له قيمة افتراضية معقولة. تعود الأخطاء كـ JSON مع حقل error.

curl "https://freeqrly.com/api/qr?data=https://example.com&size=1024" \
  -o qr.svg

# WiFi QR code for guests
curl "https://freeqrly.com/api/qr?data=WIFI:T:WPA;S:CafeNet;P:s3cret;;" \
  -o wifi.svg

المعلمات

  • data — النص المراد ترميزه (مطلوب، 2000 حرف كحد أقصى). روابط، سلاسل WiFi، بطاقات vCard، نص عادي.
  • size — حجم المخرجات بالبكسل، 128–2048 (الافتراضي 1024).
  • margin — المنطقة الهادئة بالوحدات، 0–10 (الافتراضي 4).
  • color / bgcolor — ست عشري من 6 أرقام، بدون # (الافتراضيان 2F4A62 / ffffff).
  • ecc — تصحيح الأخطاء L، M، Q، H (الافتراضي M). استخدم Q/H للطباعة أو الشعارات.

MCP

POST https://freeqrly.com/mcp

HTTP قابل للبث قياسي: initialize، ثم tools/list / tools/call. تأخذ أداة generate_qr data، size، color، bgcolor، ecc وتُرجع رابط SVG جاهزًا للتنزيل.

{
  "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": {
    "name": "generate_qr",
    "arguments": { "data": "https://example.com", "size": 1024 }
  }
}

وصفات الحمولة

Website : https://example.com/menu
WiFi    : WIFI:T:WPA;S:CafeNet;P:s3cret;;
Contact : BEGIN:VCARD\nVERSION:3.0\nN:Ada Lovelace\nTEL:+15550100\nEND:VCARD
Place   : geo:37.7749,-122.4194
SMS     : sms:+15550100?body=Hello

الاستخدام العادل

إنه مجاني، لكن كن لطيفًا: خزّن النتائج مؤقتًا بدل إعادة طلب الرمز نفسه، وأبقِ حركة المرور الآلية معقولة. حدود معدّل لكل IP سارية. الرموز الثابتة حتمية — نفس المدخلات تعطي دائمًا نفس المخرجات، لذا التخزين المؤقت سهل.