عن المشروع

تغلّف global-stock-data الوصول إلى بيانات الأسهم الأمريكية وسوق هونغ كونغ في ملف SKILL.md واحد يحتوي على تعليمات Markdown وPython مضمّن. وهو مصمم لمساعدي البرمجة بالذكاء الاصطناعي مثل Claude Code وCodex وOpenClaw، لكن يمكن أيضًا نسخ Python إلى نصوص برمجية عادية. يتطلب المشروع Python 3.9+ ومكتبة requests؛ ولا يلزم مفتاح API منفصل. تتم أتمتة التعامل مع ملف تعريف ارتباط/فتات Yahoo، بينما يتطلب SEC EDGAR تعريف User-Agent معلنًا بمعلومات اتصال حقيقية. تتوزع مجموعة الأدوات على 13 طبقة. توفر نقاط نهاية بيانات السوق أسعارًا أمريكية/هونغ كونغية من Sina وTencent وEastmoney، مع 25–78 حقلًا حسب المصدر. يشمل دعم K-line فواصل يومية وأسبوعية وشهرية ودقيقة، مع تاريخ Sina/Yahoo للرموز الأمريكية يصل إلى 1984. تُحسب المؤشرات الفنية—MA وEMA وMACD وRSI وKDJ وBollinger Bands—محليًا دون تبعيات إضافية. تشمل البيانات الأساسية قوائم Eastmoney والمؤشرات الرئيسية، ووحدات Yahoo quoteSummary التي تغطي البيانات المالية والمحللين والحيازات المؤسسية، وبيانات SEC XBRL مع 503 مقاييس GAAP. يُستخدم Eastmoney أيضًا لتدفق الأموال اليومي لأوامر الشراء الكبيرة والمتوسطة والصغيرة. تغطي الوظائف المساعدة البحث عن الأسهم وقوائم السوق الأمريكية/الهونغ كونغية وأخبار الرموز وربط الرمز بـCIK. يركز الإصدار 2.0 على أولوية المصادر الرسمية. يوفر دعم خيارات CBOE سلسلة كاملة وتقلبًا ضمنيًا وdelta وgamma وvega وtheta وrho وتصفية 0DTE واكتشاف التدفق غير المعتاد بناءً على الحجم/الفائدة المفتوحة؛ ويتوفر Yahoo كسلسلة احتياطية دون Greeks. يوفر FINRA Reg SHO حجم البيع المكشوف اليومي على مستوى السوق وسلاسل لكل رمز وترتيب النسب. تشمل ميزات SEC EDGAR الوصول في نفس اليوم إلى الفهرس اليومي لنماذج مثل Form 4 و8-K و13F و144، والبحث النصي الكامل حتى 2001، وقوائم الإيداعات، والبيانات المالية XBRL المهيكلة. تُستخدم إطارات EDGAR كأداة فحص على مستوى السوق لأي وسم XBRL. تغطي نقاط نهاية الاقتصاد الكلي والتقويم منحنى عائد الخزانة الأمريكية وتقارير CFTC Commitments of Traders وتقويمات أرباح Nasdaq. من الميزات البارزة وسم الامتثال للمصدر. تغطي الطبقة S مصادر SEC EDGAR والخزانة الأمريكية وCFTC الموصوفة بأنها مناسبة للاستخدام التجاري وإعادة التوزيع ضمن قواعدها. FINRA في الطبقة B وينصح README بالتحقق قبل الاستخدام التجاري. أما CBOE وNasdaq وYahoo وEastmoney وSina وTencent فهي في الطبقة C لأن شروطها تتطلب موافقة أو تحصر الاستخدام في الأغراض الشخصية/البحثية أو لم يتم التحقق منها. يذكر المشروع أنه يوزع الكود لا بيانات السوق، وينصح بالاعتماد فقط على مصادر الطبقة S للاستخدام التجاري، ولا يتضمن أي كاشط HKEX بسبب قيود ذلك المصدر. تستخدم الطلبات HTTP مباشرًا ومحدد معدل آمن للخيوط مدمجًا، مع تحديد حركة SEC دون الحد المعلن لـEDGAR. المستودع مرخص بApache-2.0 ويتضمن إخلاء مسؤولية بأنه أداة وصول إلى البيانات وليس نصيحة استثمارية.