ماذا تستطيع واجهة finlight أن تفعل

finlight هي واجهة برمجة تطبيقات للأخبار المالية. تأخذ التدفق المستمر والفوضوي لأخبار الأسواق العالمية وتحوّله إلى بيانات نظيفة ومنظمة ومعزّزة بالذكاء الاصطناعي يمكنك الاستعلام عنها أو بثّها أو دفعها إليك. فبدلًا من تجريف المواقع وتحليل HTML بنفسك، تحصل على واجهة موحّدة واحدة مع تحليل المشاعر ووسم الشركات وقدرات فلترة غنية مدمجة.

هذه الصفحة هي الخريطة. تغطي ما تقدّمه لك finlight، والطرق الأربع للحصول عليها، وإلى أين تتجه بعد ذلك. إذا كنت تريد فقط إجراء أول استدعاء لك، فابدأ من دليل البداية السريعة.

ماذا تتضمن كل مقالة

كل مقالة تعيدها finlight منظمة ومعزّزة، وليست مجرد عنوان ورابط. تحصل على:

• الحقول الأساسية: العنوان، الملخص، المحتوى الكامل (اختياري)، المصدر، تاريخ النشر، اللغة، والصور.
• المشاعر: تُقيَّم كل مقالة بـ positive أو neutral أو negative مع درجة ثقة، حتى تتمكن من قياس النبرة بدلًا من قراءة كل خبر.
• كيانات الشركات: تَسِم finlight الشركات التي يدور حولها الخبر وتحلّها إلى معرّفات حقيقية: رمز التداول، ISIN، OpenFIGI، القطاع والصناعة، إضافة إلى كل بورصة أُدرجت فيها الشركة (الإدراج الأساسي والثانوي، مع رمز البورصة والدولة لكل منها).
• التصنيف: تُوسَم كل مقالة بالدول التي تتأثر بها وبتصنيف واحد أو أكثر من 13 تصنيفًا.

هذا يعني أنه بإمكانك الإجابة عن أسئلة مثل "كيف تغيّرت المشاعر حول AAPL هذا الأسبوع؟" أو "أظهر لي كل خبر تنظيمي يؤثر على مجموعة من الشركات" دون أن تبني خط معالجة لغة طبيعية (NLP) بنفسك.

أربع طرق للحصول على البيانات

تتوفر البيانات المعزّزة نفسها عبر أربع طرق للتسليم. تختار الطريقة التي تناسب عبء عملك.

REST API

استعلم عن الأخبار عند الطلب: أرسل طلبًا، وتستعيد صفحة من المقالات المطابقة. الأنسب للبحث، وإعادة تعبئة البيانات التاريخية، ولوحات التحكم المجدولة، وأي مسار عمل قائم على الطلب/الاستجابة. تدعم نقطة النهاية المتقدمة POST /v2/articles مجموعة المرشّحات الكاملة، وهناك أيضًا نقاط نهاية لجلب مقالة واحدة عبر عنوان URL ولسرد المصادر المتاحة. اطّلع على توثيق REST.

WebSocket

بُثّ المقالات في الوقت الفعلي لحظة نشرها، دون استطلاع دوري. ويأتي بنكهتين: بث معزّز بتعزيز كامل (المشاعر والكيانات)، وبث خام خفيف عندما تحتاج فقط إلى الأساسيات بسرعة. مثالي للوحات التحكم الحية وإشارات التداول والمراقبة. اطّلع على توثيق WebSocket.

Webhooks

اجعل finlight تدفع الأخبار إلى نقطة النهاية الخاصة بك لحظة مطابقتها لمرشّحاتك. تتوفر نسخ معزّزة وخام، وتكون عمليات التسليم موقّعة حتى تتمكن من التحقق منها. الأنسب لخطوط الأنابيب المدفوعة بالأحداث، والتنبيهات، والأتمتة التي ينبغي أن تعمل دون استطلاع دوري منك. اطّلع على توثيق webhook.

خادم MCP

اربط finlight بمساعد ذكاء اصطناعي مثل Claude أو ChatGPT عبر Model Context Protocol، ثم اطلب أخبار السوق بلغة طبيعية. الأنسب للبحث والتحليل العابر دون كتابة شيفرة. اطّلع على توثيق مساعدي الذكاء الاصطناعي.

كقاعدة عامة: REST للطلب عند الحاجة، وWebSocket للوقت الفعلي، وwebhooks لأتمتة الدفع، وMCP للبحث المدفوع بالذكاء الاصطناعي. دليل مقارنة مخصص قادم قريبًا.

فلترة دقيقة

تتمحور finlight حول حصولك على الأخبار التي تريدها بالضبط. عبر REST وWebSocket وwebhooks يمكنك الفلترة حسب:

• رموز التداول: شركات مثل AAPL أو NVDA.
• الدول: رموز الدول وفق ISO، للتركيز على أسواق محددة.
• التصنيفات: أيٌّ من الـ 13 تصنيفًا، من markets وeconomy إلى crypto وregulation وenergy.
• المصادر: تضمين أو استبعاد منافذ محددة، أو اختيار مزيد منها.
• النطاقات الزمنية ولغة استعلام كاملة مع معاملات منطقية ومرشّحات حقول، مثل (ticker:AAPL OR ticker:NVDA) AND NOT source:reuters.com.

للاطلاع على صياغة الاستعلام الكاملة، انظر توثيق الاستعلام المتقدم.

تغطية عالمية متعددة اللغات

تغطي finlight الأخبار بـ 9 لغات: الإنجليزية، والصينية المبسّطة، والهندية، والإسبانية، واليابانية، والكورية، والبرتغالية، والعربية، والروسية. وبدمجها مع مرشّحات الدول والتصنيفات، يمكنك متابعة سوق ما بلغته ومنطقته بدلًا من الاعتماد على التغطية بالإنجليزية فقط.

مصمَّمة للمطوّرين

يمكنك استدعاء finlight عبر HTTP المجرّد، أو استخدام حزم SDK الرسمية:

• Node / TypeScript: npm install finlight-client
• Python: pip install finlight-client

كلاهما يغلّف واجهتي REST وWebSocket، ويتولى المصادقة وإعادة المحاولات، ويعيد كائنات ذات أنواع. المصادقة هي مجرد ترويسة X-API-KEY واحدة في كل طلب، باستخدام مفتاح تنشئه في لوحة التحكم. يبدو الطلب الأدنى كالتالي:

curl -X POST https://api.finlight.me/v2/articles \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "tickers": ["AAPL"], "pageSize": 5 }'

الخطط

تقدّم finlight خططًا تبدأ من خطة مجانية للاختبار وصولًا إلى خطة المؤسسات (enterprise)، وتختلف أساسًا في حجم الطلبات، وعمق البيانات التاريخية، والوصول في الوقت الفعلي، وميزات مثل المصادر المخصصة. الخطة المجانية تدعم REST فقط وهي مثالية للتقييم. للاطلاع على الحدود الحالية وما تتيحه كل خطة، انظر finlight.me/pricing.

ابدأ البناء

• جديد هنا؟ اتبع دليل البداية السريعة لإجراء أول استدعاء لك في خمس دقائق.
• جاهز للتعمّق؟ تصفّح التوثيق الكامل.
• أسئلة؟ انضم إلى Discord أو راسلنا عبر info@finlight.me.

احصل على مفتاح واجهة البرمجة المجاني ←