simonlin1212/a-stock-data

解決的問題

提供一個全面的、免認證的A股（中國股市）資料工具包。它消除了開發者與AI代理在處理數十個分散的金融資料來源時，手動處理複雜API參數、認證標頭與速率限制邏輯的需求，將這些資料整合至單一、AI就緒的介面中。

如何運作

此專案以「技能檔案」（包含嵌入式Python的結構化Markdown）形式建構，可直接注入Claude Code、Codex或OpenClaw等AI程式設計助手。它實現了11層架構，透過TCP與HTTP請求從19個不同來源（包括mootdx、騰訊、東方財富與官方交易所API）取得資料。為防止IP被封鎖，優先使用非阻塞來源（如mootdx與騰訊），並對限制較嚴格的來源（如東方財富）使用內建的速率限制包裝器（em_get()）。

適用對象

• AI開發者：需要可靠A股資料但無需管理多個API金鑰的金融代理或投資研究工具開發者。
• AI程式設計助手使用者：使用Claude Code或類似工具，希望其代理能執行即時股票估值、主題研究與宏觀分析的使用者。
• 量化研究人員：需要簡化方式來提取中國市場的K線、報告與資金流向資料的研究人員。

主要亮點

• 全面覆蓋：11個資料層共54個端點，涵蓋從即時行情、K線到研究報告、資金流向與宏觀指標（PMI、社會融資）的全部內容。
• 零認證：大多數資料來源完全免費，無需註冊或API金鑰（僅iwencai語意搜尋除外）。
• 高容錯架構：包含「備用來源」策略，當主資料來源被屏蔽時，可自動降級至替代資料提供者。
• AI原生設計：專為與基於LLM的編碼代理無縫整合而格式化為技能檔案。
• 廣泛資料範圍：包含ETF期權（希臘字母/IV）、股東人數、以及自2016年以來的歷史估值（PE/PB/PS）等專業資料。