/ الدليل / الملعب / SEC EDGAR MCP
← كل الخوادم ↗ GitHub
● مجتمع stefanoamorelli ⚡ فوري

SEC EDGAR MCP

بواسطة stefanoamorelli · stefanoamorelli/sec-edgar-mcp

إيداعات الولايات المتحدة المؤرضة في متناول وكيلك - بحث CIK، 10-K/10-Q/8-K، بيانات XBRL المالية، نموذج 3/4/5 من الصفقات الداخلية، كل إجابة قابلة للربط بمصدر هيئة الأوراق المالية والبورصات.

يمنح sec-edgar-mcp الوكلاء وصولاً منظمًا إلى نظام EDGAR الخاص بهيئة الأوراق المالية والبورصات. فهو يحل الشركات عن طريق شريط أو اسم إلى CIK، ويسحب ملفات محددة (10-K، 10-Q، 8-K)، ويستخرج الأقسام، ويوزع XBRL في الميزانية العمومية / بيان الدخل / التدفق النقدي، ويظهر التداول الداخلي (النموذج 3/4/5). يتضمن كل رد عناوين URL لـ SEC حتى تتمكن من التحقق من الرقم بنفسك. البيانات العامة فقط - لا يلزم وجود مفتاح API بخلاف وكيل المستخدم المتوافق.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

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

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

عرض مباشر

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

sec-edgar-mcp.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "sec-edgar-mcp",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "sec-edgar-mcp": {
      "command": {
        "path": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
          "stefanoamorelli/sec-edgar-mcp:latest"
        ]
      }
    }
  }
}

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

claude mcp add sec-edgar-mcp -- docker run -i --rm -e 'SEC_EDGAR_USER_AGENT=Your Name ([email protected])' stefanoamorelli/sec-edgar-mcp:latest

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

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

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

قم بقراءة سريعة 10K مع الأرقام والاستشهادات الدقيقة

👤 المحللون والمستثمرون والصحفيون الذين يغطون الشركات العامة ⏱ ~30 min intermediate

متى تستخدمه: أنت بحاجة لقراءة 10K بعد ظهر هذا اليوم، وليس هذا الأسبوع.

المتطلبات الأساسية
  • SEC_EDGAR_USER_AGENT محدد باسمك وبريدك الإلكتروني — تتطلب هيئة الأوراق المالية والبورصة (SEC) وكيل مستخدم يمكن الاتصال به للوصول البرمجي
الخطوات
  1. حل الشركة
    ابحث عن CIK لـ Microsoft.✓ تم النسخ
    → تم إرجاع CIK 0000789019
  2. سحب أحدث 10-K
    احصل على أحدث 10-K واستخرج قسم عوامل الخطر.✓ تم النسخ
    → تم إرجاع قسم عوامل الخطر مع عنوان URL للإيداع
  3. سحب الأرقام
    استخراج الميزانية العمومية وقائمة الدخل للعام المالي 2025.✓ تم النسخ
    → تنظيف الصفوف بالقيم + الوحدات + عنوان URL للإيداع

النتيجة: قراءة سهلة الهضم بحجم 10K مع روابط يمكن التحقق منها تعود إلى EDGAR.

المزالق
  • الخلط بين السنوات المالية والتقويمية — قم دائمًا بطباعة الفترة المالية في الإجابة حتى يتمكن المستخدمون من التحقق من سلامة الأمور
اجمعها مع: yahoo-finance

تتبع المعاملات الداخلية لقائمة المراقبة

👤 المستثمرون يتبعون المشاعر الداخلية ⏱ ~20 min intermediate

متى تستخدمه: تريد ملخصًا يوميًا عن نشاط النموذج 4 لقائمة المراقبة الخاصة بك.

الخطوات
  1. قائمة المطلعين على كل شريط
    بالنسبة إلى AAPL وMSFT وNVDA - قم بسحب معاملات النموذج 4 في آخر 30 يومًا.✓ تم النسخ
    → صفوف تحتوي على اسم المطلعين، والدور، والشراء/البيع، والأسهم، والسعر، والتاريخ
  2. إجمالي
    تلخيص صافي الشراء من الداخل مقابل البيع لكل شريط.✓ تم النسخ
    → سطر واحد لكل شريط مع اتجاه صافي

النتيجة: ملخص داخلي واضح دون كشط EDGAR باليد.

المزالق
  • حساب المعاملات المتعلقة بالخيارات على أنها "عمليات شراء" — تصفية رموز المعاملات؛ P/S مقابل A/M/D المسألة
اجمعها مع: alpaca

قم بتلخيص تسجيلات 8-K اليوم في قائمة المراقبة

👤 غرف الأخبار، فرق تطوير الشركات، علاقات المستثمرين ⏱ ~10 min beginner

متى تستخدمه: حدث شيء مادي؛ تريد ملخصًا باللغة الإنجليزية البسيطة بسرعة.

الخطوات
  1. سحب 8-Ks الأخيرة
    اسحب ملفات 8K اليوم للمؤشرات في قائمة المراقبة الخاصة بي.✓ تم النسخ
    → لكل ملف: رموز العناصر + الرابط
  2. تلخيص
    لكل ملخص، جملة واحدة باللغة الإنجليزية البسيطة مع رمز العنصر.✓ تم النسخ
    → مسح الملخص باستخدام عنوان URL لـ SEC

النتيجة: ملخص قائمة المراقبة الذي يمكنك الوثوق به والارتباط به.

اجمعها مع: fetch

قارن بين البيانات المالية لشركتين جنبًا إلى جنب

👤 محللو الأسهم، والطلاب يبنون النماذج ⏱ ~20 min intermediate

متى تستخدمه: أنت بحاجة إلى مقارنة سريعة بين التفاح والتفاح.

الخطوات
  1. سحب XBRL لكلا الشركتين
    احصل على الإيرادات وإجمالي الربح والدخل التشغيلي وصافي الدخل لـ AAPL وMSFT للسنة المالية 2024.✓ تم النسخ
    → تمت محاذاة الجدول مع الوحدات وعناوين URL للإيداع
  2. فرق الهوامش
    حساب ومقارنة الهوامش الإجمالية والتشغيلية.✓ تم النسخ
    → الهوامش جنبًا إلى جنب؛ رابط لكل الايداع

النتيجة: مقارنة يمكن الدفاع عنها مع عناوين URL المصدرية الدقيقة.

اجمعها مع: antv-chart

التركيبات

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

sec-edgar-mcp + yahoo-finance

قم بإقران أساسيات SEC مع أسعار السوق الحالية

اسحب صافي دخل MSFT الأخير البالغ 10 آلاف والقيمة السوقية اليوم؛ حساب المضاعفات الضمنية.✓ تم النسخ
sec-edgar-mcp + alpaca

استخدم الإشارات الداخلية كشاشة

بالنسبة للمؤشرات التي تتضمن عمليات شراء من الداخل خلال آخر 30 يومًا، قم بإدراج الأسعار الحالية من Alpaca.✓ تم النسخ
sec-edgar-mcp + antv-chart

رسم أرقام XBRL المستخرجة

اسحب 5 سنوات من الإيرادات وقم برسمها باستخدام مخطط antv.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
lookup_cik ticker_or_name: str الخطوة الأولى لأي استفسار عن الشركة 1 SEC request
get_company_facts cik: str اكتشف ما هي البنود التي تم الإبلاغ عنها 1 SEC request
get_filings cik: str, form_type: str, limit?: int سحب ملفات 10-K / 10-Q / 8-K 1 SEC request
extract_section accession_number: str, section: str اقرأ قسمًا محددًا (على سبيل المثال، عوامل الخطر، MD&A) 1 SEC request
get_financials cik: str, period: str البيانات المالية المنظمة مع الوحدات 1 SEC request
get_insider_transactions cik: str, days?: int نموذج 3/4/5 نشاط 1 SEC request

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

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

حصة API
حد معدل SEC: ~10 طلبات/ثانية لكل IP - احترمه
الرموز لكل استدعاء
صغيرة بالنسبة للبيانات الوصفية، يمكن أن تكون الملفات كبيرة جدًا (عشرات الآلاف من الرموز المميزة)
التكلفة المالية
مجاني — EDGAR عام
نصيحة
استخدم extract_section بدلاً من تفريغ الملف بأكمله؛ عادة ما تكون أقسام MD&A أو عوامل الخطر وحدها كافية.

الأمان

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

تخزين بيانات الاعتماد: يقوم SEC_EDGAR_USER_AGENT بتعريفك لدى SEC؛ استخدم الاسم الحقيقي والبريد الإلكتروني الذي يمكن الاتصال به. لا تلزم بريدك الإلكتروني الشخصي بتكوين مشترك.
نقل البيانات الخارجي: جميع المكالمات تذهب إلى sec.gov. لا توجد خدمات خارجية في التكوين الافتراضي.

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

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

403 من sec.gov

وكيل المستخدم الخاص بك مفقود أو مشوه. يتطلب SEC تنسيق "الاسم ([email protected])".

تحقق: echo $SEC_EDGAR_USER_AGENT
سعر محدود (429)

التراجع إلى أقل من 10 متطلبات/ثانية. الدفعة بواسطة CIK بدلاً من إصدار العديد من المكالمات المتوازية.

تحقق: Inspect headers on the failing response
لم يتم العثور على مفهوم XBRL

لا يجوز للشركة الإبلاغ عن هذا المفهوم. استخدم get_company_facts لمعرفة المفاهيم الموجودة.

تحقق: get_company_facts(cik) and grep for the concept

البدائل

SEC EDGAR MCP مقابل البدائل

البديلمتى تستخدمهاالمقايضة
yahoo-financeتريد عروض الأسعار + الأساسيات الأساسية بدون دقة على مستوى SECأقل موثوقية؛ لا برادة مباشرة
alpacaأنت بحاجة إلى بيانات سوق الوساطة والتداوللا برادة. شكل مختلف للبيانات

المزيد

الموارد

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

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

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