عميل سطر الأوامر

1. قم بضبط مفتاح API الخاص بك

لتوثيق طلباتك بأمان دون تسجيل المفاتيح في سجل أوامر bash، يمكنك إما تصديره كمتغيّر بيئة أو حفظه في ملف إعدادات.

الخيار 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