5 دقائق لتهيئة Brave Search API لمنح Clawdbot قدرات البحث عبر الإنترنت في الوقت الفعلي

هل ترغب في منح مساعدك الشخصي للذكاء الاصطناعي Clawdbot قدرة البحث المباشر عبر الإنترنت؟ يُعد تهيئة Brave Search API هو الخيار الأكثر ترشيحاً حالياً. سيرشدك هذا المقال خطوة بخطوة لإتمام العملية بالكامل، بدءاً من تقديم طلب الحصول على مفتاح API وصولاً إلى تهيئة Clawdbot.

القيمة الجوهرية: بعد قراءة هذا المقال، ستتعلم كيفية تهيئة Brave Search API لـ Clawdbot، مما يتيح لمساعدك الذكي البحث في الإنترنت بالوقت الفعلي للحصول على أحدث المعلومات، وتجاوز قيود تاريخ انقطاع المعرفة (Knowledge Cutoff).

---

ما هي Brave Search API

تُعد واجهة برمجة تطبيقات Brave Search API واجهة بحث على الويب على مستوى المؤسسات تقدمها شركة Brave، وهي تعتمد على فهرس بحث تم بناؤه بشكل مستقل، ويغطي أكثر من 35 مليار صفحة ويب.

الميزات الجوهرية لـ Brave Search API

الخاصية	الوصف	القيمة للمطورين
فهرس مستقل	لا تعتمد على Google أو Bing	نتائج أكثر تنوعاً
تحديث فوري	تحديث أكثر من 100 مليون صفحة يومياً	الحصول على أحدث المعلومات
خالية من الإعلانات	نتائج API نقية وبدون إعلانات	جاهزة للاستخدام المباشر في تطبيقات الذكاء الاصطناعي
الخصوصية أولاً	لا تتبع سلوك المستخدم	متوافقة مع متطلبات الامتثال للخصوصية
دعم نقاط نهاية متعددة	الويب/الأخبار/الصور/الفيديو	تلبية مختلف سيناريوهات البحث

لماذا تُعد Brave Search API مناسبة لتطبيقات الذكاء الاصطناعي

في ظل إغلاق Google لواجهة Search API، وقيام Bing برفع الأسعار بشكل كبير ثم إيقاف خدمة API نهائياً، أصبحت Brave Search API حالياً الخيار الوحيد المستقل والعملي تجارياً للبحث الشامل على الويب.

محرك البحث	حالة الـ API	مناسب لتطبيقات الذكاء الاصطناعي
Google	لا يوفر API بحث عام	لا
Bing	توقفت خدمة API في 2024	لا
Brave Search	يوفر API بنشاط	نعم
DuckDuckGo	لا يوجد API رسمي	لا

🎯 توضيح تقني: أصبحت Brave Search API الأداة المفضلة لتطبيقات الذكاء الاصطناعي مثل Claude MCP وأنابيب RAG. من خلال منصة APIYI (apiyi.com)، يمكنك الوصول بسرعة إلى مجموعة متنوعة من أدوات API بما في ذلك Brave Search.

---

تفاصيل خطط تسعير Brave Search API

توفر Brave Search API مستويات متعددة من التسعير، بدءاً من الخطة المجانية وصولاً إلى مستوى المؤسسات، لتلبية الاحتياجات بمختلف أحجامها.

الخطة المجانية لـ Brave Search API

تُعد الخطة المجانية مثالية للمستخدمين الأفراد والمشاريع الصغيرة:

البند	الحصة المجانية
حجم الطلبات الشهري	2,000 طلب
حد طلبات الثانية (QPS)	طلب واحد/ثانية
نقاط النهاية المدعومة	Web Search
سيناريو الاستخدام	المشاريع الشخصية، الاختبار والتطوير

مقارنة الخطط المدفوعة لـ Brave Search API

الخطة	السعر	QPS	الطلبات الشهرية	الميزات المميزة
Free	$0	1	2,000	بحث الويب الأساسي
Base	$3 لكل 1000 طلب	20	20 مليون	Goggles، الأخبار، الفيديو
Base AI	$5 لكل 1000 طلب	20	20 مليون	ترخيص تطبيقات الذكاء الاصطناعي
Pro AI	$9 لكل 1000 طلب	50	غير محدود	ميزات كاملة، دعم ذو أولوية
AI Grounding	$4/1000 طلب + $5/مليون توكن	–	–	بحث متعدد الجولات، تخطيط الاستدلال

💡 نصيحة لتحسين التكلفة: بالنسبة لسيناريوهات الاستخدام الشخصي لـ Clawdbot، عادةً ما تكون الـ 2,000 طلب شهرياً في الخطة المجانية كافية. إذا كان حجم البحث أكبر، يمكنك الحصول على خطط تسعير أكثر مرونة عبر منصة APIYI (apiyi.com).

---

ما هو Clawdbot

Clawdbot هو مساعد ذكاء اصطناعي شخصي مفتوح المصدر، يمكن تشغيله على جهازك الخاص والتفاعل معك عبر قنوات الاتصال التي تستخدمها عادةً.

المميزات الأساسية لـ Clawdbot

الميزة	الوصف
دعم قنوات متعددة	WhatsApp، Telegram، Discord، Slack، Signal، iMessage وغيرها
تشغيل محلي	البيانات لا تغادر جهازك، والخصوصية مضمونة
قابل للتخصيص بشكل كبير	يدعم تخصيص المهارات (Skills) وتكامل الأدوات
مفتوح المصدر ومجاني	الكود متاح بالكامل على GitHub مع مجتمع نشط

بنية Clawdbot وموقع تكامل Brave Search

رسالة المستخدم ← بوابة Clawdbot ← معالجة نموذج الذكاء الاصطناعي
                        ↓
                هل تحتاج للبحث عبر الإنترنت؟
                        ↓
                استدعاء API لـ Brave Search
                        ↓
نتائج البحث تعود ← تكامل نموذج الذكاء الاصطناعي ← الرد على المستخدم

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

---

خطوات طلب مفتاح Brave Search API

الخطوة الأولى: تسجيل حساب Brave Search API

قم بزيارة الموقع الرسمي لـ Brave Search API: brave.com/search/api/

انقر على زر "Get Started" أو "Try for free"، وقم بتسجيل حساب باستخدام بريدك الإلكتروني.

الخطوة الثانية: الدخول إلى لوحة تحكم API

بعد إتمام التسجيل، قم بتسجيل الدخول إلى لوحة تحكم API (Dashboard): api-dashboard.search.brave.com

الخطوة الثالثة: اختيار خطة الاشتراك

اختر الخطة المناسبة في صفحة الخطط (Plans):

حالة الاستخدام	الخطة الموصى بها	السبب
للاستخدام الشخصي	Free (مجانية)	2000 طلب شهرياً كافية للاستخدام اليومي
تعاون الفريق	Base AI	يدعم ترخيص تطبيقات الذكاء الاصطناعي
منتجات تجارية	Pro AI	طلبات غير محدودة وميزات كاملة

تنبيه هام: تتطلب وظيفة web_search في Clawdbot اختيار خطة Data for Search، وليس خطة "Data for AI".

الخطوة الرابعة: إنشاء مفتاح API

1. ابحث عن قسم "API Keys" في لوحة التحكم.
2. انقر على "Create API Key".
3. قم بتسمية المفتاح (مثلاً clawdbot-search).
4. انسخ مفتاح API الذي تم إنشاؤه واحفظه في مكان آمن.

sk-brave-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

⚠️ تنبيه أمني: سيتم عرض مفتاح API مرة واحدة فقط، يرجى نسخه وحفظه فوراً. في حال فقدانه، ستحتاج إلى إنشاء مفتاح جديد.

---

خطوات تفصيلية لتكوين Brave Search API في Clawdbot

الطريقة الأولى: التكوين التفاعلي (موصى به)

هذه هي أسهل طريقة للتكوين، حيث سيقوم Clawdbot بإرشادك خلال جميع الإعدادات.

clawdbot configure --section web

بعد التنفيذ، اتبع المطالبات:

1. اختر تفعيل خاصية web_search
2. الصق مفتاح Brave Search API الخاص بك
3. أكد إتمام التكوين

الطريقة الثانية: عبر ملف التكوين

إذا كنت معتادًا على سطر الأوامر، يمكنك تحرير ملف تكوين Clawdbot مباشرة.

موقع ملف التكوين:

• macOS/Linux: ~/.config/clawdbot/config.yaml
• Windows: %APPDATA%\clawdbot\config.yaml

إضافة تكوين Brave Search:

# ملف تكوين Clawdbot
web_search:
  enabled: true
  provider: brave
  api_key: "sk-brave-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

  # اختياري: معاملات البحث
  options:
    country: "US"        # منطقة نتائج البحث
    search_lang: "en"    # لغة البحث
    count: 10            # عدد النتائج المسترجعة

الطريقة الثالثة: عبر متغيرات البيئة

مناسبة لنشر Docker أو بيئات CI/CD.

# تعيين متغيرات البيئة
export BRAVE_API_KEY="sk-brave-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# تشغيل Clawdbot
clawdbot start

مثال على Docker Compose:

version: '3.8'
services:
  clawdbot:
    image: clawdbot/clawdbot:latest
    environment:
      - BRAVE_API_KEY=sk-brave-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    volumes:
      - ./config:/app/config

🚀 بداية سريعة: بمجرد اكتمال التكوين، يمكنك إجراء اختبار عن طريق إرسال أسئلة تتطلب بحثاً عبر الإنترنت إلى Clawdbot عبر أي قناة متصلة. إذا كنت بحاجة إلى تكوين واجهات برمجة تطبيقات لنماذج الذكاء الاصطناعي (AI) في نفس الوقت، فنوصي باستخدام منصة APIYI (apiyi.com) للحصول على واجهة موحدة.

---

إعدادات متقدمة لـ Brave Search API في Clawdbot

شرح مفصل لمعاملات البحث

يدعم Clawdbot تخصيص عدة معاملات لـ Brave Search:

المعامل	النوع	الوصف	قيمة مثال
country	string	تفضيل منطقة نتائج البحث	US, CN, JP
search_lang	string	لغة استعلام البحث	en, zh-hans, ja
ui_lang	string	لغة الواجهة	en-US, zh-CN
count	int	عدد النتائج المسترجعة	1-20
offset	int	إزاحة النتائج	0-9
safesearch	string	مستوى البحث الآمن	off, moderate, strict
freshness	string	تصفية زمنية	pd(24 ساعة), pw(أسبوع), pm(شهر)

مثال على التكوين الكامل

web_search:
  enabled: true
  provider: brave
  api_key: "sk-brave-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

  options:
    # الإعدادات الأساسية
    country: "US"
    search_lang: "en"
    count: 10

    # تصفية المحتوى
    safesearch: "moderate"

    # خيارات متقدمة
    text_decorations: true    # تفعيل تمييز النص
    extra_snippets: true      # الحصول على مقتطفات إضافية

قواعد البحث المخصصة (Goggles)

تتيح لك ميزة Goggles الفريدة من Brave Search تخصيص قواعد ترتيب وتصفية نتائج البحث.

web_search:
  provider: brave
  api_key: "your-api-key"
  options:
    goggles_id: "your-goggles-id"  # تطبيق Goggles المخصص

حالات استخدام Goggles الشائعة:

• استبعاد نطاقات محددة
• إعطاء الأولوية لمواقع الوثائق التقنية
• تصفية مزارع المحتوى منخفضة الجودة

---

أمثلة على الاستخدام الفعلي لـ Clawdbot Brave Search

المثال الأول: الاستعلام عن أحدث المعلومات

سؤال المستخدم:

今天 OpenAI 有什么新发布?

سلوك Clawdbot:

1. التعرف على الحاجة إلى البحث عبر الإنترنت للحصول على أحدث المعلومات.
2. استدعاء Brave Search API للبحث عن الأخبار ذات الصلة.
3. دمج نتائج البحث لإنشاء الإجابة.

المثال الثاني: البحث عن المسائل التقنية

سؤال المستخدم:

Python 3.12 有哪些新特性?

سلوك Clawdbot:

1. البحث في وثائق Python 3.12 الرسمية والمقالات التقنية.
2. استخراج معلومات الميزات الرئيسية.
3. تقديم رد منظم للمستخدم.

المثال الثالث: سيناريو البحث متعدد الخطوات

باستخدام وضع AI Grounding، يمكن لـ Clawdbot إجراء جولات متعددة من البحث والاستنتاج:

比较 Claude 3.5 Sonnet 和 GPT-4o 在代码生成方面的表现

سيقوم Clawdbot بـ:

1. البحث عن تقييمات قدرات البرمجة لنموذج Claude 3.5 Sonnet.
2. البحث عن تقييمات قدرات البرمجة لنموذج GPT-4o.
3. البحث عن مقالات تقارن بين الاثنين.
4. تقديم استنتاج بعد تحليل شامل.

🎯 نصيحة بشأن النموذج: يدعم Clawdbot نهايات خلفية متعددة لنماذج الذكاء الاصطناعي. إذا كنت بحاجة إلى استخدام نماذج متعددة مثل Claude وGPT-4o في نفس الوقت، يمكنك الحصول على واجهة API موحدة عبر APIYI apiyi.com، مما يسهل التبديل المرن والتحكم في التكاليف.

---

مراقبة وإدارة حصة استخدام Brave Search API

عرض استهلاك واجهة برمجة التطبيقات (API)

سجل الدخول إلى لوحة تحكم Brave Search API: api-dashboard.search.brave.com

في صفحة Usage (الاستخدام)، يمكنك رؤية:

• عدد الطلبات المستخدمة في الشهر الحالي.
• الحصة المتبقية (Remaining Quota).
• اتجاهات الاستخدام التاريخية.

عرض إحصائيات البحث في Clawdbot

clawdbot stats --module web_search

مثال على المخرجات:

Web Search Statistics (Last 30 days)
------------------------------------
Total searches:     1,247
Successful:         1,235 (99.0%)
Failed:             12 (1.0%)
Avg response time:  342ms

إعدادات تنبيهات الحصة

يمكنك ضبط الإعدادات التالية في لوحة تحكم Brave API:

• تنبيه عبر البريد الإلكتروني عند وصول الاستخدام إلى 80%.
• التوقف التلقائي عند نفاد الحصة (لمنع الفواتير غير المتوقعة).

---

Brave Search API Clawdbot الأسئلة الشائعة حول التكوين

س1: ماذا أفعل إذا لم تعمل وظيفة البحث بعد التكوين؟

تحقق من النقاط التالية:

1. التأكد من صحة مفتاح API: أعد نسخه ولصقه لتجنب وجود مسافات زائدة.
2. تحقق من نوع الخطة: يجب أن تكون خطة "Data for Search" وليست خطة "Data for AI".
3. التحقق من الاتصال بالشبكة: تأكد من أن الخادم يمكنه الوصول إلى api.search.brave.com.
4. مراجعة السجلات: قم بتشغيل clawdbot logs --module web_search لعرض رسائل الخطأ.

إذا استمرت المشكلة، يمكنك الحصول على الدعم التقني والحلول البديلة عبر APIYI apiyi.com.

س2: ماذا أفعل إذا نفد الرصيد المجاني؟

لديك عدة خيارات:

1. انتظار إعادة التعيين الشهرية: يتم إعادة تعيين الرصيد المجاني في اليوم الأول من كل شهر.
2. ترقية الخطة المدفوعة: تبدأ خطة Base AI من 5 دولارات لكل 1000 طلب.
3. تحسين استراتيجية البحث: اجعل Clawdbot يستدعي البحث فقط عند الضرورة القصوى.
4. استخدام التخزين المؤقت (Cache): إعادة استخدام النتائج السابقة لنفس الاستعلامات.

يمكنك الحصول على خطط تسعير أكثر مرونة لواجهة برمجة تطبيقات البحث عبر منصة APIYI apiyi.com، حيث يتم الدفع بناءً على الاستخدام الفعلي.

س3: كيف يمكن تحسين جودة نتائج البحث؟

إليك بعض تقنيات التحسين:

1. تحديد المنطقة واللغة: قم بإعداد country و search_lang وفقاً لاحتياجاتك.
2. تفعيل extra_snippets: للحصول على ملخصات محتوى أكثر ثراءً وتفصيلاً.
3. استخدام Goggles: لتخصيص قواعد ترتيب النتائج (Ranking).
4. ضبط freshness: استخدم فلاتر الوقت للمحتوى الذي يتطلب تحديثاً مستمراً ومعلومات حديثة.

س4: ما الفرق بين Brave Search API وواجهات برمجة تطبيقات البحث الأخرى؟

وجه المقارنة	Brave Search	SerpAPI	Tavily
مصدر الفهرس	فهرس مستقل	زحف Google	فهرس مستقل
الرصيد المجاني	2000 طلب/شهر	100 طلب/شهر	1000 طلب/شهر
تحسين الذكاء الاصطناعي	وضع AI Grounding	لا يوجد	مصمم خصيصاً للذكاء الاصطناعي
السعر	3-9 دولارات/1000 طلب	يبدأ من 50 دولاراً/شهر	5 دولارات/1000 طلب

تتميز Brave Search بميزة تنافسية من حيث القيمة مقابل السعر والاستقلالية.

---

أفضل الممارسات لتكامل Brave Search API مع Clawdbot

مقترحات تحسين الأداء

عنصر التحسين	المقترح	الأثر المتوقع
عدد النتائج	اضبط count: 5-10	تقليل وقت الاستجابة
التخزين المؤقت للطلبات	تفعيل التخزين المؤقت المحلي	توفير حصة API
التحكم في التزامن	الالتزام بحدود QPS	تجنب رفض الطلبات
إعادة المحاولة عند الخطأ	تنفيذ التراجع الأسي (Exponential Backoff)	تحسين استقرار النظام

نصائح أمنية

1. لا تقم بتضمين مفتاح API برمجياً: استخدم متغيرات البيئة أو ملفات التكوين المؤمنة.
2. تدوير المفاتيح بانتظام: قم بتغيير المفتاح كل 3-6 أشهر لتعزيز الأمان.
3. مراقبة الاستخدام غير الطبيعي: قم بإعداد تنبيهات عند تجاوز حدود الاستخدام المتوقعة.
4. تقييد نطاق الوصول: امنح الصلاحيات فقط للخدمات والعمليات التي تحتاجها فعلياً.

إستراتيجية التحكم في التكاليف

web_search:
  enabled: true
  provider: brave

  # التحكم في التكاليف
  rate_limit:
    max_per_minute: 10      # 10 عمليات بحث كحد أقصى في الدقيقة
    max_per_day: 100        # 100 عملية بحث كحد أقصى في اليوم

  cache:
    enabled: true
    ttl: 3600               # تخزين مؤقت لمدة ساعة واحدة

---

ملخص إعدادات Brave Search API لـ Clawdbot

من خلال هذا المقال، تعلمت ما يلي:

1. القيمة الجوهرية لـ Brave Search API: فهرس مستقل، تجربة خالية من الإعلانات، والخصوصية أولاً.
2. اختيار خطط التسعير: الباقة المجانية كافية للمستخدمين الأفراد، مع إمكانية الترقية للمشاريع التجارية حسب الحاجة.
3. ثلاث طرق للإعداد: الطريقة التفاعلية، ملف الإعدادات، ومتغيرات البيئة.
4. ضبط المعلمات المتقدم: تخصيص المنطقة، اللغة، وقواعد Goggles المخصصة.
5. أفضل الممارسات: تحسين الأداء، نصائح الأمان، والتحكم في التكاليف.

تمنح Brave Search API لـ Clawdbot قدرة البحث في الوقت الفعلي على الإنترنت، مما يتجاوز قيود تاريخ انقطاع المعرفة في نماذج الذكاء الاصطناعي. ومع التكامل مع نماذج لغة كبيرة قوية مثل Claude و GPT-4o، سيصبح مساعدك الذكي الشخصي أكثر فاعلية وفائدة.

نوصي باستخدام APIYI (apiyi.com) للحصول بسرعة على واجهات برمجة التطبيقات (APIs) لنماذج الذكاء الاصطناعي والأدوات التي تحتاجها، فهو حلك المتكامل لتلبية جميع متطلبات واجهات Clawdbot.

---

المراجع

1. الوثائق الرسمية لـ Brave Search API: مواصفات واجهة API وشرح المعلمات.

   • الرابط: brave.com/search/api/

2. وثائق Clawdbot الرسمية: دليل إعداد Brave Search.

   • الرابط: docs.clawd.bot/brave-search

3. Clawdbot على GitHub: الكود المصدري والمشكلات (Issues).

   • الرابط: github.com/clawdbot/clawdbot

4. مقدمة عن Brave AI Grounding: شرح ميزات البحث المتقدمة المدعومة بالذكاء الاصطناعي.

   • الرابط: brave.com/blog/ai-grounding/

---

📝 المؤلف: فريق APIYI
📅 تاريخ التحديث: يناير 2026
🔗 التواصل التقني: قم بزيارة APIYI (apiyi.com) للحصول على المزيد من موارد تطوير الذكاء الاصطناعي.