Linkly CLI

Linkly CLI هي أداة سطر الأوامر لإدارة حسابك في Linkly من الطرفية. أنشئ روابط مختصرة واسحب تحليلات النقرات وأدر النطاقات المخصصة وتعامل مع webhooks وصدّر البيانات — دون الحاجة لترك shell أو كتابة أي كود API.

وهي مبنية على Linkly API وتعمل على macOS و Linux و Windows.

التثبيت

يتطلب CLI Node.js الإصدار 20 أو أحدث. ثبّته عالميًا باستخدام npm:

npm install -g @linkly-link-shortener/cli

هذا يضيف أمر linkly إلى نظامك. تأكد من أنه يعمل:

linkly --help

تسجيل الدخول

يدعم CLI طريقتين لتسجيل الدخول. تحتاج فقط للقيام بهذا مرة واحدة — يتم حفظ بيانات اعتمادك بشكل آمن على جهازك وإعادة استخدامها في كل تشغيل.

لتسجيل الدخول باستخدام مفتاح API، قم بتشغيل:

linkly auth login --api-key

سيُطلب منك لصق مفتاح API الخاص بك، والذي يمكنك العثور عليه في إعدادات حسابك في Linkly.

لتسجيل الدخول باستخدام OAuth بدلاً من ذلك، قم بتشغيل:

linkly auth login

هذا يفتح متصفحك حتى تتمكن من الموافقة على الوصول — لا يوجد مفتاح API لنسخه.

تحقق من حالتك أو قم بتسجيل الخروج في أي وقت:

linkly auth status

linkly auth logout

إنشاء وإدارة الروابط

أنشئ وابحث عن وفتش وحدّث وحذف روابط مختصرة:

linkly links create --url https://example.com --name "Spring promo"

linkly links list --search promo

linkly links get 12345

linkly links update 12345 --url https://example.com/new

linkly links delete 12345

تحليلات النقرات

اعرض إجمالي النقرات مجمعة حسب البلد والمتصفح والنظام الأساسي وغيرها — أو كسلسلة زمنية على نطاق تاريخي:

linkly analytics by country

linkly analytics timeseries --start 2026-01-01 --end 2026-01-31

النطاقات المخصصة

اعرض قائمة بنطاقاتك المخصصة أو أضف واحدة جديدة:

linkly domains list

linkly domains create links.example.com

رموز QR وتصدير البيانات

قم بتنزيل رمز QR الخاص برابط ما أو صدّر روابطك وبيانات النقرات كـ CSV أو JSON:

linkly links qr 12345 --output qr.png

linkly links export --format csv --output links.csv

linkly analytics export --format csv --output clicks.csv

Webhooks

اشترك في URL لتلقي أحداث النقرات في الوقت الفعلي لرابط واحد أو لمساحة عمل كاملة:

linkly webhooks add https://example.com/hook --link 12345

العمل مع مساحات عمل متعددة

إذا كان حسابك يحتوي على أكثر من مساحة عمل واحدة، عيّن واحدة افتراضية:

linkly workspaces list

linkly workspaces use 42

يمكنك أيضًا استهداف مساحة عمل محددة لأمر واحد باستخدام خيار --workspace.

إخراج JSON للنصوص البرمجية

أضف --json إلى أي أمر للحصول على استجابة API الأولية بدلاً من الجدول المنسق — مفيد للأنابيب في أدوات مثل jq:

linkly links list --json

الحصول على المساعدة

لكل أمر مساعدة مدمجة. قم بتشغيل linkly --help للحصول على نظرة عامة أو أضف --help إلى أي أمر لرؤية خيارات وأمثلة:

linkly links create --help

استخدام CLI مع وكلاء AI

مساعدات الترميز التي يمكنها تشغيل أوامر shell — مثل Claude Code أو Cursor — يمكنها تشغيل Linkly CLI مباشرة.

• أضف --json إلى أي أمر للحصول على استجابة API الأولية بدلاً من الجدول المنسق.
• قم بتشغيل linkly schema لطباعة شجرة الأوامر الكاملة — كل أمر وحجة وخيار — كـ JSON، حتى يتمكن المساعد من اكتشاف ما يمكن للـ CLI القيام به.
• أضف --help إلى أي أمر لرؤية خيارات وأمثلة.

إذا كان مساعد AI الخاص بك لا يستطيع تشغيل أوامر shell، استخدم Linkly MCP Server بدلاً من ذلك — فهو يربط المساعدين مثل Claude و ChatGPT بحسابك في Linkly مباشرة.