README.ar.md

🌐 اللغة: English | Español | Français | Deutsch | Português | 日本語 | 简体中文 | 繁體中文 | 한국어 | العربية | Русский | Italiano | Nederlands | Polski | Türkçe | Tiếng Việt | ไทย | Bahasa Indonesia

---

🆓 واجهة برمجة تطبيقات أخبار العملات المشفرة المجانية

⭐ إذا وجدت هذا مفيدًا، يرجى إعطاء نجمة للمستودع! هذا يساعد الآخرين على اكتشاف هذا المشروع ويحفز على التطوير المستمر.

---

احصل على أخبار العملات المشفرة في الوقت الفعلي من 7 مصادر رئيسية باستدعاء API واحد.

curl https://news-crypto.vercel.app/api/news

---

المقارنة

	Free Crypto News	CryptoPanic	أخرى
السعر	🆓 مجاني للأبد	$29-299/شهر	مدفوع
مفتاح API	❌ غير مطلوب	مطلوب	مطلوب
حد الطلبات	غير محدود*	100-1000/يوم	محدود
المصادر	12 إنجليزي + 12 دولي	1	متنوع
التدويل	🌏 كوري، صيني، ياباني، إسباني + ترجمة	لا	لا
استضافة ذاتية	✅ نشر بنقرة واحدة	لا	لا
PWA	✅ قابل للتثبيت	لا	لا
MCP	✅ Claude + ChatGPT	لا	لا

---

🌿 الفروع

الفرع	الوصف
main	فرع الإنتاج المستقر — التصميم الأصلي المركز على API
redesign/pro-news-ui	إعادة تصميم واجهة المستخدم المتقدمة — أسلوب CoinDesk/CoinTelegraph مع الوضع الداكن والمكونات المحسنة وبيانات SEO المهيكلة ودعم PWA الكامل

لاختبار إعادة التصميم محليًا:

git checkout redesign/pro-news-ui
npm install && npm run dev

---

🌍 مصادر الأخبار الدولية

احصل على أخبار العملات المشفرة من 12 مصدرًا دوليًا بالكورية والصينية واليابانية والإسبانية — مترجمة تلقائيًا للإنجليزية!

المصادر المدعومة

المنطقة	المصادر
🇰🇷 كوريا	Block Media, TokenPost, CoinDesk Korea
🇨🇳 الصين	8BTC (باييت), Jinse Finance (جينسي), Odaily (أوديلي)
🇯🇵 اليابان	CoinPost, CoinDesk Japan, Cointelegraph Japan
🇪🇸 أمريكا اللاتينية	Cointelegraph Español, Diario Bitcoin, CriptoNoticias

أمثلة سريعة

# الحصول على جميع الأخبار الدولية
curl "https://news-crypto.vercel.app/api/news/international"

# الحصول على أخبار كورية مترجمة للإنجليزية
curl "https://news-crypto.vercel.app/api/news/international?language=ko&translate=true"

# الحصول على أخبار منطقة آسيا
curl "https://news-crypto.vercel.app/api/news/international?region=asia&limit=20"

الميزات

• ✅ ترجمة تلقائية للإنجليزية عبر Groq AI
• ✅ تخزين مؤقت للترجمة 7 أيام للكفاءة
• ✅ الحفاظ على النص الأصلي + الإنجليزي
• ✅ تحديد المعدل (1 طلب/ثانية) احترامًا للـ APIs
• ✅ تراجع سلس للمصادر غير المتاحة
• ✅ إزالة التكرار عبر المصادر

راجع وثائق API للتفاصيل الكاملة.

---

📱 تطبيق ويب تقدمي (PWA)

Free Crypto News هو PWA قابل للتثبيت بالكامل يعمل دون اتصال.

الميزات

الميزة	الوصف
📲 قابل للتثبيت	أضف إلى الشاشة الرئيسية على أي جهاز
📴 وضع دون اتصال	اقرأ الأخبار المخزنة مؤقتًا بدون شبكة
🔔 إشعارات الدفع	تلقي تنبيهات الأخبار العاجلة
⚡ سريع جدًا	استراتيجيات تخزين مؤقت عدوانية
🔄 مزامنة في الخلفية	تحديث تلقائي عند العودة للاتصال
🎯 اختصارات	وصول سريع للأحدث والشائع وبيتكوين
📤 مشاركة	مشاركة الروابط مباشرة في التطبيق
🚨 تنبيهات فورية	تنبيهات قابلة للتكوين للسعر وشروط الأخبار

تثبيت التطبيق

سطح المكتب (Chrome/Edge):

1. قم بزيارة news-crypto.vercel.app
2. انقر على أيقونة التثبيت (⊕) في شريط URL
3. انقر "تثبيت"

iOS Safari:

1. قم بزيارة الموقع في Safari
2. اضغط على مشاركة (📤) → "إضافة إلى الشاشة الرئيسية"

Android Chrome:

1. قم بزيارة الموقع
2. اضغط على لافتة التثبيت أو القائمة → "تثبيت التطبيق"

تخزين Service Worker المؤقت

يستخدم PWA استراتيجيات تخزين ذكية:

المحتوى	الاستراتيجية	مدة التخزين
استجابات API	Network-first	5 دقائق
الأصول الثابتة	Cache-first	7 أيام
الصور	Cache-first	30 يومًا
التنقل	Network-first + احتياطي دون اتصال	24 ساعة

اختصارات لوحة المفاتيح

تنقل سريع عبر الأخبار باستخدام لوحة المفاتيح:

الاختصار	الإجراء
j / k	المقال التالي / السابق
/	تركيز البحث
Enter	فتح المقال المحدد
d	تبديل الوضع الداكن
g h	الذهاب للرئيسية
g t	الذهاب للشائع
g s	الذهاب للمصادر
g b	الذهاب للمفضلة
?	عرض جميع الاختصارات
Escape	إغلاق النافذة المنبثقة

📖 دليل المستخدم الكامل: docs/USER-GUIDE.md

---

المصادر

نجمع من 7 وسائل إعلام موثوقة:

• 🟠 CoinDesk — أخبار العملات المشفرة العامة
• 🔵 The Block — المؤسسات والأبحاث
• 🟢 Decrypt — Web3 والثقافة
• 🟡 CoinTelegraph — أخبار العملات المشفرة العالمية
• 🟤 Bitcoin Magazine — متطرفو البيتكوين
• 🟣 Blockworks — DeFi والمؤسسات
• 🔴 The Defiant — DeFi الأصلي

---

نقاط النهاية

نقطة النهاية	الوصف
/api/news	آخر الأخبار من جميع المصادر
/api/search?q=bitcoin	البحث بكلمة مفتاحية
/api/defi	أخبار متعلقة بـ DeFi
/api/bitcoin	أخبار متعلقة بـ Bitcoin
/api/breaking	آخر ساعتين فقط
/api/trending	المواضيع الرائجة مع تحليل المشاعر
/api/analyze	الأخبار مع تصنيف المواضيع
/api/stats	التحليلات والإحصائيات
/api/sources	قائمة جميع المصادر
/api/health	حالة صحة API والخلاصات
/api/rss	خلاصة RSS مجمعة
/api/atom	خلاصة Atom مجمعة
/api/opml	تصدير OPML لقارئات RSS
/api/docs	وثائق API تفاعلية
/api/webhooks	تسجيل webhooks
/api/archive	أرشيف الأخبار التاريخية
/api/push	إشعارات Web Push
/api/origins	العثور على المصدر الأصلي للأخبار
/api/portfolio	أخبار مبنية على المحفظة + الأسعار
/api/news/international	مصادر دولية مع ترجمة

🤖 نقاط نهاية مدعومة بالذكاء الاصطناعي (مجاني عبر Groq)

نقطة النهاية	الوصف
/api/digest	ملخص يومي مُنشأ بالذكاء الاصطناعي
/api/sentiment	تحليل مشاعر السوق
/api/summarize?url=	تلخيص أي URL
/api/ask	اسأل الذكاء الاصطناعي عن أخبار العملات المشفرة
/api/entities	استخراج الكيانات المذكورة
/api/claims	التحقق من الادعاءات
/api/clickbait	اكتشاف العناوين المضللة

💹 نقاط نهاية السوق

نقطة النهاية	الوصف
/api/fear-greed	مؤشر الخوف والطمع مع بيانات تاريخية
/api/arbitrage	فرص المراجحة عبر البورصات
/api/signals	إشارات تداول تقنية
/api/funding	معدلات التمويل عبر بورصات المشتقات
/api/options	تدفق الخيارات وأقصى ألم
/api/liquidations	بيانات التصفية في الوقت الفعلي
/api/whale-alerts	تتبع صفقات الحيتان
/api/orderbook	بيانات دفتر الطلبات المجمعة

---

البداية السريعة

استخدام cURL

# الحصول على آخر الأخبار
curl "https://news-crypto.vercel.app/api/news"

# البحث في الأخبار
curl "https://news-crypto.vercel.app/api/search?q=ethereum"

# الحصول على ملخص AI
curl "https://news-crypto.vercel.app/api/digest"

# الحصول على مؤشر الخوف والطمع
curl "https://news-crypto.vercel.app/api/fear-greed"

استخدام JavaScript

// الحصول على آخر الأخبار
const response = await fetch('https://news-crypto.vercel.app/api/news');
const data = await response.json();

console.log(data.articles);
// [{ title, link, source, pubDate, timeAgo, ... }, ...]

استخدام Python

import requests

# الحصول على آخر الأخبار
response = requests.get('https://news-crypto.vercel.app/api/news')
data = response.json()

for article in data['articles'][:5]:
    print(f"• {article['title']} ({article['source']})")

---

الاستضافة الذاتية

نشر بنقرة واحدة

التثبيت المحلي

# استنساخ المستودع
git clone https://github.com/nirholas/free-crypto-news.git
cd free-crypto-news

# تثبيت التبعيات
npm install

# تشغيل خادم التطوير
npm run dev

# افتح http://localhost:3000

متغيرات البيئة

# اختياري: لميزات AI (مجاني من groq.com)
GROQ_API_KEY=gsk_your_key_here

# اختياري: التحليلات
NEXT_PUBLIC_ANALYTICS_ID=your_id

---

الوثائق

الوثيقة	الوصف
📚 مرجع API	وثائق نقاط النهاية الكاملة
🏗️ الهندسة	تصميم النظام
🚀 النشر	دليل الإنتاج
🧪 الاختبار	دليل الاختبار
🔐 الأمان	سياسة الأمان
📖 دليل المستخدم	دليل PWA والميزات
💻 دليل المطور	وثائق المساهمين

---

المساهمة

المساهمات مرحب بها! راجع CONTRIBUTING.md للإرشادات.

# Fork المستودع
# إنشاء فرع الميزة
git checkout -b feature/amazing-feature

# تنفيذ التغييرات
git commit -m 'Add amazing feature'

# الدفع وإنشاء Pull Request
git push origin feature/amazing-feature

---

الترخيص

MIT License - راجع ملف LICENSE.

---

التواصل

• 🐛 الأخطاء: GitHub Issues
• 💬 النقاشات: GitHub Discussions
• 🐦 Twitter: @nirholas

---

صُنع بـ ❤️ لمجتمع العملات المشفرة
news-crypto.vercel.app