عن المشروع

stock-api هي أداة TypeScript لبيانات الأسهم بدون تبعيات وقت التشغيل، مناسبة لـ Node.js والمتصفح وسطر الأوامر وعملاء الذكاء الاصطناعي الذين يدعمون MCP. يتطلب إصدار Node.js >= 18، وبعد التثبيت يمكن استخدام stocks.auto للحصول على بيانات سهم واحد أو عدة أسهم، وK-line، والبحث عن الأسهم؛ كما يمكن استخدام stocks.tencent أو stocks.sina أو stocks.eastmoney بشكل صريح. تستخدم رموز الأسهم بادئات SH وSZ وHK وUS، وتشمل الأمثلة SH510500 وSZ000651 وغيرها. على جانب المتصفح، يمكن تضمين بناء IIFE عبر CDN ثم استدعاء StockApi.stocks.auto؛ ويدعم CLI أوامر مثل npx stock-api get-stock وget-stocks وget-klines وsearch-stocks. يتم تشغيل وضع MCP عبر npx -y stock-api mcp، ويتضمن أدوات get_stock وget_stocks وget_klines وsearch_stocks وinspect_stock، ويدعم التفاوض على إصدارات البروتوكول 2025-11-25 و2025-06-18. يعمل stocks.auto الافتراضي بالتجاوز التلقائي بترتيب Tencent ثم Sina ثم Eastmoney. يوفر Tencent وSina قدرات البيانات وبيانات الدفعات وK-line والبحث والتشخيص؛ ويدعم Eastmoney بشكل أساسي القدرات المتعلقة بأسهم A، وقد تفشل واجهة البحث الخاصة به في بعض بيئات الشبكات الخارجية بسبب استجابة مكافحة الزحف، ويمكن لوضع auto التجاوز إلى مصادر بيانات أخرى. تغطي وثائق المشروع API وCLI والبنية والتطوير ومراقبة مصادر البيانات. تأتي البيانات من واجهات بيانات عامة تابعة لجهات خارجية، ولا يضمن المشروع دقة البيانات أو اكتمالها أو تحديثها في الوقت الفعلي أو استمرار توفرها، ولا يقدم نصائح استثمارية؛ وقبل الاستخدام التجاري أو عالي التردد أو الإنتاجي يجب التحقق بنفسك من ترخيص مصدر البيانات ومتطلبات الامتثال. الكود مرخص بموجب MIT.