نظام متكامل مبني بلغة Python يعمل تلقائياً كل يوم عبر استضافة GitHub Actions المجانية. يقوم النظام بتجميع بيانات حيوية يومية (مواقيت الصلاة، الطقس، الذهب، العملات) وإرسالها في رسالة منسقة وجميلة إلى منصتي Telegram و WhatsApp.
لا يحتاج هذا المشروع إلى سيرفر مدفوع أو استضافة خارجية؛ فهو يعتمد بالكامل على ميزة GitHub Actions.
- يوجد ملف إعدادات في مسار
.github/workflows/schedule.yml. - هذا الملف يحتوي على مؤقت زمني (Cron Job) مبرمج لتشغيل كود البايثون يومياً في ساعة محددة.
- يقوم كود البايثون بالاتصال بعدة واجهات برمجية (APIs) لجلب البيانات المحدثة.
- يجمع الكود البيانات، ينسقها، ويرسلها لك عبر بوت تليجرام وبوت CallMeBot للواتساب.
- يتوقف السيرفر فوراً بعد الإرسال للحفاظ على الموارد المجانية.
- 🕋 الدين والتاريخ: التاريخ الهجري والميلادي، مواقيت الصلاة بتوقيت القاهرة، وحساب دقيق لموعد بداية الثلث الأخير من الليل.
- 🌤️ الطقس: حالة الطقس المتوقعة لليوم في القاهرة مع درجتي الحرارة (العظمى والصغرى).
- 💰 الذهب: أسعار الذهب الحية في مصر (عيار 24 وعيار 21) بالجنيه المصري.
- 💵 العملات: أسعار الصرف المحدثة للدولار الأمريكي والريال السعودي مقابل الجنيه المصري.
للحفاظ على أمان حساباتك، يجب عدم كتابة أي مفاتيح سرية داخل الكود. بدلاً من ذلك، نستخدم ميزة Secrets في GitHub.
خطوات الإضافة:
- اذهب إلى صفحة المستودع (Repository) واضغط على Settings (الإعدادات).
- من القائمة الجانبية اليسرى، انزل لأسفل واضغط على Secrets and variables ثم اختر Actions.
- اضغط على الزر الأخضر New repository secret.
- أضف المتغيرات التالية (يجب أن يكون الاسم متطابقاً تماماً مع الجدول):
| اسم المتغير (Name) | القيمة (Secret) | كيفية الحصول عليه |
|---|---|---|
TELEGRAM_BOT_TOKEN |
التوكن الخاص بالبوت | من خلال المحادثة مع @BotFather في تليجرام. |
TELEGRAM_CHAT_ID |
معرف المحادثة الخاص بك | من خلال المحادثة مع @userinfobot في تليجرام. |
CALLMEBOT_PHONE |
رقم هاتفك للواتساب | رقمك مسبوقاً بكود الدولة (مثال: 2010...) |
CALLMEBOT_APIKEY |
مفتاح API الواتساب | احصل عليه مجاناً من موقع CallMeBot. |
GOLD_API_KEY |
مفتاح أسعار الذهب | سجل مجاناً في GoldAPI.io وانسخ الـ API Key. |
يعتمد المشروع على واجهات برمجية مجانية وموثوقة:
- Aladhan API: لجلب التاريخ الهجري ومواقيت الصلاة (لا يحتاج مفتاح).
- Open-Meteo: لجلب بيانات الطقس الدقيقة بدون الحاجة لتسجيل أو مفتاح.
- ExchangeRate-API: لجلب أسعار العملات العالمية (لا يحتاج مفتاح).
- GoldAPI.io: لجلب سعر أونصة الذهب عالمياً، ويقوم الكود بتحويلها لجرامات عيار 24 و 21. (يمنح 100 طلب مجاني شهرياً، والبوت يستهلك 30 فقط).
يتم إرسال الرسالة تلقائياً كل يوم. لتعديل التوقيت:
- افتح ملف
.github/workflows/schedule.yml. - ابحث عن السطر:
- cron: '0 22 * * *' - التوقيت هنا يعمل بنظام UTC (توقيت جرينتش).
0 22تعني الساعة 22:00 بتوقيت جرينتش (أي الساعة 1:00 صباحاً بتوقيت مصر الصيفي).- إذا أردت الرسالة الساعة 7:00 صباحاً بتوقيت مصر، اجعلها:
0 4 * * *.
لا داعي للانتظار لليوم التالي لتجربة البوت، يمكنك تشغيله فوراً:
- من أعلى صفحة المستودع، اضغط على تبويب Actions.
- من القائمة اليسرى، اختر اسم سير العمل Daily Auto Report.
- على اليمين، اضغط على القائمة المنسدلة Run workflow.
- اضغط على الزر الأخضر Run workflow.
- انتظر ثوانٍ، وستصلك الرسالة على تليجرام وواتساب! 🎉
تم تطوير هذا السكربت ليكون خفيفاً، آمناً، ويعمل بشكل مجاني 100% للأبد.