هل ترغب في منح مساعدك الشخصي للذكاء الاصطناعي 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 | مناسب لتطبيقات الذكاء الاصطناعي |
|---|---|---|
| لا يوفر 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
- ابحث عن قسم "API Keys" في لوحة التحكم.
- انقر على "Create API Key".
- قم بتسمية المفتاح (مثلاً
clawdbot-search). - انسخ مفتاح API الذي تم إنشاؤه واحفظه في مكان آمن.
sk-brave-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
⚠️ تنبيه أمني: سيتم عرض مفتاح API مرة واحدة فقط، يرجى نسخه وحفظه فوراً. في حال فقدانه، ستحتاج إلى إنشاء مفتاح جديد.
خطوات تفصيلية لتكوين Brave Search API في Clawdbot
الطريقة الأولى: التكوين التفاعلي (موصى به)
هذه هي أسهل طريقة للتكوين، حيث سيقوم Clawdbot بإرشادك خلال جميع الإعدادات.
clawdbot configure --section web
بعد التنفيذ، اتبع المطالبات:
- اختر تفعيل خاصية
web_search - الصق مفتاح Brave Search API الخاص بك
- أكد إتمام التكوين
الطريقة الثانية: عبر ملف التكوين
إذا كنت معتادًا على سطر الأوامر، يمكنك تحرير ملف تكوين 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:
- التعرف على الحاجة إلى البحث عبر الإنترنت للحصول على أحدث المعلومات.
- استدعاء Brave Search API للبحث عن الأخبار ذات الصلة.
- دمج نتائج البحث لإنشاء الإجابة.
المثال الثاني: البحث عن المسائل التقنية
سؤال المستخدم:
Python 3.12 有哪些新特性?
سلوك Clawdbot:
- البحث في وثائق Python 3.12 الرسمية والمقالات التقنية.
- استخراج معلومات الميزات الرئيسية.
- تقديم رد منظم للمستخدم.
المثال الثالث: سيناريو البحث متعدد الخطوات
باستخدام وضع AI Grounding، يمكن لـ Clawdbot إجراء جولات متعددة من البحث والاستنتاج:
比较 Claude 3.5 Sonnet 和 GPT-4o 在代码生成方面的表现
سيقوم Clawdbot بـ:
- البحث عن تقييمات قدرات البرمجة لنموذج Claude 3.5 Sonnet.
- البحث عن تقييمات قدرات البرمجة لنموذج GPT-4o.
- البحث عن مقالات تقارن بين الاثنين.
- تقديم استنتاج بعد تحليل شامل.
🎯 نصيحة بشأن النموذج: يدعم 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: ماذا أفعل إذا لم تعمل وظيفة البحث بعد التكوين؟
تحقق من النقاط التالية:
- التأكد من صحة مفتاح API: أعد نسخه ولصقه لتجنب وجود مسافات زائدة.
- تحقق من نوع الخطة: يجب أن تكون خطة "Data for Search" وليست خطة "Data for AI".
- التحقق من الاتصال بالشبكة: تأكد من أن الخادم يمكنه الوصول إلى
api.search.brave.com. - مراجعة السجلات: قم بتشغيل
clawdbot logs --module web_searchلعرض رسائل الخطأ.
إذا استمرت المشكلة، يمكنك الحصول على الدعم التقني والحلول البديلة عبر APIYI apiyi.com.
س2: ماذا أفعل إذا نفد الرصيد المجاني؟
لديك عدة خيارات:
- انتظار إعادة التعيين الشهرية: يتم إعادة تعيين الرصيد المجاني في اليوم الأول من كل شهر.
- ترقية الخطة المدفوعة: تبدأ خطة Base AI من 5 دولارات لكل 1000 طلب.
- تحسين استراتيجية البحث: اجعل Clawdbot يستدعي البحث فقط عند الضرورة القصوى.
- استخدام التخزين المؤقت (Cache): إعادة استخدام النتائج السابقة لنفس الاستعلامات.
يمكنك الحصول على خطط تسعير أكثر مرونة لواجهة برمجة تطبيقات البحث عبر منصة APIYI apiyi.com، حيث يتم الدفع بناءً على الاستخدام الفعلي.
س3: كيف يمكن تحسين جودة نتائج البحث؟
إليك بعض تقنيات التحسين:
- تحديد المنطقة واللغة: قم بإعداد
countryوsearch_langوفقاً لاحتياجاتك. - تفعيل extra_snippets: للحصول على ملخصات محتوى أكثر ثراءً وتفصيلاً.
- استخدام Goggles: لتخصيص قواعد ترتيب النتائج (Ranking).
- ضبط 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) | تحسين استقرار النظام |
نصائح أمنية
- لا تقم بتضمين مفتاح API برمجياً: استخدم متغيرات البيئة أو ملفات التكوين المؤمنة.
- تدوير المفاتيح بانتظام: قم بتغيير المفتاح كل 3-6 أشهر لتعزيز الأمان.
- مراقبة الاستخدام غير الطبيعي: قم بإعداد تنبيهات عند تجاوز حدود الاستخدام المتوقعة.
- تقييد نطاق الوصول: امنح الصلاحيات فقط للخدمات والعمليات التي تحتاجها فعلياً.
إستراتيجية التحكم في التكاليف
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
من خلال هذا المقال، تعلمت ما يلي:
- القيمة الجوهرية لـ Brave Search API: فهرس مستقل، تجربة خالية من الإعلانات، والخصوصية أولاً.
- اختيار خطط التسعير: الباقة المجانية كافية للمستخدمين الأفراد، مع إمكانية الترقية للمشاريع التجارية حسب الحاجة.
- ثلاث طرق للإعداد: الطريقة التفاعلية، ملف الإعدادات، ومتغيرات البيئة.
- ضبط المعلمات المتقدم: تخصيص المنطقة، اللغة، وقواعد Goggles المخصصة.
- أفضل الممارسات: تحسين الأداء، نصائح الأمان، والتحكم في التكاليف.
تمنح Brave Search API لـ Clawdbot قدرة البحث في الوقت الفعلي على الإنترنت، مما يتجاوز قيود تاريخ انقطاع المعرفة في نماذج الذكاء الاصطناعي. ومع التكامل مع نماذج لغة كبيرة قوية مثل Claude و GPT-4o، سيصبح مساعدك الذكي الشخصي أكثر فاعلية وفائدة.
نوصي باستخدام APIYI (apiyi.com) للحصول بسرعة على واجهات برمجة التطبيقات (APIs) لنماذج الذكاء الاصطناعي والأدوات التي تحتاجها، فهو حلك المتكامل لتلبية جميع متطلبات واجهات Clawdbot.
المراجع
-
الوثائق الرسمية لـ Brave Search API: مواصفات واجهة API وشرح المعلمات.
- الرابط:
brave.com/search/api/
- الرابط:
-
وثائق Clawdbot الرسمية: دليل إعداد Brave Search.
- الرابط:
docs.clawd.bot/brave-search
- الرابط:
-
Clawdbot على GitHub: الكود المصدري والمشكلات (Issues).
- الرابط:
github.com/clawdbot/clawdbot
- الرابط:
-
مقدمة عن Brave AI Grounding: شرح ميزات البحث المتقدمة المدعومة بالذكاء الاصطناعي.
- الرابط:
brave.com/blog/ai-grounding/
- الرابط:
📝 المؤلف: فريق APIYI
📅 تاريخ التحديث: يناير 2026
🔗 التواصل التقني: قم بزيارة APIYI (apiyi.com) للحصول على المزيد من موارد تطوير الذكاء الاصطناعي.
