YFinance MCP

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

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

لا مفتاح API، لا تسجيل
أسعار، OHLC تاريخية، أساسيات، ميزانيات عمومية
سلاسل خيارات، مواعيد الأرباح، توزيعات أرباح
عناوين أخبار لكل رمز تداول
تنفيذ Python سريع عبر uvx

عرض مباشر

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

yfinance-mcp.replay ▶ جاهز

0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "yfinance-mcp": {
      "command": "uvx",
      "args": [
        "yfinance-mcp"
      ]
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "yfinance-mcp": {
      "command": "uvx",
      "args": [
        "yfinance-mcp"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "yfinance-mcp": {
      "command": "uvx",
      "args": [
        "yfinance-mcp"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "yfinance-mcp": {
      "command": "uvx",
      "args": [
        "yfinance-mcp"
      ]
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "yfinance-mcp",
      "command": "uvx",
      "args": [
        "yfinance-mcp"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "yfinance-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "yfinance-mcp"
        ]
      }
    }
  }
}

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

claude mcp add yfinance-mcp -- uvx yfinance-mcp

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

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

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

لقطة سريعة لقائمة مراقبتك — أسعار، P/E، أخبار

👤 المستثمرون الذين يتابعون يوميًا ⏱ ~5 min beginner

متى تستخدمه: تريد إحاطة بـ prompt واحد لـ 10 رموز قبل افتتاح السوق.

الخطوات

الأسعار

استخدم yfinance-mcp. لـ AAPL وMSFT وNVDA وTSLA وGOOGL وAMZN وMETA وBRK-B وJPM وV — السعر الحالي ونسبة اليوم ونطاق 52 أسبوعًا.✓ تم النسخ

→ جدول نظيف بـ 10 صفوف
الأساسيات

للقائمة نفسها، P/E وP/E المستقبلي وEPS وعائد الأرباح.✓ تم النسخ

→ الأساسيات منسجمة مع الجدول السابق
الأخبار

لأكبر 3 متحركين اليوم، اسحب آخر 3 عناوين لكل. لخّص الانطباع العام.✓ تم النسخ

→ أخبار مجمَّعة لكل رمز مع سطر انطباع

النتيجة: إحاطة صباحية من 10 أسطر مخصصة لقائمة مراقبتك.

المزالق

تحديد المعدل عند إرسال رموز كثيرة دفعةً واحدة — قسّم إلى 10 رموز لكل استدعاء مع تأخير ثانية بينها

اجمعها مع: memory

اختبر فكرة استراتيجية بسيطة تاريخيًا على الأسعار

👤 المتداولون الأفراد في مرحلة النمذجة ⏱ ~20 min intermediate

متى تستخدمه: لديك فكرة كـ «شراء SPY حين RSI < 30، بيع عند > 70» وتريد تحققًا تاريخيًا سريعًا.

الخطوات

سحب التاريخ

اسحب OHLC يومي لـ 5 سنوات لـ SPY.✓ تم النسخ

→ سلسلة زمنية مُعادة كمصفوفة
الحساب

احسب RSI(14). شغّل استراتيجية «شراء<30، بيع>70». أبلغ عن CAGR والحد الأقصى للتراجع وعدد الصفقات مقابل الشراء والاحتفاظ.✓ تم النسخ

→ مقاييس الاستراتيجية مع مقارنة صادقة بالخط الأساسي
فحص الواقع

احسب العمولات (1 دولار/صفقة) والانزلاق (5bps). هل تصمد الميزة؟✓ تم النسخ

→ أرقام صافية بعد التكاليف

النتيجة: قرار للمضي/التوقف في اختبار الفكرة أكثر.

المزالق

تحيز البقاء — yfinance يحتوي فقط رموز سائلة — للاختبار الجدي، استخدم مجموعة بيانات مخصصة؛ yfinance للرسم التخطيطي فقط

اجمعها مع: alpaca

التركيبات

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

yfinance-mcp + alpaca

yfinance للبحث، Alpaca للأوامر الفعلية

اختر 3 أفكار عبر yfinance، ضع صفقات تجريبية عبر Alpaca.✓ تم النسخ

yfinance-mcp + memory

تتبع أطروحتك الخاصة على رموز التداول بمرور الوقت

خزّن الأطروحة حول NVDA اعتبارًا من اليوم مع السعر.✓ تم النسخ

الأدوات

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

الأداة	المدخلات	متى تستدعيها	التكلفة
get_quote	ticker: str	لقطة سعر حالية	free
get_history	ticker, period: str, interval: str	بيانات تاريخية للرسم البياني أو الاختبار	free
get_fundamentals	ticker	تحليل التقييم والأساسيات	free
get_options	ticker, expiry?: date	البحث في سلسلة الخيارات	free
get_news	ticker, limit?: int	عناوين على مستوى الرمز	free

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

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

حصة API: حدود Yahoo غير موثقة — تجنب الإفراط في الطلبات
الرموز لكل استدعاء: OHLC لـ 5 سنوات ≈ 50k رمز، ركّز الطلبات
التكلفة المالية: مجاني
نصيحة: أعد أخذ العينات أسبوعيًا للتواريخ الأطول؛ اسحب اليومي فقط حين تحتاجه

الأمان

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

تخزين بيانات الاعتماد: لا شيء

نقل البيانات الخارجي: query1.finance.yahoo.com

Yahoo كسر yfinance سابقًا بتغييرات HTML — أبقِ الحزمة محدَّثة

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

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

يُعيد فارغًا أو خطأ لرمز تداول

استخدم رموز صيغة Yahoo (مثلًا BRK-B لا BRK.B)؛ بعض البورصات تحتاج لاحقة (.T لطوكيو)

JSONDecodeError

Yahoo حدّد معدلك. توقف بضع دقائق، أو أرسل رموزًا أقل لكل دفعة.

الحزمة قديمة

uvx --upgrade yfinance-mcp — Yahoo يكسر الأشياء بانتظام

البدائل

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

البديل	متى تستخدمها	المقايضة
Alpaca MCP	تريد بيانات وساطة حقيقية + تنفيذ أوامر	يتطلب حساب Alpaca
Polygon / Finnhub	تحتاج بيانات إنتاج درجة أولى وزمن استجابة منخفض	مدفوع؛ لا MCP (بعد)

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

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

عرض مباشر

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

التثبيت

اختر العميل

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

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

لقطة سريعة لقائمة مراقبتك — أسعار، P/E، أخبار

الخطوات

المزالق

اختبر فكرة استراتيجية بسيطة تاريخيًا على الأسعار

الخطوات

المزالق

التركيبات

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

الأدوات

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

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

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

الأمان

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

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

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

البدائل

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

المزيد

الموارد