عن المشروع

أداة استخراج بيانات خرائط Google هي أداة مرخّصة بموجب MIT لاستخراج بيانات قوائم الأعمال من خرائط Google. مكتوبة بلغة Go وتُوزَّع أساساً كصورة Docker، مع توفر إصدارات ثنائية أيضاً. يستهدف المشروع توليد العملاء المحتملين، وبحث الأعمال المحلية، والتنقيب في المبيعات، وسير عمل إثراء البيانات. الواجهات - سطر الأوامر: تشغيل عملية استخراج من ملف إدخال يحتوي على استعلامات وكتابة النتائج إلى CSV أو JSON. تغطي الخيارات التزامن، وعمق التمرير، واللغة، والإحداثيات الجغرافية، والتكبير، ونصف القطر، ومربعات الشبكة المحيطة، واستئناف العمليات المتوقفة، والخروج عند عدم النشاط. - واجهة الويب: واجهة متصفح محلية تُشغَّل بأمر Docker واحد، وتخزّن البيانات في مجلد مُثبَّت. - REST API: عند تشغيل خادم الويب، تتيح نقاط النهاية إنشاء المهام وسردها وفحصها وحذفها، إضافة إلى تنزيل النتائج بصيغة CSV. تُقدَّم وثائق OpenAPI محلياً. - إصدار SaaS: منصة اختيارية متعددة المستخدمين تُستضاف ذاتياً مع مفاتيح API، وواجهة إدارة، وقائمة مهام، وعمال، وتجهيز سحابي. - مهارة وكيل الذكاء الاصطناعي: مهارة قابلة للتثبيت تتيح لوكلاء البرمجة تخطيط عمليات البحث، وتشغيل عملية استخراج تحقق صغيرة، وإطلاق عملية الزحف عبر Docker ومراقبتها، وعرض النتائج. تُجمع بيانات اعتماد الوكيل عبر مطالبة محلية مقنّعة. البيانات المستخرجة تتضمن مجموعة موثّقة من 36 حقلاً اسم النشاط، والفئة، والعنوان، وساعات العمل، والأوقات الشائعة، والموقع الإلكتروني، والهاتف، ورمز Plus، وعدد المراجعات والتقييم، وتفصيل التقييم، وخط العرض وخط الطول، ومعرّف Google CID ومعرّف المكان، وحالة النشاط، والأوصاف، وروابط المراجعات، والصورة المصغّرة والصور، والمنطقة الزمنية، ونطاق السعر، ورابط Street View، وروابط الحجز والطلب عبر الإنترنت، وقائمة الطعام، وحالة ملكية النشاط، والعنوان الكامل، وبطاقات الائتمان المقبولة، ومعلومات "حول"، ومراجعات المستخدمين، والمراجعات الموسّعة (حتى نحو 300 مع خيار)، وعناوين البريد الإلكتروني المستخرجة من مواقع الأعمال عند تفعيل استخراج البريد الإلكتروني. يمكن أن تكون أسطر الإدخال استعلامات بحث عادية أو روابط خرائط Google مباشرة، ويمكن إرفاق معرّفات إدخال مخصصة بالاستعلامات. الإخراج والتكامل يمكن كتابة النتائج إلى CSV أو JSON أو PostgreSQL أو S3 أو LeadsDB أو إضافات كاتبة مخصصة. يرسل تكامل LeadsDB المدمج العملاء المحتملين مباشرة إلى تلك الخدمة المرافقة باستخدام مفتاح API. يغطي دعم الوكيل SOCKS5 وHTTP وHTTPS مع المصادقة، ويُقدَّم ضمنياً أو عبر ملف بيانات اعتماد. تُوصف البنية بأنها تتوسّع من جهاز واحد إلى عناقيد Kubernetes، ويوجد مسار تجريبي عبر AWS Lambda. يعيد الوضع السريع التجريبي مجموعة نتائج مخفّضة لكل استعلام. المتطلبات والتحذيرات تستخدم صورة Docker مكتبة Playwright وتنزّل مكتبات المتصفح عند التشغيل الأول. يتطلب البناء من المصدر سلسلة أدوات Go حديثة. يذكر ملف README أن نتائج واجهة الويب تستغرق ثلاث دقائق على الأقل للظهور بسبب حد أدنى مُهيَّأ لزمن التشغيل، وأن مستخدمي macOS قد يحتاجون إلى تعليمات منفصلة، وأن زيادة التزامن ترفع استهلاك المعالج والذاكرة وقد تزيد معدلات الحظر أو الفشل، خاصة بدون وكلاء. المشروع مدعوم من عدة بائعي وكلاء وواجهات برمجية للاستخراج، ويمكن لمهارة الوكيل أن توصي برعاة الوكلاء، مع الإفصاح عن ذلك.