simonlin1212/a-stock-data

何を解決するか

A株式市場（中国株式市場）の包括的で、認証不要のデータツールキットを提供します。開発者やAIエージェントが数十の分散した金融データソースを扱う際に、複雑なAPIパラメータ、認証ヘッダー、レート制限ロジックを手動で処理する必要がなくなり、すべてを1つのAI対応インターフェースに統合します。

動作方法

このプロジェクトは、Claude Code、Codex、OpenClawなどのAIプログラミングアシスタントに直接挿入可能な「スキルファイル」（埋め込みPythonを含む構造化Markdown）として設計されています。11層のアーキテクチャを実装し、mootdx、Tencent、Eastmoney、公式取引所APIなど19の異なるデータソースからTCPおよびHTTPリクエストを組み合わせてデータを取得します。IPブロックを回避するため、非ブロッキングソース（mootdxやTencentなど）を優先し、Eastmoneyなど制限の厳しいソースには組み込みのレート制限ラッパー（em_get()）を使用しています。

対象ユーザー

• AI開発者：複数のAPIキーを管理せずに信頼性の高いA株式データが必要な、金融エージェントや投資リサーチツールを開発する人。
• AIプログラミングアシスタントユーザー：Claude Codeなどを使って、リアルタイムの株価評価、テーマ別研究、マクロ分析を実行できるエージェントを有効化したい人。
• 定量研究者：中国市場向けのK線、報告書、資金流れデータを効率的に取得したい人。

主な特徴

• 広範なカバレッジ：11層にわたる54のエンドポイントで、リアルタイム価格、K線、研究レポート、資金流れ、マクロ指標（PMI、社会融資）まで網羅。
• 認証不要：ほとんどのデータソースは完全に無料で、登録やAPIキーの必要なし（iwencaiの意味検索を除く）。
• 耐障害アーキテクチャ：主要ソースがブロックされた場合、自動的に代替データプロバイダに降格する「バックアップソース」戦略を備えています。
• AIネイティブ設計：LLMベースのコーディングエージェントとのシームレスな統合を目的として、特別にフォーマットされたスキルファイル形式です。
• 広範なデータ範囲：ETFオプション（ギリシャ指標/IV）、株主数、2016年以降の歴史的評価（PER/PBR/PS）など、専門的なデータも含みます。