# FlashData مقابل Serper.dev: Google بحث API مقارنة

قارن استخدام حزمة Serper.dev مع تسعير FlashData، واحتفظ بمخرجات أداة الوكيل الخاصة بك، وقم ببناء سير العمل باستخدام Google البحث، YouTube التسميات التوضيحية وتسليم الوسائط.

Serper.dev حقائق تمت مراجعتها: 2026-11-10. تستخدم أسعار FlashData وبدلات التجربة كتالوجاتها العامة الحالية.

- [الميزات](#features)
- [لماذا التبديل؟](#overview)
- [حزم وإنفاق](#costs)
- [الأداة الموجودة لديك](#compatibility)
- [تبديل المكالمة](#migration)
- [أبعد من البحث](#workflows)
- [طرح الوكيل](#agents)
- [الأسئلة الشائعة](#faq)

<a id="features"></a>
## مقارنة الميزات

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

### ابدأ بالتزام أصغر

| ميزة | FlashData | Serper.dev |
| --- | --- | --- |
| الحد الأدنى لشراء الائتمان | $10 — $1.00 / 1,000 · ادفع حسب الاستخدام | $50.00 — $1.00 / 1,000 · Starter |
| بدل البحث عن حساب جديد | ما يصل إلى 2,000 عمليات البحث — بدل الاشتراك لمرة واحدة | 2,500 استفسار مجاني — عرض الاشتراك |
| تجربة الوكيل قبل تسجيل المالك | نعم — ما يصل إلى 50 Google عمليات البحث · 72 ساعة | سجل واستخدم حساب API مفتاح |

### حافظ على سلوك أداة البحث الخاصة بك

| ميزة | FlashData | Serper.dev |
| --- | --- | --- |
| الويب والصور والأخبار والتسوق ومقاطع الفيديو والأماكن | نعم — ستة Google مصادر | نعم — المقابلة Google نقاط النهاية |
| استهداف الدولة واللغة والاستهداف المحلي | GL، HL والموقع — داخل المعلمات | GL، HL والموقع — حقول الطلب ذات المستوى الأعلى |
| مرشحات التاريخ للأخبار والأبحاث | نعم — params.tbs · مثلا qdr:w | نعم — السل · على سبيل المثال QDR:W |
| الصفحة التالية وعدد النتائج المطلوبة | params.page و params.num — رقم الصفحة يبدأ بـ 1 | الصفحة والرقم — رقم الصفحة يبدأ بـ 1 |
| العناوين والمصدر URLs والمقتطفات | مصفوفة النتائج العضوية — العنوان والرابط والمقتطف والموضع | مصفوفة النتائج العضوية — العنوان والرابط والمقتطف والموضع |
| الأسئلة والأجوبة وسياق الكيان | نعم — يسأل الأشخاص أيضًا ومربع الإجابة والرسم البياني المعرفي عند إرجاعهم | نعم — يسأل الأشخاص أيضًا ومربع الإجابة والرسم البياني المعرفي عند إرجاعهم |

### أدوات للوكلاء والعمل في الخلفية

| ميزة | FlashData | Serper.dev |
| --- | --- | --- |
| مستقل رسمي CLI | نعم — Linux، macOS و Windows · لا يوجد وقت تشغيل للتثبيت | غير مذكور — في كتالوج المنتجات العامة |
| Markdown نتائج البحث من API | نعم — اختر محتوى JSON أو Markdown | JSON نتائج البحث |
| async وظيفة مستمرة يمكنك استئنافها بواسطة ID | نعم — أرسل، احفظ ID، استرجعه لاحقًا | غير مذكور — يؤدي تدفق البحث المنشور إلى إرجاع realtime نتيجة |
| Google استفسار في إرسال JSON واحد | 100 على الدفع كما تذهب — Persisted Batch · up to 500 by خطة | ما يصل إلى 100 الاستعلامات — Mini-batch يُرجع الإجابات معًا |
| عمليات الاسترجاعات الانتهاء لوظائف الخلفية | نعم — callback_url على كل async أو استعلام دفعة | غير مذكور — في تدفق البحث المنشور |
| الربط بالمالك وتسليم بيانات الاعتماد | نعم — المطالبة مرة واحدة؛ إعادة استخدام ملف التعريف CLI المحفوظ | تكوين حساب API مفتاح |

### متابعة من البحث إلى YouTube

| ميزة | FlashData | Serper.dev |
| --- | --- | --- |
| ابحث عن البيانات الوصفية بواسطة YouTube فيديو ID | نعم — مخصص YouTube البيانات الوصفية API | غير مذكور — Google البحث عن الفيديو متاح |
| الطابع الزمني YouTube التسميات التوضيحية | نعم — نص التسمية التوضيحية وتوقيت أدلة الفيديو | غير مذكور — في كتالوج المنتجات العامة |
| YouTube تسليم الفيديو / الصوت إلى التخزين الخاص بك | نعم — YouTube تحميل API | غير مذكور — في كتالوج المنتجات العامة |

يستخدم الشراء المبدئي FlashData ادفع حسب الاستخدام وSerper Starter. تحتوي العبوات الأكبر حجمًا Serper على معدلات وحدات أقل؛ قارنها في الآلة الحاسبة. تجربة الوكيل منفصلة عن عروض الاشتراك وتخضع للأهلية. غير مدرج يشير إلى كتالوج المنتجات العامة لـ Serper؛ قد تكون هناك تكاملات مجتمعية.

<a id="overview"></a>
## ما الذي يجعل التبديل جديرًا بالاهتمام؟

انقل الجزء الذي يحتاج إلى التغيير من عبء عملك. Google يمكن أن يتحرك البحث العضوي بشكل مستقل عن أنواع البحث المتخصصة.

### حجم البحث الخاص بك غير متساو

يساعد معدل الحزمة المنخفض عند استخدام الاستعلامات. قارن بين الشراء مقدمًا والاستخدام لمدة ستة أشهر مع خيار الدفع عند الاستخدام الخاص بـ FlashData.

[التحقق من استخدام الحزمة](#costs)

### وكيلك يحتاج إلى أدلة من الفيديو

نتيجة فيديو Google تحصل على URL. FlashData يمكن أن يستمر مع YouTube البيانات الوصفية والتسميات التوضيحية ذات الطوابع الزمنية والتسليم إلى مساحة التخزين الخاصة بك.

[شاهد المهام كاملة](#workflows)

### أداة البحث الخاصة بك هي جزء من نظام أكبر

احتفظ بإدخال أداة الوكيل وتنسيق الاقتباس أثناء نقل مكالمة المزود. قم بإضافة المهام المستمرة عندما يجب استئناف العمل بعد إنهاء العملية.

[تحقق من التكامل الخاص بك](#compatibility)

<a id="costs"></a>
## سعر الوحدة والشراء مقدما

حزم Serper هي مشتريات مدفوعة مسبقًا، وليست اشتراكات أو عبوات استعلام شهرية. جميع الباقات المدرجة لها صلاحية ائتمانية لمدة ستة أشهر. FlashData يقدم أرصدة مشتركة مدفوعة مسبقًا وخطط شهرية اختيارية.

### FlashData Google خطط البحث

| خطة | لكل 1,000 طلبات | الرسوم الشهرية | الاعتمادات المدرجة | Google طلبات البحث |
| --- | --- | --- | --- | --- |
| الدفع حسب الاستخدام | $1.00 | $0 · بدون رسوم شهرية | لا شيء | اشحن رصيدك حسب الحاجة |
| Micro | $0.80 | $49.00 | 1,000 ($50.00 من الاستخدام) | ≈ 62,500 |
| Starter | $0.65 | $199.00 | 4,000 ($200.00 من الاستخدام) | ≈ 307,692 |
| Pro | $0.60 | $499.00 | 10,000 ($500.00 من الاستخدام) | ≈ 833,333 |
| Scale | $0.50 | $999.00 | 20,000 ($1,000.00 من الاستخدام) | ≈ 2,000,000 |
| Business | $0.40 | $1,999.00 | 40,000 ($2,000.00 من الاستخدام) | ≈ 5,000,000 |

يتم تجديد الاعتمادات المضمنة في كل فترة زمنية للفوترة. تفترض مخصصات الطلب أن الرصيد المشترك الكامل يذهب إلى Google بحث.

### Serper.dev باقة مسبقة الدفع

| باقة الدفع المسبق | لكل 1,000 استفسار | شراء الحزمة | الاستعلامات لكل حزمة | الرسوم الشهرية | الاستعلامات/الثانية |
| --- | --- | --- | --- | --- | --- |
| Starter | $1.00 | $50.00 | 50,000 | $0 | 50 |
| قياسي | $0.75 | $375.00 | 500,000 | $0 | 100 |
| Scale | $0.50 | $1,250.00 | 2,500,000 | $0 | 200 |
| Ultimate | $0.30 | $3,750.00 | 12,500,000 | $0 | 300 |

### مثال على عبء العمل: FlashData ادفع حسب الاستخدام و Serper Starter

حدد كل مزود بشكل مستقل. التكلفة الشهرية لـ FlashData هي رسومها الشهرية بالإضافة إلى استخدام البحث أعلى من قيمة الائتمان المضمنة. تفترض الطلبات المضمنة أن جميع الاعتمادات المشتركة تذهب إلى Google بحث. التكلفة الشهرية الأقل نموذجية تحدد خطة FlashData مع أصغر إجمالي في الحجم الخاص بك. التكلفة الشهرية الفعالة لكل 1,000 هي هذا الإجمالي مقسومًا على عمليات البحث الشهرية المُدخلة، مضروبًا في 1,000. سعر وحدة Serper هو شراء الحزمة مقسومًا على عدد الاستعلامات مضروبًا في 1,000. تظهر قيمة الاستخدام الاعتمادات المستهلكة؛ إنها ليست رسوم اشتراك شهرية. بدءًا من عدم وجود أرصدة Serper، يصل تقدير الشراء إلى حزم كاملة بالسعر المحدد؛ تبقى الاستعلامات غير المستخدمة في الحزم المشتراة، والتي تنتهي صلاحيتها بعد ستة أشهر. تفترض توقعات الحزمة الأولى شراء حزمة واحدة الآن وبنفس الحجم الشهري لمدة ستة أشهر: الاستعلامات المستخدمة = الحد الأدنى (حجم الحزمة، الحجم الشهري × 6)؛ التكلفة الفعلية لكل 1,000 = سعر العبوة ÷ الاستعلامات المستخدمة × 1,000. مشتريات الحزمة اللاحقة خارج هذا التوقع. عند عدم إجراء أية عمليات بحث، لا يلزم شراء الحزمة وتكون التكلفة الفعلية غير محددة. FlashData تبدأ عمليات تعبئة الخدمة الذاتية عند $10 وقد تترك رصيدًا دائنًا. يتم استبعاد الاعتمادات التجريبية والأرصدة الحالية والضرائب وغيرها من استخدامات API.

| عمليات البحث / الشهر | FlashData التكلفة الشهرية النموذجية | Serper قيمة الاستخدام | Serper شراء العبوة كاملة من الصفر | الأسئلة المتبقية بعد شهر |
| --- | --- | --- | --- | --- |
| 1,000 | $1.00 | $1.00 | $50.00 | 49,000 |
| 10,000 | $10.00 | $10.00 | $50.00 | 40,000 |
| 100,000 | $100.00 | $100.00 | $100.00 | 0 |
| 1,000,000 | $1,000.00 | $1,000.00 | $1,000.00 | 0 |

تستخدم هذه السيناريوهات معدل Serper Starter. يتطلب السعر الأقل من الحزمة الأكبر شراء حزمة أكبر. استخدم الآلة الحاسبة HTML لتحديد كل خطة بشكل مستقل.

### هل ستستخدم الحزمة قبل انتهاء صلاحيتها؟

لنفترض أن حزمة واحدة تم شراؤها الآن ونفس حجم البحث كل شهر لمدة ستة أشهر. الحد الأقصى للاستعلامات المستخدمة بحجم تلك الحزمة الأولى؛ مشتريات الحزمة اللاحقة خارج هذه التوقعات. اقسم سعر الحزمة الأولى على الاستعلامات المستخدمة للعثور على التكلفة الفعلية لكل 1,000.

| الحزمة الأولى | عمليات البحث / الشهر | شراء الحزمة | يستخدم خلال ستة أشهر | غير مستخدم عند انتهاء الصلاحية | التكلفة الفعالة / 1,000 مستعملة |
| --- | --- | --- | --- | --- | --- |
| Starter | 1,000 | $50.00 | 6,000 | 44,000 | $8.33 |
| قياسي | 1,000 | $375.00 | 6,000 | 494,000 | $62.50 |
| Starter | 10,000 | $50.00 | 50,000 | 0 | $1.00 |
| قياسي | 10,000 | $375.00 | 60,000 | 440,000 | $6.25 |

عند عدم إجراء أية عمليات بحث، لا تكون هناك حاجة إلى حزمة وتكون التكلفة الفعالة غير محددة. إذا تم استخدام الحزمة الأولى بالكامل، فإن تكلفتها الفعلية تساوي السعر المعلن عنه. للحصول على خطة شهرية FlashData، احسب (الرسوم الشهرية + الاستخدام فوق الاعتمادات المضمنة) ÷ عمليات البحث الشهرية × 1,000؛ لا يؤدي السعر المعلن عنه المنخفض إلى إزالة رسوم الاشتراك بكميات منخفضة.

[FlashData التسعير](https://flashdata.dev/ar/pricing/google-search) · [المقارنة التفاعلية](https://flashdata.dev/ar/compare/serper#costs)

### تجارب الاشتراك

يمكن لحسابات FlashData الجديدة المؤهلة تجربة ما يصل إلى 2,000 Google من عمليات البحث بعد الاشتراك والتحقق من البريد الإلكتروني، باستخدام رصيد النسخة التجريبية المشترك الكامل للبحث. لا توجد بطاقة مطلوبة.
Serper يقدم 2,500 استفسارات تجريبية مجانية، دون الحاجة إلى بطاقة. هذا ليس بدل شهري متكرر.

[FlashData تجربة الاشتراك](https://flashdata.dev/ar/products/google-search#trial-faq)

<a id="compatibility"></a>
## احتفظ بالعقد الذي يستخدمه وكيلك بالفعل

قد يؤدي التكامل Serper إلى إرجاع سلسلة أو قاموس أو مستندات تحتوي على روابط. حافظ على استقرار اسم الأداة ومخطط الإدخال، وقم بتكييف استجابة FlashData داخل الأداة.

| التكامل القائم | الإخراج الحالي | ما يجب الحفاظ عليه |
| --- | --- | --- |
| LangChain · GoogleSerperAPIWrapper | results() تُرجع قاموسًا؛ يقوم run() بدمج المقتطفات المحددة في سلسلة. | تحقق من الطريقة التي تستدعيها سلسلتك. يؤدي إرجاع مصفوفة حيث تتوقع الخطوة التالية النص إلى تغيير عقد الأداة. |
| CrewAI · SerperDevTool | يقبل search_query ويعيد النتائج المنظمة، بما في ذلك الكتل الاختيارية. | احتفظ بـ search_query كمدخل للأداة. قم بتخطيط الحقول التي يقرأها وكيلك؛ استبدال SERPER_API_KEY وحده لا يمكنه تبديل مقدمي الخدمة. |
| كومة قش · SerperDevWebSearch | إرجاع المستندات والروابط. تحتوي المستندات على مقتطفات بحث. | الحفاظ على كل من المخرجات والمصدر URLs. احتفظ بمكون جلب المحتوى المنفصل عندما يحتاج المسار الخاص بك إلى صفحات كاملة. |

[قم ببناء محول الأداة HTTP](https://flashdata.dev/ar/docs/guides/search-in-an-app/reference.md#tool)

### ما هي أنواع البحث التي يمكن نقلها؟

| مهمتك الحالية | قرار الهجرة | FlashData المصدر أو الخطوة التالية |
| --- | --- | --- |
| Google نتائج الويب | قم بترحيل استدعاء البحث العضوي وتطبيع مخرجاته. | google_search |
| الصور والأخبار والتسوق ومقاطع الفيديو والأماكن | قم بتعيين كل مهمة إلى المصدر والمحلل المخصص لها. | google_images, google_news, google_shopping, google_videos, google_places |
| الباحث العلمي، براءات الاختراع، الإكمال التلقائي | احتفظ بهذه المكالمات مع مزود الخدمة الحالي الخاص بك؛ FlashData ليس له ما يعادله مباشرة في كتالوجه الحالي. | لا يوجد معادل مباشر |
| النص الكامل من موقع مرتبط | احتفظ بخطوة جلب الصفحة واستخراجها بعد البحث. | مقتطف البحث ليس المقالة الكاملة |

### الطلب الدقيق ورسم الخرائط الاستجابة

| التغيير | Serper.dev | FlashData | مذكرة الهجرة |
| --- | --- | --- | --- |
| طلب بحث | POST /search | POST /v1/queries/realtime | استخدم FlashData مضيف البيانات والمصدر=google_search. |
| API مفتاح | X-API-KEY رأس | X-API-Key رأس | غلاف الرأس ليس هو الفرق. استخدم مفتاح FlashData بإذن google_search. |
| الاستعلام | q | query | إعادة تسمية حقل الطلب. |
| البلد، اللغة، العد | gl, hl, num | params.gl, params.hl, params.num | خيارات العش ضمن المعلمات؛ الحفاظ على قيمهم. |
| مرشح الموقع والوقت | الموقع، السل | params.location, params.tbs | حافظ على الاستهداف الذي تستخدمه مهمتك الحالية. |
| النتائج العضوية | عضوي[] | النتائج[0].عضوية[] | اقرأ غلاف الاستجابة FlashData بعد الحالة=done. |
| حقول المصدر | title, link, snippet, position | title, link, snippet, position | احتفظ بحقول الاقتباس الخاصة بتطبيقك؛ تطبيع الرابط إلى عنوان url إذا لزم الأمر. |
| الاستفسارات ذات الصلة | relatedSearches[] | النتائج[0].relatedSearches[] | تعامل مع هذا على أنه اختياري؛ تستهلك كل حقل استعلام عند وجوده. |
| الأسئلة ذات الصلة | peopleAlsoAsk[] | النتائج[0].peopleAlsoAsk[] | يمكن أن يصل السؤال بدون إجابة أو مقتطف أو URL. لا تفترض أن كل كائن يحتوي على دليل. |
| الإجابة وكتل الكيان | answerBox, knowledgeGraph | لا يوجد رسم خرائط مضمون من واحد لواحد | إذا كانت أداتك تتطلب هذه الكتل، فاحتفظ بهذا المسار حتى تحتوي الحقول المطلوبة على تعيين مدعوم. |
| الأخبار أو الصور أو الأماكن | نقطة نهاية مختلفة مثل /news | مصدر مخصص مثل google_news | حدد المصدر واستخدم المعلمات الخاصة به ومخطط النتائج. |

قم بتعيين الخيارات وكتل النتائج التي تستخدمها مهمتك فقط. السؤال الاختياري ذو الصلة لا يعد تلقائيًا سؤالاً تمت الإجابة عليه مع المصدر.

[FlashData Google مخطط البحث](https://flashdata.dev/ar/docs/sources/google_search/reference.md)

<a id="migration"></a>
## ترحيل البحث

1. قم بالتسجيل أو تسجيل الدخول إلى FlashData، وأكمل إعداد الحساب وأنشئ مفتاح API بإذن google_search. التحقق من الاعتمادات المتاحة. يمكن للوكيل إعادة استخدام وصوله المحفوظ أو استخدام التدفق التجريبي المؤهل أدناه.
2. اختر Python أو Bash. احفظ البرنامج النصي Python الكامل تحت اسم الملف المعروض في مجلد المهام الخاص بك قبل running. تقدم كل كتلة بحثًا واحدًا؛ running كلا الإصدارين يستعلمان عن كلا المزودين.
3. فحص السجلات التي تمت تسويتها. FlashData يتطلب الحالة=done قبل قراءة النتائج[0].عضوي. يمكن أن تكون النتائج العضوية الفارغة صالحة. احتفظ بالعنوان URL والمقتطف وموضع الاستشهادات.

[إعداد الحساب](https://flashdata.dev/signup) · [API مفاتيح](https://flashdata.dev/app/api-keys) · [الاعتمادات المتاحة](https://flashdata.dev/app/billing)

### Python

Python 3، المكتبة القياسية فقط. احفظ البرنامج النصي الكامل تحت اسم الملف الموضح في مجلد المهام الخاص بك، ثم قم بتشغيله. يقرأ متغير البيئة أو يطالب بشكل خاص بمفتاح. يقوم كل برنامج نصي بإجراء بحث واحد.

#### Serper.dev: serper-search.py

```python
import getpass, json, os
from urllib.request import Request, urlopen
from urllib.error import HTTPError, URLError

key = os.environ.get("SERPER_API_KEY")
if not key:
    key = getpass.getpass("Serper key: ")
payload = {"q": "openai", "gl": "us", "hl": "en", "num": 10}
request = Request("https://google.serper.dev/search",
    data=json.dumps(payload).encode(),
    headers={"X-API-KEY": key, "Content-Type": "application/json"})
try:
    with urlopen(request, timeout=120) as response:
        body = json.load(response)
except HTTPError as error:
    raise SystemExit(f"HTTP {error.code}; check access and request input.") from None
except (URLError, TimeoutError):
    raise SystemExit("No response; check state before retrying.") from None
if body.get("error"):
    raise SystemExit("Search failed; inspect its error before retrying.")
items = body.get("organic", [])
print(json.dumps([{
    "position": item.get("position"), "title": item.get("title"),
    "url": item.get("link"), "snippet": item.get("snippet")
} for item in items], ensure_ascii=False, indent=2))
```

تشغيل بعد الحفظ: `python3 serper-search.py`

#### FlashData: flashdata-search.py

```python
import getpass, json, os
from urllib.request import Request, urlopen
from urllib.error import HTTPError, URLError

key = os.environ.get("FLASHDATA_API_KEY")
if not key:
    key = getpass.getpass("FlashData key: ")
payload = {"source": "google_search", "query": "openai",
           "params": {"gl": "us", "hl": "en", "num": 10}}
request = Request("https://data.flashdata.dev/v1/queries/realtime",
    data=json.dumps(payload).encode(),
    headers={"X-API-Key": key, "Content-Type": "application/json"})
try:
    with urlopen(request, timeout=120) as response:
        body = json.load(response)
except HTTPError as error:
    raise SystemExit(f"HTTP {error.code}: check input and access.") from None
except (URLError, TimeoutError):
    raise SystemExit("No response; check state before retrying.") from None
if body.get("status") != "done":
    raise SystemExit("Search is not complete; check its status.")
items = (body.get("results") or [{}])[0].get("organic", [])
print(json.dumps([
    {"position": item.get("position"), "title": item.get("title"),
     "url": item.get("link"), "snippet": item.get("snippet")}
    for item in items
], indent=2, ensure_ascii=False))
```

تشغيل بعد الحفظ: `python3 flashdata-search.py`

### cURL / Bash

Bash، cURL 7.76+ و جق. قم بتشغيل أي كتلة كاملة في مجلد المهام الخاص بك. فهو يطالب فقط عندما يكون متغير بيئة الموفر مفقودًا، ويحفظ الاستجابة الأولية ويطبع النتائج الطبيعية. تقدم كل كتلة بحثًا واحدًا.

#### Serper.dev: Serper.dev · Bash

```bash
if [ -z "${SERPER_API_KEY:-}" ]; then
  read -r -s -p "Serper key: " SERPER_API_KEY
  printf '\n'
fi
curl --fail-with-body --silent --show-error --max-time 120 \
  'https://google.serper.dev/search' \
  --header "X-API-KEY: $SERPER_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"q":"openai","gl":"us","hl":"en","num":10}' \
  --output serper-result.json &&
jq 'if .error then error("Search failed; check the response") else
  [(.organic // [])[] | {position, title, url: .link, snippet}]
  end' serper-result.json
```

#### FlashData: FlashData · Bash

```bash
if [ -z "${FLASHDATA_API_KEY:-}" ]; then
  read -r -s -p "FlashData key: " FLASHDATA_API_KEY
  printf '\n'
fi
curl --fail-with-body --silent --show-error --max-time 120 \
  'https://data.flashdata.dev/v1/queries/realtime' \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"source":"google_search","query":"openai",
           "params":{"gl":"us","hl":"en","num":10}}' \
  --output flashdata-result.json &&
jq 'if .status == "done" then
  [(.results[0].organic // [])[] | {position, title, url: .link, snippet}]
  else error("Search not complete; check status before retrying") end' flashdata-result.json
```

### تطبيع شكل الإخراج

إخراج توضيحي؛ الأمثلة تعيد تسمية الرابط إلى url.

```json
[
  {
    "position": 1,
    "title": "OpenAI | Research & Deployment",
    "url": "https://openai.com/",
    "snippet": "..."
  }
]
```

### قبل تغيير أداة الإنتاج الخاصة بك

| القضية | ما يجب التحقق منه |
| --- | --- |
| عمليات البحث التمثيلية | استخدم بلدك الحالي ولغتك وموقعك. التحقق من الحقول المطلوبة والاستشهادات القابلة للاستخدام؛ لا تقارن التصنيف المباشر بالبايت. |
| نتائج فارغة أو جزئية | القائمة العضوية الفارغة صالحة. يجب ألا تصبح الكتل الاختيارية المفقودة إجابات مخترعة أو أدلة غير مستشهد بها. |
| فشل الوصول والائتمان | أخطاء المصادقة السطحية والأذونات والتوازن. يجب ألا يبدو الخطأ وكأنه بحث ناجح بدون أي تطابقات. |
| حدود المعدل أو الاستجابة المفقودة | استخدم عمليات إعادة المحاولة المحددة لحد معدل واضح. فحص حالة المهمة المحفوظة بعد انتهاء المهلة؛ تجنب إطلاق مزود ثانٍ تلقائيًا لطلب غير مؤكد. |

ابدأ بسير عمل واحد. احتفظ بتكوين الموفر الحالي متاحًا للتراجع المتعمد؛ يؤدي إرسال كل طلب إلى كلا المزودين إلى إضافة بحث آخر قابل للفوترة.

### العمل في الخلفية والانتعاش

يعالج الغلاف async Python المنتظر داخل تلك العملية. بالنسبة للعمل الذي يجب أن يستمر بعد إعادة التشغيل، أرسل وظيفة FlashData async مستمرة، واحفظ ID الخاص بها واسترجع تلك الوظيفة لاحقًا. مجموعات الدفعات الاستعلامات المعروفة؛ يعالج ملفًا بشكل مجمع.

[الوقت الحقيقي و async](https://flashdata.dev/ar/docs/reference/realtime-and-async/reference.md) · [دفعة وسائبة](https://flashdata.dev/ar/docs/reference/batch-and-bulk/reference.md) · [أخطاء](https://flashdata.dev/ar/docs/errors/reference.md)

<a id="workflows"></a>
## ماذا يحدث بعد أن يجد وكيلك الرابط؟

Google البحث، YouTube البيانات و YouTube تنزيل مشاركة رصيد حساب واحد، بمعدلات وأذونات منفصلة.

### قم ببناء ملخص بحثي باستخدام أدلة الفيديو

ابدأ بـ: شركة أو منتج أو سؤال بحثي.

1. Google البحث: اكتشف المصادر
2. YouTube البحث: ابحث عن مقاطع الفيديو ذات الصلة
3. البيانات الوصفية + التسميات التوضيحية: جمع الأدلة ذات الطابع الزمني

احصل على: موجز مع روابط المصدر والطوابع الزمنية للفيديو.

احتفظ باستخراج صفحة الويب للمقالات الكاملة. إذا لم يكن الفيديو يحتوي على تسميات توضيحية، فقم بتسجيل تلك الفجوة بدلاً من التعامل مع العنوان كنص.

[بناء سير العمل البحثي](https://flashdata.dev/ar/docs/guides/google-youtube-research/reference.md)

### تسليم الفيديو المحدد إلى التخزين الخاص بك

ابدأ بـ: فيديو YouTube يختاره تطبيقك.

1. البيانات الوصفية: تأكيد الفيديو المحدد
2. تحميل: تقديم مهمة التسليم
3. التخزين: احتفظ بتفاصيل الكائن الذي تم تسليمه

احصل على: الفيديو أو الصوت في وحدة التخزين التي تم تكوينها، ready للمهمة التالية.

استخدم وصول المالك بإذن youtube_download. لا يتضمن الوصول التجريبي للوكيل المؤقت التنزيل. يستخدم التسليم التسعير الخاص به على أساس البايت.

[بناء خط أنابيب التسليم](https://flashdata.dev/ar/docs/guides/media-delivery-pipeline/reference.md)

### إثراء ملف الفيديو المعروف IDs

ابدأ بـ: قائمة موجودة من YouTube فيديو IDs.

1. تحضير ملف نصي بفيديو واحد ID لكل سطر
2. بالجملة: قدم مرة واحدة واحفظ الوظيفة ID
3. النتائج: استرجاع المخرجات وفحص failed عنصر

احصل على: مجموعة بيانات يمكن لتطبيقك الانضمام إليها مرة أخرى IDs الأصلية.

تخطي Google البحث عندما تعرف IDs بالفعل. استمر في المهمة ID حتى تستأنف العملية المعاد تشغيلها العمل الحالي.

[معالجة ملف بكميات كبيرة](https://flashdata.dev/ar/docs/guides/bulk/reference.md)

<a id="agents"></a>
## قم بتحريك أداة واحدة قبل تحريك العامل بأكمله

أعد استخدام بيانات الاعتماد المحفوظة أولاً. استخدم CLI للمهام الطرفية أو مضيف قادر على MCP لاستدعاءات الأداة. مع عدم وجود وصول موجود، اقرأ auth.md وكتالوج الأذونات قبل بدء هوية مؤقتة مؤهلة.

تجربة الوكيل الحالية: 1 رصيد (أرصدة)، حتى 50 Google عمليات بحث، 72 ساعات. هذا بدل ابتدائي يخضع لقيود التسجيل والأهلية.

### موجه الهجرة

```text
Read https://flashdata.dev/compare/serper/reference.md and https://flashdata.dev/auth.md.
Inspect my Serper tool, including its input, country/language filters, output type and consumed fields.
Report unsupported search types or required answer/entity blocks before changing the integration.
Migrate one supported Google organic-search task; retain specialized calls and existing credentials.
Preserve the tool name, input schema, text-or-record output and source URLs.
Reuse existing FlashData access; otherwise check eligibility before starting one trial.
Keep keys in the host secret store, outside chat and source control.
Check normal, empty, missing-optional-field and error responses with local fixtures.
Run one search for "openai" with gl=us, hl=en and num=10; save the result and usage.
Do not automatically call both providers or retry an uncertain submission.
Do not buy credits. For recurring use, ask the owner to claim and approve access.
Reuse the same profile and state directory. Stop on revocation or insufficient credits.
```

### CLI: الملف الشخصي الافتراضي الموجود

أكمل [CLI التثبيت والتوثيق](https://flashdata.dev/ar/docs/guides/flashdata-cli/reference.md) أولاً. تقوم هذه الأوامر بفحص الوصول والتحقق من صحة الطلب وإرسال بحث واحد:

```bash
flashdata auth status --json --non-interactive &&
flashdata search "openai" --gl us --hl en --num 10 \
  --dry-run --json --non-interactive &&
flashdata search "openai" --gl us --hl en --num 10 \
  --run-id serper-migration-first --json --non-interactive
```

للمطالبة، يقوم المالك بتسجيل الدخول أو الاشتراك والتحقق من البريد الإلكتروني والموافقة على أذونات المصدر واستخدام الرصيد المشترك. احتفظ بالملف الشخصي الأصلي لتسليم بيانات الاعتماد. لا يتم نقل الاعتمادات المؤقتة غير المستخدمة. يستخدم الوصول المطالب به رصيد المالك؛ المطالبة لا تؤدي إلى شراء أرصدة أو إنشاء حد أقصى للإنفاق لكل مفتاح.

بالنسبة للمهام المتكررة، احتفظ ببيانات اعتماد المالك المحفوظة ودليل الحالة المستمرة. استخدم تشغيلًا واحدًا ID لكل حدث مجدول ونفس ID عند استرداد هذا التكرار. يمكن لـ CLI إعادة استخدام نتيجة completed فقط بينما تظل حالتها المحفوظة متاحة. تحتاج أداة HTTP إلى حالتها المستمرة الخاصة بها؛ CLI المدى ID ليس API رأس العجز. توقف عند إبطال الوصول أو عدم كفاية الاعتمادات. لا تقم بتسجيل التجارب البديلة أو شراء الاعتمادات تلقائيًا.

[وصول الوكيل](https://flashdata.dev/auth.md) · [المطالبة](https://flashdata.dev/ar/docs/guides/agent-onboarding/reference.md) · [Codex](https://flashdata.dev/ar/docs/integrations/codex/reference.md) · [OpenClaw](https://flashdata.dev/ar/docs/integrations/openclaw/reference.md) · [المهام المتكررة](https://flashdata.dev/ar/docs/guides/recurring-tasks/reference.md)

<a id="faq"></a>
## الأسئلة الشائعة

### لقد اشتريت بالفعل حزمة Serper. هل يجب علي نقل كل شيء؟

لا، انقل مهمة واحدة مدعومة أولاً واحتفظ بالمكالمات الأخرى أثناء استخدام الحزمة الموجودة لديك. لا يتم تحويل Serper رصيد إلى FlashData. احتفظ ببيانات اعتماد منفصلة للموفر وقم بتوجيه كل مهمة بشكل متعمد.

### ما هو السعر الذي ينبغي علي مقارنته: سعر الحزمة أم تكلفة الاستعلامات التي أستخدمها؟

استخدم كليهما. يفترض سعر العبوة أنك تستهلك العبوة بأكملها؛ توضح توقعات الاستخدام ما يحدث إذا لم تقم بذلك. للحصول على اشتراك بقيمة FlashData، قارن الرسوم الشهرية والاستخدام المضمن بالحجم الفعلي لديك، وليس فقط معدل الوحدة الأقل.

### هل سيؤدي تغيير SERPER_API_KEY إلى تبديل أداة الوكيل الحالية الخاصة بي؟

لا، لا تزال الأداة الخاصة بـ Serper تستدعي نقطة نهاية Serper وتقوم بتحليل استجابتها. استبدل استدعاء الموفر، واستخدم المفتاح FlashData، وقم بتكييف الاستجابة مع نفس مخرجات الأداة. يعتبر اتصال MCP خيار تكامل منفصل، وليس قيمة بديلة لمتغير البيئة هذا.

### هل ستكون كل نتيجة وكتلة بحث غنية متطابقة؟

يمكن أن تختلف النتائج المباشرة من حيث الترتيب والمحتوى. قم بترحيل الحقول التي يستهلكها تطبيقك فعليًا. العنوان العضوي، URL، المقتطف والموضع لديهم خريطة واضحة؛ تحتاج الإجابات الاختيارية وكتل الكيانات إلى تعيينها الخاص قبل تبديل هذا المسار.

### هل تمنحني طريقة async Python وظيفة قابلة للاستئناف؟

تتيح طريقة العميل async لعمليتك القيام بأعمال أخرى أثناء انتظار الرد. وظيفة FlashData async مستمرة بها وظيفة ID يمكنك حفظها واسترجاعها لاحقًا. استخدم الأخير عندما يجب أن يستمر العمل بعد إعادة تشغيل العملية، واحتفظ بذلك ID قبل جدولة إرسال آخر.

### هل يعني وجود رصيد واحد نفس السعر للبحث والتسميات التوضيحية والتنزيلات؟

لا، تتشارك المنتجات في الأرصدة ولكن لها أسعار ووحدات فوترة وأذونات منفصلة. يتم احتساب بحث بقيمة Google كطلب بحث؛ يستخدم تسليم الوسائط التسعير القائم على البايت. قم بالموافقة على أذونات المالك المطلوبة قبل إضافة منتج جديد إلى سير عمل متكرر.

### متى يكون الإحتفاظ بـ Serper هو الاختيار الأبسط؟

عندما تقوم أداتك الحالية بالمهمة بأكملها بالفعل، فإنك تستخدم الحزمة المدفوعة مسبقًا خلال صلاحيتها، أو تعتمد على الباحث العلمي أو براءات الاختراع أو الإكمال التلقائي أو الحقول الخاصة بموفر الخدمة دون ما يعادل FlashData. يمكنك الاحتفاظ بهذه المكالمات واستخدام FlashData لسير العمل الإضافي الذي تحتاجه.

[HTML المقارنة](https://flashdata.dev/ar/compare/serper)
