simonlin1212/global-stock-data

解決的問題

本專案提供一個全面的工具包，用於存取美國與香港股票市場資料，消除開發者手動處理複雜驗證流程、股票代碼對應與碎片化資料來源的需要。專為整合至AI程式助手（如 Claude Code、Codex 或 OpenClaw）作為「技能」而設計，讓AI能透過Python程式碼直接取得即時報價、財務資料與文件。

如何運作

本專案以單一自包含的「技能」檔案（SKILL.md）形式組織，包含Markdown與內嵌的Python程式碼。使用 requests 套件從11個不同來源取得資料，包括官方政府資料來源（SEC EDGAR、美國財政部、CFTC）與金融平台（Yahoo Finance、CBOE、FINRA、Eastmoney、Sina、Tencent）。內建線程安全的速率限制器，確保遵守各來源的限制，例如SEC的每秒10次請求上限。

適用對象

希望自動化金融分析、追蹤期權流動或根據SEC文件篩選公司的開發者與AI使用者，且使用AI程式助手執行這些任務者。

主要亮點

• 全面的資料覆蓋：可存取即時報價、K線圖（回溯至1984年）、基本面資料與宏觀資料（國債收益率曲線、COT報告）。
• 官方來源優先：包含來自CBOE（期權希腊值與0DTE流動）、FINRA（市場整體空頭持倉量）與SEC EDGAR（文件與XBRL指標）的高保真資料。
• AI原生整合：專為AI助手設計為「技能」，允許其呼叫端點執行如「顯示NVDA的0DTE期權流動」等任務。
• 合規分級：明確依商業與再分發條款對資料來源進行分級（S、B、C級）。
• 零認證：大多數端點無需API金鑰，Yahoo的Cookie/Crumb認證由系統自動處理。