بحث Brave

​

الحصول على مفتاح API

1. أنشئ حساب Brave Search API على https://brave.com/search/api/
2. في لوحة التحكم، اختر خطة Search وأنشئ مفتاح API.
3. خزّن المفتاح في الإعدادات أو عيّن BRAVE_API_KEY في بيئة Gateway.

​

مثال على الإعدادات

{
  plugins: {
    entries: {
      brave: {
        config: {
          webSearch: {
            apiKey: "BRAVE_API_KEY_HERE",
            mode: "web", // أو "llm-context"
            baseUrl: "https://api.search.brave.com", // تجاوز اختياري لعنوان URL الأساسي/عنوان الوكيل
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "brave",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}

• web (الافتراضي): بحث Brave عادي على الويب يتضمن العناوين وعناوين URL والمقتطفات
• llm-context: واجهة Brave LLM Context API مع مقاطع نصية مستخرجة مسبقًا ومصادر للاستناد إليها

​

معاملات الأداة

// بحث خاص بالبلد واللغة
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// النتائج الحديثة (الأسبوع الماضي)
await web_search({
  query: "AI news",
  freshness: "week",
});

// البحث ضمن نطاق زمني
await web_search({
  query: "AI developments",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

​

ملاحظات

• يستخدم OpenClaw خطة Search من Brave. إذا كان لديك اشتراك قديم (مثل خطة Free الأصلية التي تتيح 2,000 استعلام شهريًا)، فسيظل صالحًا، لكنه لا يتضمن الميزات الأحدث مثل LLM Context أو حدود المعدل الأعلى.
• تتضمن كل خطة من Brave رصيدًا مجانيًا بقيمة $5 شهريًا (يتجدد). تبلغ تكلفة خطة Search مقدار $5 لكل 1,000 طلب، لذا يغطي الرصيد 1,000 استعلام شهريًا. عيّن حد الاستخدام في لوحة تحكم Brave لتجنب الرسوم غير المتوقعة. راجع بوابة Brave API للاطلاع على الخطط الحالية.
• تتضمن خطة Search نقطة نهاية LLM Context وحقوق استدلال الذكاء الاصطناعي. يتطلب تخزين النتائج لتدريب النماذج أو ضبطها خطة تتضمن حقوق تخزين صريحة. راجع شروط الخدمة لدى Brave.
• يعيد وضع llm-context إدخالات مصادر مستندة إلى مراجع بدلًا من بنية مقتطفات بحث الويب المعتادة.
• يدعم وضع llm-context الخيار freshness والنطاقات المحدودة التي تجمع بين date_after وdate_before. ولا يدعم ui_lang؛ ويُرفض date_before من دون date_after لأن Brave يشترط أن تتضمن نطاقات الحداثة المخصصة تاريخي البداية والنهاية.
• يجب أن يتضمن ui_lang وسمًا فرعيًا للمنطقة مثل en-US.
• تُخزّن النتائج مؤقتًا لمدة 15 دقيقة افتراضيًا (ويمكن ضبطها عبر cacheTtlMinutes).
• تُضمّن قيم webSearch.baseUrl المخصصة في هوية ذاكرة التخزين المؤقت لـ Brave، بحيث لا تتعارض الاستجابات الخاصة بالوكيل.
• فعّل علامة التشخيص brave.http لتسجيل عناوين URL لمعاملات طلبات Brave/معاملات الاستعلام، وحالة الاستجابة/توقيتها، وأحداث إصابة/فقدان/كتابة ذاكرة التخزين المؤقت للبحث أثناء استكشاف الأخطاء وإصلاحها. لا تسجّل العلامة مطلقًا مفتاح API أو نصوص الاستجابة، لكن استعلامات البحث قد تكون حساسة.

​

ذو صلة

• نظرة عامة على بحث الويب — جميع المزوّدين والاكتشاف التلقائي
• بحث Perplexity — نتائج منظّمة مع تصفية النطاقات
• بحث Exa — بحث عصبي مع استخراج المحتوى