فهم طريقتين للبحث عبر الإنترنت في Claude Code: دليل مقارنة بين WebSearch المدمج و6 إضافات MCP للبحث

ملاحظة المؤلف: شرح مفصل لعمل أدوات البحث عبر الإنترنت المدمجة في Claude Code (WebSearch و WebFetch) وحدودها، مع مقارنة بـ 6 إضافات بحث رئيسية لنظام MCP مثل Brave Search و Tavily و Exa، لمساعدتك في تحديد ما إذا كنت بحاجة إلى تثبيت إضافات بحث إضافية لنظام MCP.

البحث عبر الإنترنت في Claude Code هو موضوع يهم الكثير من المطورين – يأتي Claude Code مزودًا بأداتين للبحث عبر الإنترنت هما WebSearch و WebFetch، فهل لا يزال هناك حاجة لتثبيت إضافات بحث لنظام MCP مثل Brave Search MCP و Tavily MCP؟ ستشرح هذه المقالة من الناحية الفنية آلية عمل هاتين الطريقتين وسيناريوهات استخدامهما، لمساعدتك في اتخاذ القرار الأنسب لسير عملك.

القيمة الأساسية: بعد قراءة هذه المقالة، ستفهم بوضوح حدود قدرات أدوات البحث المدمجة في Claude Code وإضافات نظام MCP، وفي أي سيناريو يجب استخدام كل خيار.

النقاط الأساسية للبحث عبر الإنترنت في Claude Code

الاستنتاج الأساسي للبحث عبر الإنترنت في Claude Code

الخلاصة أولاً: بالنسبة لمعظم المطورين، فإن مجموعة WebSearch + WebFetch المدمجة في Claude Code تكفي لتلبية احتياجات البحث عبر الإنترنت اليومية، ولا تحتاج إلى تثبيت إضافات MCP للبحث. ولكن إذا كنت بحاجة إلى جودة بحث أعلى، أو تحكم أفضل في نتائج البحث، أو استخراج صفحات ويب مجمعة، فإن تثبيت إضافة MCP للبحث (يوصى بـ Brave Search MCP) يمكن أن يحقق تحسينًا ملحوظًا.

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

شرح مفصل لأدوات البحث عبر الإنترنت المدمجة في Claude Code

يحتوي Claude Code على أداتين للبحث عبر الإنترنت تعملان معًا: WebSearch مسؤولة عن البحث، وWebFetch مسؤولة عن جلب محتوى الصفحات.

أداة WebSearch: محرك البحث

WebSearch هي نقطة الدخول للبحث في Claude Code، تستقبل كلمات البحث الرئيسية وتعيد عناوين وروابط صفحات الويب ذات الصلة.

كيف تعمل WebSearch:

1. يستقبل Claude Code طلب البحث الخاص بك
2. ينشئ محادثة ثانوية (secondary conversation)، ويستدعي أداة web_search في خادم Anthropic
3. يستخدم محرك البحث هذا في الخادم نفس البنية التحتية لوظيفة البحث في Claude.ai على الويب
4. تعيد النتائج العناوين وعناوين URL فقط، دون محتوى الصفحة الرئيسي

أداة WebFetch: جلب محتوى الصفحات

تقبل WebFetch عنوان URL معروفًا وسؤالًا محددًا، وتجلب محتوى تلك الصفحة وتعيد إجابة ملخصة تستهدف السؤال.

سير عمل المعالجة الداخلية لـ WebFetch:

1. التحقق من عنوان URL: فحص الطول، الترقية التلقائية من HTTP إلى HTTPS، إزالة معلومات الاعتماد
2. فحص أمان النطاق: استدعاء نقطة النهاية domain_info للتحقق من القائمة السوداء، مراعاة ملف robots.txt
3. جلب الصفحة: استخدام Axios محليًا للجلب، تتبع إعادة التوجيه لنفس النطاق تلقائيًا، تتطلب إعادة التوجيه عبر النطاقات معالجة منفصلة
4. تحويل المحتوى: تحويل HTML إلى Markdown باستخدام مكتبة Turndown، القطع التلقائي إذا تجاوز 100KB
5. التلخيص بواسطة الذكاء الاصطناعي: معالجة بواسطة Claude Haiku 3.5، إرجاع إجابة ملخصة تستهدف سؤالك

تفاصيل التصميم الرئيسية:

• ذاكرة تخزين مؤقت لمدة 15 دقيقة: سيتم استخدام الذاكرة المؤقتة للزيارات المتكررة لنفس عنوان URL خلال 15 دقيقة
• حد حجم حوالي 10 ميجابايت: الحد الأقصى لحجم الصفحة عند الجلب
• لا يعيد المحتوى الأصلي: تعيد WebFetch الإجابة الملخصة فقط، ولا تعيد HTML أو Markdown الأصلي

🎯 الغرض من التصميم: صممت Anthropic عمدًا عدم إرجاع المحتوى الأصلي لثلاثة أسباب: (1) عادةً ما تكون الصفحة الكاملة 10-100 كيلوبايت، مما يجعل دفعها مباشرة إلى النموذج الرئيسي مكلفًا ويشغل سياق التعليمات البرمجية؛ (2) تقليل سطح هجمات حقن الموجهات؛ (3) الامتثال لحقوق النشر – تقتصر الإشارات على 125 حرفًا أو أقل.

قيود أدوات البحث عبر الإنترنت المدمجة في Claude Code

مقارنة بين إضافات MCP للبحث عبر الإنترنت لـ Claude Code

إذا كانت الأدوات المدمجة لا تلبي احتياجاتك، إليك 6 إضافات MCP رئيسية للبحث:

شرح مفصل عن Brave Search MCP للبحث عبر الإنترنت

Brave Search MCP هي إضافة البحث MCP الموصى بها رسميًا من Anthropic، وهي أيضًا أكثر إضافات البحث استخدامًا. وهي مدرجة في مستودع Anthropic الرسمي modelcontextprotocol/servers.

المزايا الأساسية:

• استخدام فهرس بحث Brave المستقل (ليس إعادة بيع من Google/Bing)، مما يجعل نتائج البحث أكثر تنوعًا
• أولوية الخصوصية، لا تتعقب سلوك بحث المستخدم
• طبقة مجانية تقدم 2,000 استعلام شهريًا، كافية للمطورين الأفراد
• ملاحظات المجتمع تشير إلى أن جودة البحث أفضل من WebSearch المدمج في Claude Code

شرح مفصل عن Tavily MCP للبحث عبر الإنترنت

Tavily هو محرك بحث مصمم خصيصًا لوكيل الذكاء الاصطناعي، وتتميز إضافته MCP بأنها بارعة بشكل خاص في استعلامات الوثائق التقنية والتطوير.

المزايا الأساسية:

• نتائج البحث مُحسنة بالذكاء الاصطناعي، مع استخراج مباشر للمحتوى الأساسي
• دعم وظائف استخراج المحتوى (extract)، خريطة الموقع (map)، والزحف (crawl)
• دقة أعلى في استعلامات الوثائق التقنية مقارنة بمحركات البحث العامة
• 1,000 استعلام مجاني شهريًا

مقارنة حلول البحث عبر الإنترنت في Claude Code: المدمج مقابل MCP

هل تختار الأدوات المدمجة أم إضافات MCP؟

مطابقة السيناريوهات النموذجية:

• البحث اليومي في وثائق API للتطوير → الأدوات المدمجة كافية
• التحقق من حلول معلومات خطأ معينة → الأدوات المدمجة كافية
• كتابة مقالات تقنية تحتاج بحث متعمق → يُنصح بـ Tavily MCP
• البحث الذي يحتاج إلى حماية الخصوصية → يُنصح بـ Brave Search MCP
• سحب معلومات مواقع المنافسين بالدفعات → يُنصح بـ Firecrawl MCP
• بحث الكود والبحث الأكاديمي → يُنصح بـ Exa MCP
• الحاجة إلى إجابات شاملة وليس روابط فقط → يُنصح بـ Perplexity MCP

💡 نصيحة عملية: يدعم Claude Code تكوين عدة إضافات بحث MCP في نفس الوقت، وسيختار تلقائيًا الأداة الأنسب بناءً على محتوى الاستعلام. إذا كنت تهتم بجودة البحث، ننصح بتثبيت إضافة Brave Search MCP واحدة على الأقل كتكملة. من خلال استدعاء نموذج Claude عبر APIYI apiyi.com مع منطق بحث مخصص، يمكن أيضًا تحقيق حل بحث عبر الإنترنت أكثر مرونة.

تثبيت وتكوين بحث MCP عبر الإنترنت في Claude Code

تثبيت Brave Search MCP (موصى به)

الخطوة 1: الحصول على مفتاح API

قم بزيارة صفحة Brave Search API: brave.com/search/api، سجل حساب مجاني للحصول على مفتاح API (2000 طلب مجاني شهريًا).

الخطوة 2: إضافة MCP Server

# تشغيل في طرفية Claude Code
claude mcp add brave-search \
  npx -y @anthropic/mcp-brave-search \
  --api-key YOUR_BRAVE_API_KEY

# الحصول على مفتاح Tavily API: tavily.com
# إضافة Tavily MCP Server
claude mcp add tavily-search \
  npx -y tavily-mcp@latest \
  --api-key YOUR_TAVILY_API_KEY

# الحصول على مفتاح Exa API: exa.ai
# إضافة Exa MCP Server
claude mcp add exa-search \
  npx -y exa-mcp-server \
  --api-key YOUR_EXA_API_KEY

إدارة تكوين MCP

# عرض MCP Servers المثبتة
claude mcp list

# حذف MCP Server معين
claude mcp remove brave-search

# التكوين على مستوى المشروع (مشترك بين الفريق)
claude mcp add --scope project brave-search \
  npx -y @anthropic/mcp-brave-search

# التكوين على مستوى المستخدم (شخصي فقط، مخزن في ~/.claude.json)
claude mcp add --scope local brave-search \
  npx -y @anthropic/mcp-brave-search \
  --api-key YOUR_KEY

نصيحة أمان: يُنصح بتخزين تكوينات MCP التي تحتوي على مفاتيح API باستخدام --scope local في التكوين الشخصي، لتجنب تسرب مفتاح API إلى مستودع المشروع. استخدم --scope project للتكوينات المشتركة بين الفريق، وحقن مفتاح API عبر متغيرات البيئة.

أمثلة عملية للبحث عبر الإنترنت باستخدام Claude Code

استخدام WebSearch المدمج

عندما تطرح سؤالاً في Claude Code يحتاج إلى معلومات من الإنترنت، فإنه يستدعي WebSearch تلقائياً:

# طرح سؤال مباشر في Claude Code
> ساعدني في البحث عن أحدث تغييرات Server Components في React 19

# Claude Code يستدعي WebSearch تلقائياً للبحث
# ثم يستدعي WebFetch للحصول على ملخص المحتوى من الصفحات ذات الصلة
# وأخيراً يجمع المعلومات للإجابة على سؤالك

استخدام إضافة MCP للبحث

بعد تثبيت Brave Search MCP، سيختار Claude Code تلقائياً استخدامه من بين الأدوات المتاحة:

# بعد تثبيت Brave Search MCP
> ابحث عن أحدث إعلانات الأمان في Node.js

# قد يختار Claude Code استخدام Brave Search MCP
# ويعيد نتائج بحث أكثر ثراءً
# تتضمن المزيد من معلومات السياق

تنفيذ بحث مخصص عبر الإنترنت عبر API

إذا كنت بحاجة إلى تنفيذ قدرات بحث مشابهة عبر الإنترنت في مشروعك الخاص، يمكنك تحقيق ذلك من خلال Claude API مع أدوات البحث:

import openai
import requests

def search_and_analyze(query: str) -> str:
    """تنفيذ تحليل بحث عبر الإنترنت باستخدام محرك بحث وClaude"""
    # الخطوة 1: استخدام API البحث للحصول على النتائج
    # يمكن استخدام Brave Search API أو Tavily API وغيرها
    search_results = requests.get(
        "https://api.search.brave.com/res/v1/web/search",
        headers={"X-Subscription-Token": "YOUR_BRAVE_KEY"},
        params={"q": query, "count": 5}
    ).json()

    # الخطوة 2: إرسال نتائج البحث إلى Claude للتحليل
    client = openai.OpenAI(
        api_key="YOUR_API_KEY",
        base_url="https://vip.apiyi.com/v1"
    )

    context = "\n".join([
        f"- {r['title']}: {r['url']}"
        for r in search_results.get("web", {}).get("results", [])
    ])

    response = client.chat.completions.create(
        model="claude-sonnet-4-6",
        messages=[
            {"role": "system", "content": "أجب على سؤال المستخدم بناءً على نتائج البحث التالية."},
            {"role": "user", "content": f"نتائج البحث:\n{context}\n\nالسؤال: {query}"}
        ]
    )
    return response.choices[0].message.content

اقتراح: من خلال APIYI apiyi.com لاستدعاء Claude API مع خدمات بحث مثل Brave Search API، يمكنك بناء حلول بحث عبر الإنترنت أكثر مرونة. توفر المنصة رصيد تجريبي مجاني وواجهة متوافقة مع OpenAI، مما يجعلها مناسبة للتحقق السريع من الحلول.

تقنيات متقدمة للبحث عبر الإنترنت باستخدام Claude Code

التقنية 1: استخدام تصفية النطاق لتحسين البحث

يدعم WebSearch في Claude Code تصفية النطاقات، مما يسمح لك بالتحكم الدقيق في نطاق البحث:

# البحث فقط في الوثائق الرسمية
> ابحث عن طرق استخدام asyncio في docs.python.org

# سيستخدم Claude Code معلمة allowed_domains
# لتقييد النتائج فقط من docs.python.org

التقنية 2: التعاون بين محركات بحث MCP متعددة

يدعم Claude Code تكوين عدة محركات بحث MCP في وقت واحد، وسيختار تلقائياً بناءً على نوع الاستعلام:

• أسئلة عامة → اختيار تلقائي لـ Brave Search أو WebSearch المدمج
• وثائق تقنية → اختيار تلقائي لـ Tavily (إذا كان مثبتاً)
• أمثلة كود → اختيار تلقائي لـ Exa (إذا كان مثبتاً)

التقنية 3: استخدام WebFetch لقراءة URL معروف مباشرة

إذا كنت تعرف بالفعل عنوان URL للصفحة المستهدفة، يمكنك تخطي خطوة البحث وطلب من Claude Code استخدام WebFetch مباشرة:

# قراءة محتوى عنوان URL محدد مباشرة
> اقرأ https://docs.anthropic.com/claude/docs وأخبرني بأحدث تغييرات API

🎯 اقتراح تقني: إذا كنت تحتاج بشكل متكرر إلى استخدام قدرات البحث عبر الإنترنت في سير عمل CI/CD، نوصي باستدعاء Claude API عبر منصة APIYI apiyi.com مع Brave أو Tavily Search API، لبناء خط أنابيب آلي للحصول على المعلومات. تدعم المنصة واجهة متوافقة مع OpenAI، مما يسهل التكامل مع أدواتك الحالية.

الأسئلة الشائعة

الخلاصة

ثلاث نقاط أساسية حول البحث عبر الإنترنت في Claude Code:

1. الأدوات المدمجة كافية: تكفي مجموعة WebSearch + WebFetch المدمجة في Claude Code لتلبية 80% من احتياجات البحث عبر الإنترنت، حيث تتولى WebSearch مهمة البحث وإرجاع الروابط، بينما تتولى WebFetch مهمة الحصول على ملخص الصفحة للإجابة، ويتعاون الاثنان لتشكيل سلسلة بحث كاملة.
2. أدوات البحث MCP هي إضافة قيمة: Brave Search MCP (الموصى به رسميًا، 2,000 عملية مجانية/شهر) وTavily MCP (متميز في البحث في الوثائق التقنية) هما أهم إضافتين للبحث تستحقان التثبيت، حيث تقدمان تحسينًا ملحوظًا في جودة البحث وثراء النتائج.
3. اختر ما يناسب احتياجاتك: للبحث اليومي في الوثائق أثناء التطوير → استخدم الأدوات المدمجة؛ للبحث المتعمق وجمع البيانات بكميات كبيرة → قم بتثبيت MCP؛ للرغبة في دمج البحث في سير عمل آلي → استدع Claude API عبر APIYI على apiyi.com بالتنسيق مع واجهة برمجة تطبيقات خدمة البحث.

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

📚 مراجع

1. تحليل متعمق لأدوات ويب Claude Code: المبادئ الداخلية لتنفيذ WebSearch و WebFetch

   • الرابط: mikhail.io/2025/10/claude-code-web-tools/
   • الوصف: تحليل الهندسة العكسية للتنفيذ التقني لأدوات اتصال Claude Code بالإنترنت

2. الوثائق الرسمية لأداة البحث على الويب: شرح أداة البحث في واجهة برمجة تطبيقات Claude

   • الرابط: platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool
   • الوصف: الوثائق الرسمية من Anthropic لواجهة برمجة تطبيقات أداة WebSearch

3. الوثائق الرسمية لأداة جلب الصفحات: شرح أداة جلب الصفحات في واجهة برمجة تطبيقات Claude

   • الرابط: platform.claude.com/docs/en/agents-and-tools/tool-use/web-fetch-tool
   • الوصف: الوثائق الرسمية من Anthropic لواجهة برمجة تطبيقات أداة WebFetch

4. دليل تكامل إضافة بحث MCP: مقارنة خدمات بحث MCP متعددة ودليل التثبيت

   • الرابط: intuitionlabs.ai/articles/mcp-servers-claude-code-internet-search
   • الوصف: مقارنة مفصلة لـ 8 إضافات بحث MCP واقتراحات للاستخدام

5. Brave Search MCP: MCP البحث الموصى به رسميًا من Anthropic

   • الرابط: brave.com/search/api/guides/use-with-claude-desktop-with-mcp/
   • الوصف: دليل تثبيت واستخدام Brave Search MCP

المؤلف: فريق APIYI التقني
التواصل التقني: نرحب بمشاركة تجربتك في تكوين بحث Claude Code المتصل بالإنترنت في قسم التعليقات، لمزيد من مواد تطوير الذكاء الاصطناعي يمكنك زيارة مركز وثائق APIYI docs.apiyi.com