/ الدليل / الملعب / Tavily MCP
● رسمي tavily-ai 🔑 يتطلب مفتاحك

Tavily MCP

بواسطة tavily-ai · tavily-ai/tavily-mcp

يوفر Tavily MCP لوكيلك البحث على الويب، واستخراج الصفحة، وخريطة الموقع، والزحف - وقد تم تنسيقه بالفعل لـ LLMs حتى لا تهدر الرموز المميزة على العلامات المسروقة.

Tavily عبارة عن واجهة برمجة تطبيقات بحث مصممة لعملاء الذكاء الاصطناعي: تعود الإجابات كنص نظيف مع المصادر، وليس 50 كيلوبايت من HTML. يعرض خادم MCP أربع أدوات (البحث، والاستخراج، والخريطة، والزحف) التي يمكنك دمجها في سير عمل بحثي حقيقي. يتطلب مفتاح API مجانيًا من tavily.com. يعمل خارج الصندوق في Claude Desktop وCursor وWindsurf وClaude Code - التثبيت عبر npx.

لماذا تستخدمه

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

عرض مباشر

كيف يبدو في الممارسة

tavily-mcp.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp@latest"
      ],
      "env": {
        "TAVILY_API_KEY": "tvly-..."
      }
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp@latest"
      ],
      "env": {
        "TAVILY_API_KEY": "tvly-..."
      }
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp@latest"
      ],
      "env": {
        "TAVILY_API_KEY": "tvly-..."
      }
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp@latest"
      ],
      "env": {
        "TAVILY_API_KEY": "tvly-..."
      }
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "tavily-mcp",
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp@latest"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "tavily-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "tavily-mcp@latest"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add tavily-mcp -- npx -y tavily-mcp@latest

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: Tavily MCP

أجب عن سؤال حول شيء حدث بعد قطع النموذج

👤 أي شخص يستخدم Claude مع الأسئلة التي تحتاج إلى معلومات جديدة ⏱ ~5 min beginner

متى تستخدمه: أنت تسأل عن إصدار عام 2026، أو CVE حديث، أو صفحة تسعير جديدة، أو السوق اليوم - النموذج لا يعرفه ويجب أن يبحث.

المتطلبات الأساسية
  • مفتاح Tavily API — قم بالتسجيل في tavily.com (المستوى المجاني = 1000 مكالمة/شهر)
  • تم تثبيت Tavily MCP — الصق كتلة التكوين أعلاه في إعدادات MCP الخاصة بعميلك
الخطوات
  1. اسأل مباشرة
    ماذا قدمت الأنثروبيك في كلود سونيت 4.7 هذا الشهر؟ استخدم Tavily للعثور على الإعلان وتلخيصه مع المصادر.✓ تم النسخ
    → يستدعي الوكيل tavily_search، ويعيد ملخصًا بالمصادر المرتبطة
  2. الحفر على مصدر واحد
    يبدو المصدر الثاني أكثر موثوقية — استخدم tavily_extract لسحب النص الكامل واقتباس السطر الدقيق حول نافذة السياق.✓ تم النسخ
    → اقتباس مباشر مع URL + رقم الفقرة

النتيجة: الإجابة الحالية المستشهد بها في دورة واحدة - لا يوجد بحث يدوي على Google.

المزالق
  • أعاد البحث SEO غير المرغوب فيه أولاً — أضف تلميحات للموقع: "... من موقع anthropic.com أو مدونة anthropic الرسمية"
  • ملخصات الانجراف من المصادر — تتطلب علامات الاقتباس المباشرة - "إعادة الصياغة مع الاحتفاظ بالأرقام والتواريخ والأسماء بالضبط"
اجمعها مع: filesystem · memory

قم بإجراء فحص تنافسي للمنتج في جلسة واحدة

👤 رؤساء المشاريع والمؤسسين والمسوقين ⏱ ~30 min intermediate

متى تستخدمه: أنت بحاجة إلى ملخص من صفحة واحدة عن كل منافس لفئة ميزة معينة بحلول نهاية اليوم.

الخطوات
  1. اكتشف المنافسين
    باستخدام Tavily، يمكنك العثور على أفضل 8 منتجات تنافسنا في "إدارة علاقات العملاء المستندة إلى الذكاء الاصطناعي للشركات الصغيرة والمتوسطة". لكل منها، اسم الإرجاع، وعنوان URL، والسطر الواحد، وسنة التأسيس.✓ تم النسخ
    → جدول منظم مكون من 8 صفوف مع روابط المصدر
  2. خريطة كل موقع
    لكل منافس، قم بتخطيط موقعه على tavily_map للعثور على صفحات الأسعار والميزات الخاصة به. قم بإرجاع عناوين URL.✓ تم النسخ
    → 2 عناوين URL لكل منافس
  3. استخراج التسعير
    tavily_extract كل صفحة تسعير وإنشاء شبكة مقارنة: اسم الخطة، السعر الشهري، أهم 3 عوامل تفاضلية.✓ تم النسخ
    → شبكة نظيفة تستشهد الخلايا بعنوان URL لصفحة التسعير

النتيجة: ملخص قابل للمشاركة مع المصادر - جاهز لشريحة PMM في 30 دقيقة.

المزالق
  • التسعير الذي تم عرضه بواسطة JS واستخراجه يفتقده — ارجع إلى tavily_crawl باستخدام render=on، أو اضغط على خريطة الموقع /pricing مباشرة
اجمعها مع: filesystem

اكتب برنامجًا تعليميًا يحتوي على روابط تم التحقق منها مباشرة

👤 الكتاب الفنيين، DevRel ⏱ ~25 min intermediate

متى تستخدمه: أنت تنشر إرشادات ويجب على كل رابط خارجي أن يتعامل مع المحتوى الصحيح اليوم.

الخطوات
  1. جمع المراجع المرشحة
    باستخدام tavily_search، ابحث عن أفضل 5 صفحات مستندات أساسية لـ "تدفق OAuth 2.1 PKCE". تفضيل طلبات RFC ومستندات البائع على المدونات.✓ تم النسخ
    → 5 عناوين URL مع مبررات قصيرة لكل منها
  2. التحقق من كل واحد
    tavily_extract كل عنوان URL. بالنسبة لكل منها، تأكد من أن الصفحة لا تزال تغطي PKCE وقم بوضع علامة على أي صفحة تبدو معاد توجيهها أو قديمة.✓ تم النسخ
    → الحكم المباشر لكل عنوان URL
  3. تضمين في المسودة
    أعد كتابة مسودة البرنامج التعليمي الخاصة بي للاستشهاد فقط بعناوين URL التي تم التحقق منها، مع نص الرابط الذي يطابق العنوان الفعلي للصفحة.✓ تم النسخ
    → مسودة محدثة؛ يتطابق كل نص رابط مع عنوان الصفحة الحقيقي

النتيجة: تم نشر البرنامج التعليمي بدون أي روابط معطلة ونص ربط دقيق.

اجمعها مع: filesystem

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

tavily-mcp + filesystem

ابحث واستخرج إلى القرص ثم قم بالتحليل محليًا دون إعادة الجلب

Search Tavily for recent OWASP top-10 sources, extract them, save to /research/owasp/, then compare the content offline.✓ تم النسخ
tavily-mcp + memory

Build a research journal that persists between sessions

For each Tavily search, save a one-line note and the URLs to memory under 'project:acme'. Next session, reuse.✓ تم النسخ
tavily-mcp + context7

Tavily for web context + Context7 for library docs — don't confuse them

Use Context7 for docs questions; Tavily for news, blog posts, and anything not in library indexes.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
tavily_search query: str, max_results?: int, search_depth?: 'basic'|'advanced', include_domains?: str[] الأداة الأساسية — استعلام واحد، ومقتطفات جاهزة لـ LLM مع عناوين URL 1 API call
tavily_extract urls: str[], extract_depth?: 'basic'|'advanced' لديك بالفعل عنوان URL وتريد نصًا واضحًا - بدون HTML أو إعلانات 1 API call per URL
tavily_map url: str, max_depth?: int, categories?: str[] اكتشف بنية الموقع — وهي مفيدة قبل الاستخراج/الزحف 1 API call
tavily_crawl url: str, max_depth?: int, limit?: int, instructions?: str الاستيعاب على نطاق واسع لموقع صغير أو قسم مستند - مكلف، تفضل الاستخراج عندما تعرف عناوين URL بالفعل Multiple API calls (one per page)

التكلفة والحدود

تكلفة التشغيل

حصة API
Free tier = 1,000 API calls/month; scaling plans from $30/mo
الرموز لكل استدعاء
Returns ~500–5000 tokens of clean content — much less than raw HTML would
التكلفة المالية
Free tier covers individual daily use; heavy workflows need paid
نصيحة
Prefer tavily_search over tavily_crawl — search is one call, crawl is N. Only crawl when you truly need breadth.

الأمان

الصلاحيات والأسرار ونطاق الأثر

تخزين بيانات الاعتماد: TAVILY_API_KEY in env var (set in the MCP config's env block)
نقل البيانات الخارجي: Queries and URLs you pass are sent to api.tavily.com. Don't paste proprietary info into the query string.

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

401 Unauthorized

Double-check TAVILY_API_KEY in your MCP config. The env block lives inside the server config, not at top level.

تحقق: Call any Tavily tool; if the error persists, rotate the key in tavily.com dashboard
Empty results despite a real query

Switch search_depth from 'basic' to 'advanced' for niche topics; add include_domains to bias toward authoritative sources

تحقق: Repeat with search_depth: 'advanced'
tavily_extract returns paywalled gibberish

Tavily follows robots.txt and respects paywalls. For paywalled content, note it's unreachable — don't try to bypass.

429 Rate limit

Free tier = 60 RPM. Space out calls, or upgrade at tavily.com. The MCP auto-backs-off once, then surfaces the error.

تحقق: Check usage in tavily.com dashboard

البدائل

Tavily MCP مقابل البدائل

البديلمتى تستخدمهاالمقايضة
exa-mcp-serverYou want Exa's neural/embedding-style search and similarityDifferent result quality on different query types; both are LLM-tuned
fetchYou have the URL and just want HTML → markdown, no searchNo search; no structured extract; you handle the URL discovery
perplexity-askYou want a research-level answer synthesized by Perplexity, not raw resultsHigher latency, higher cost, less composable — it's one big tool
firecrawl-mcp-serverYou need heavy crawling or JS rendering as a core workflowPricier; overkill for one-off lookups

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills