شرح daily_stock_analysis: تقارير أسهم بالذكاء الاصطناعي وإشعارات تلقائية

بدل ما تفتح مصادر كتير عشان تتابع قائمة أسهم، تخيل نظام يجمع بيانات السوق والأخبار، ويحوّلها لتقرير تقدر تراجعه، ثم يبعته تلقائيًا على Telegram أو الإيميل. دي فكرة مشروع daily_stock_analysis من ZhuLinsen، وهو نظام مفتوح المصدر بيستخدم نماذج الذكاء الاصطناعي في إعداد تقارير متابعة الأسهم.

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

إيه هو daily_stock_analysis؟

هو نظام لتحليل قائمة متابعة أسهم باستخدام بيانات الأسعار والمؤشرات والأخبار، مع نموذج لغوي يساعد في صياغة تقرير منظم. المشروع بيوفر واجهة ويب، وطرق تشغيل محلية أو عبر Docker أو GitHub Actions، وإرسال النتائج إلى قنوات إشعارات متعددة.

التوثيق يذكر دعم أسهم الصين A-shares وهونج كونج وأمريكا واليابان وكوريا وتايوان، وبعض صناديق ETF. لكن كلمة «دعم» لا تعني إن كل البيانات والخصائص متاحة بنفس المستوى في كل سوق، ولا توجد في المصادر اللي راجعناها إتاحة موثقة للبورصة المصرية أو السعودية.

أهم مميزات المشروع

تقارير تجمع البيانات والأخبار

التقرير قد يتضمن ملخصًا واتجاهًا وتقييمًا وتنبيهات مخاطر وعوامل مؤثرة، وقد يعرض مستويات دخول وخروج يقترحها النظام. دي مخرجات تحليل آلي قابلة للخطأ، وليست أوامر تداول أو دليلًا على دقة توقع حركة السعر.

مصادر متعددة للبيانات

المشروع يربط مصادر مثل AkShare وTushare وBaostock وYFinance وLongbridge، مع اختلاف التغطية حسب السوق. وممكن تضيف مزود بحث أخبار مثل Tavily أو Brave أو SerpAPI وفق إعداداتك واشتراكاتك.

اختيار مزود نموذج الذكاء الاصطناعي

التوثيق يذكر Gemini وClaude وخدمات متوافقة مع OpenAI ونماذج أخرى، بجانب Ollama محليًا. اختيار مزود متوافق لا يعني أن كل موديل هيقدم نفس جودة التقرير؛ لازم تختبره على مصادر قابلة للمراجعة وتتابع تكلفة الاستخدام.

لوحة ويب وسجل تقارير

واجهة العمل تشمل تشغيل التحليل يدويًا، ومتابعة تقدم المهمة، والتقارير السابقة، وعرض Markdown، وإدارة إعدادات. ويذكر المشروع وظائف للمحافظ والاختبارات التاريخية واستيراد البيانات، لكن اكتمال البيانات والتقييم بيختلف حسب السوق.

محادثة وإشعارات

يوجد Agent للمناقشة وطرح أسئلة متابعة، مع 15 استراتيجية مدمجة بحسب README. وتقدر ترسل التقارير إلى Telegram أو Discord أو Slack أو البريد وخدمات أخرى. عدد الاستراتيجيات وحده مش مقياسًا لجودة التحليل أو ربحيته.

إزاي تشغله باستخدام GitHub Actions؟

1. اعمل Fork من المستودع الرسمي لحسابك.
2. افتح Settings ثم Secrets and variables ثم Actions، وأضف إعدادات الربط في Repository Secrets.
3. جهّز مزود AI واحدًا على الأقل؛ مثل GEMINI_API_KEY أو ANTHROPIC_API_KEY، أو إعدادات مزود متوافق تشمل المفتاح والموديل والعنوان عند الحاجة.
4. حدّد قائمة المتابعة عبر STOCK_LIST. ابدأ برمز واحد مدعوم وراجع صياغته في دليل السوق.
5. اضبط قناة إشعارات؛ مثل TELEGRAM_BOT_TOKEN وTELEGRAM_CHAT_ID عند استخدام Telegram.
6. فعّل Workflow وشغّله يدويًا أول مرة، ثم راجع السجل والتقرير قبل ترك التشغيل المجدول.

الإعداد الافتراضي المذكور في التوثيق يشغّل المهمة أيام الأسبوع الساعة 18:00 بتوقيت بكين، مع التحقق من أيام التداول. راجع إعداد الجدولة الفعلي في نسختك وعدّله حسب احتياجك؛ ده مش موعد إغلاق موحدًا للأسواق المختلفة.

هل التشغيل مجاني بالكامل؟

المشروع بترخيص MIT وبيتيح تشغيلًا مجدولًا من غير استئجار سيرفر منفصل عند استخدام GitHub Actions. لكن ده لا يضمن تكلفة صفر لكل المستخدمين: راجع حدود Actions في حسابك، ورسوم مزود AI، وخدمات الأخبار والبيانات، وأي استضافة تختارها.

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

تشغيل محلي على جهازك

المتطلب المعلن هو Python 3.10 أو أحدث. داخل بيئة افتراضية مناسبة، خطوات البداية في التوثيق تشمل:

git clone https://github.com/ZhuLinsen/daily_stock_analysis.git
cd daily_stock_analysis
pip install -r requirements.txt
cp .env.example .env

عدّل ملف .env بإعداداتك قبل تشغيل التحليل:

python main.py

ولواجهة الويب، يعرض README أمر:

python main.py --webui-only

بعد تشغيل الواجهة محليًا، العنوان الموثق هو http://127.0.0.1:8000. إعدادات الوصول من سيرفر بعيد والمصادقة تحتاج اتباع الدليل الكامل. الأوامر هنا للتوضيح ولم يتم تنفيذها على جهازك أو ربط حساباتك المالية.

حدود دعم الأسواق وجودة البيانات

الأسهم اليابانية والكورية تستخدم رموز Yahoo Finance ذات اللواحق، مثل 7203.T و005930.KS. والأسهم التايوانية تحتاج لواحق صريحة مثل 2330.TW أو 6488.TWO حسب السوق. الرموز دي أمثلة تقنية للصياغة، وليست ترشيحات استثمارية.

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

قبل قراءة استنتاج النموذج، راجع اسم السوق والعملة وتاريخ البيانات ومصدرها والحقول المفقودة. تقرير مرتب لغويًا ممكن يظل مبنيًا على مدخلات ناقصة.

مثال عملي: تقرير متابعة يصل إلى Telegram

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

الهدف من المثال هو تقليل شغل جمع المعلومات المتكرر، وليس تفويض قرار مالي للنموذج. ولو حابب تفهم فكرة ربط الخدمات والجدولة، اقرأ شرح n8n والأتمتة للمبتدئين؛ المشروع نفسه له طرق تشغيل مستقلة ولا يشترط n8n.

أسئلة شائعة

هل المشروع بيتداول بدلًا مني؟

الوظائف الموصوفة هنا تخص التقارير والتحليل والمتابعة والإشعارات. لا تتعامل مع ظهور مستويات شراء وبيع في التقرير على إنه تنفيذ فعلي لصفقات.

هل يدعم كل البورصات؟

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

هل نتائج الاختبار التاريخي تضمن أرباحًا؟

لا. النتائج التاريخية لا تضمن الأداء المستقبلي، وجودة الاختبار تعتمد على البيانات والافتراضات والتكاليف وطريقة التقييم. تقارير AI مخصصة للمراجعة والبحث، وليست بديلًا عن التقييم المالي المستقل.

المصادر الرسمية

راجع مستودع daily_stock_analysis، والدليل الإنجليزي، وحدود دعم الأسواق، ودليل الإعداد والتشغيل. المشروع نفسه يوضح أنه للتعلم والبحث ولا يقدم نصيحة استثمارية.