إعداد سكربت جمع المستخدمين

يصدر scrape_users أسماء المستخدمين من المتابعين أو الحسابات المتابَعة أو نتائج البحث عبر واجهة جهاز Android حقيقي. يدعم إصدار Pro منصات TikTok وInstagram وThreads.

script_config

المعامل	النوع	مطلوب	الافتراضي	الوصف
mode	string	لا	followers	followers أو following أو keyword
target_username	string	مشروط	""	الحساب الذي ستُفتح قائمته
search_keyword	string	مشروط	""	عبارة البحث في وضع keyword
max_scrape_count	integer	لا	50	الحد الأقصى للأسماء الجديدة (1–10,000)

يلزم target_username في followers/following، وsearch_keyword في keyword.

مثال API لـ Threads

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "scrape_users",
    "platform": "threads",
    "script_config": {
      "mode": "followers",
      "target_username": "@creator",
      "max_scrape_count": 50
    }
  }'

تُحفظ الأسماء، اسم واحد في كل سطر، تحت <work_dir>/download/ بأسماء <target>_followers.txt أو <target>_following.txt أو <keyword>.txt. تضيف عمليات التشغيل اللاحقة إلى الملف نفسه، ويتوقف السكربت عند بلوغ الحد أو عدم ظهور صفوف جديدة.

رموز الخطأ

الرمز	الوصف
40001	الحساب أو البحث المطلوب للوضع غير موجود
40003	السكربت غير مدعوم في الإصدار أو المنصة المحددة
40301	يتطلب API خطة Pro أو أعلى

انظر أيضاً

• واجهة إدارة المهام
• دليل جمع المستخدمين
• نظرة عامة على Local API