عميل سطر الأوامر
حسّن بياناتك مباشرةً من الطرفية
عميل سطر الأوامر الجديد عندنا هو أداة عالية الأداء ومترجمة بشكل ثابت، مبنية بلغة Go. تقدر كمطوّر أو عالم بيانات تتعامل مع Gender-API.com مباشرة من التيرمنال، بدون ما تحتاج تكتب أي كود وسيط أو wrapper.
يشتغل بشكل أصلي على macOS وLinux، وهذا يخليه خيار مثالي لسكربتات bash المؤتمتة، ومهام cron، أو دمجه ضمن مسارات عمل علم البيانات المحلية عندك.
أهم المزايا
- متعدد المنصات: يُترجَم إلى ملفّ تنفيذي واحد لأنظمة macOS وLinux وWindows.
- سريع وخفيف الوزن: مبني بلغة Go لتحقيق أقصى سرعة تنفيذ وبدون أي اعتماديات وقت التشغيل.
- متوافق مع الأنابيب: مرّر البيانات بسهولة من وإلى نظامك باستخدام تدفّقات POSIX القياسية. تكامل مع sed وawk وjq أو أدوات الذكاء الاصطناعي مثل ClaudeBot.
- التغطية: يدعم جميع نقاط نهاية V2 الرئيسية، بما في ذلك الاسم، البريد الإلكتروني، بلد المنشأ، وإحصاءات الحساب.
كيف تعمل
البدء باستخدام عميل سطر الأوامر (CLI) سريع وبسيط.
1. قم بضبط مفتاح API الخاص بك
علشان توثّق طلباتك بأمان بدون ما تنحفظ المفاتيح في سجل أوامر bash (history)، تقدر إمّا تصدّره كمتغيّر بيئة أو تحفظه في ملف إعدادات.
الخيار A: متغيّر البيئة
export GENDER_API_KEY="your-api-key-here"
الخيار B: ملف الإعدادات
أنشئ ملفًا باسم .gender-api-key داخل المجلد الرئيسي لمستخدمك، وضع بداخله التوكن الخاص بك فقط:
echo "your-api-key-here" > ~/.gender-api-key
2. استعلم من واجهة برمجة التطبيقات (API)
واجهة سطر الأوامر (CLI) تتيح لك التفاعل مع جميع نقاط النهاية الرئيسية. إليك بعض الأمثلة:
الاستعلام حسب الاسم الأول
$ gender-api-cli -first_name "Sandra" -country "US"
الاستعلام بالاسم الكامل
$ gender-api-cli -full_name "Theresa Miller"
الاستعلام عبر عنوان البريد الإلكتروني
$ gender-api-cli -email "thomasfreeman@example.com"
تحديد بلد الأصل
لمعرفة من أين يُرجَّح أن يكون الاسم، كل ما عليك هو إضافة علامة -origin:
$ gender-api-cli -first_name "Sandra" -origin
تحقق من إحصائيات الحساب
تحقّق بسرعة من الرصيد المتبقي لديك بدون استهلاك أي عمليات بحث:
$ gender-api-cli -stats
3. أتمتة باستخدام السكربتات
أنشئ سكربتات Bash قوية. مثلًا: اقرأ الأسماء من ملف نصّي، واستعلم من الـ API، ثم أضِف النتائج إلى ملف JSON منظّم ومناسب لإدخاله إلى ClaudeBot أو ChatGPT.
#!/bin/bash
while read name; do
gender-api-cli -first_name "$name" -out=json >> enriched_data.json
done < names.txt
الأسئلة الشائعة
هل عميل سطر الأوامر (CLI) مفتوح المصدر؟
نعم، أداة سطر الأوامر (CLI) مفتوحة المصدر بالكامل. تقدر تراجع الكود، وتقترح تحسينات، أو تبنيها من المصدر مباشرة عبر مستودعنا على GitHub.
هل يدعم المعالجة بالجملة؟
حاليًا، واجهة سطر الأوامر (CLI) تدعم إرسال طلب واحد للـ API في كل مرة، لكنها مصممة لتكون سريعة جدًا. إذا عندك آلاف الصفوف، تقدر بكل سهولة تستخدم xargs أو حلقة bash. أمّا للبيانات الضخمة اللي فيها ملايين الأسطر، فننصحك باستخدام ميزة رفع CSV/Excel من لوحة التحكم (Dashboard).
هل أقدر أطلع JSON خام؟
نعم! تقدر تمرّر الخيار "-out=json" عشان يرجّع استجابة JSON الخام بدون تنسيق مباشرةً إلى المخرجات القياسية (standard output)، وهذا يخليه مثالي لسلاسل المعالجة باستخدام jq.
هل يعرض macOS رسالة: "تعذّر على Apple التحقق من خلوّه من البرامج الضارة"؟
بما إن أداة سطر الأوامر (CLI) يتم تنزيلها كملف تنفيذي مباشر بدل التثبيت من متجر التطبيقات، فإن ميزة Gatekeeper في macOS تحميها تلقائيًا. للسماح بتشغيلها، افتح تطبيق Terminal وأزِل علامة العزل (quarantine) باستخدام:
xattr -d com.apple.quarantine /path/to/downloaded/executable
هل لديك أي أسئلة؟
