simonlin1212/global-stock-data
美股与全球市场数据工具包(给 AI 编程助手用):官方源优先、零鉴权、标注合规级别 | US & global market data for AI coding assistants — zero-auth, official sources. CBOE options + 0DTE, VIX term structure, FINRA short data, SEC Form 4 / 13F, central-bank rates & FX, Taiwan exchanges, EIA energy. 16 layers, 50+ endpoints, 17 sources, each with its compliance tier.
global-stock-data – AIコーディングアシスタント向けマーケットデータスキル
概要
- AIコーディングアシスタント(Claude Code、OpenAI Codex、OpenClawなど)が、公開データソースから米国中心の多様な市場データを即座に取得できる、単一のスキルファイル(Pythonを埋め込んだMarkdown)です。
- リポジトリには公開データソースと通信するコードのみが含まれており、実際のデータはユーザーがリクエスト時に取得します。
重要性
- AIアシスタントは、コーディング関連の質問に答えるために最新の金融情報を必要とすることがよくあります(例:「AAPLの0日満期オプションフローを表示」)。
- 各アシスタント開発者が多数のスクレイパーを再実装する代わりに、このスキルは16の論理レイヤー(銘柄情報、Kライン、ファンダメンタルズ、オプションGreeks、空売り関心、SEC提出書類、マクロ金利、FXなど)と50以上のエンドポイントをカバーする、作成済みの認証不要・
requestsのみのインターフェースを提供します。
主な機能(READMEに記載)
| レイヤー | 主なデータとソース | ハイライト |
|---|---|---|
| マーケットデータ | Sina、Tencent、Eastmoney(リアルタイム米国/香港銘柄情報) | シンボルあたり25〜78フィールド |
| Kライン/チャート | Sina(1984年まで遡る)+ Yahoo(グローバル) | 日足、週足、月足、分足。米国、日本、台湾、韓国、インド、EU市場に対応 |
| テクニカル指標 | 純Python計算 | MA、EMA、MACD、RSI、KDJ、ボリンジャー |
| ファンダメンタルズ | Eastmoney、Yahoo、SEC XBRL | 損益計算書、貸借対照表、キャッシュフロー、503のGAAP指標 |
| 資金フロー | Eastmoney push2his | 時価総額層別の日次フロー |
| オプション | Yahoo crumb(フォールバック) | 米国シンボルの全チェーン |
| 公式ソースのオプション | CBOE(cdn.cboe.com) | 全チェーン+予想変動率+Greeks+**0日満期(0DTE)**フロー検出 |
| 空売り出来高 | FINRA Reg SHO | 約12,000シンボルの市場全体の日次空売り出来高 |
| 空売り関心 | FINRA(月2回) | 未決済空売りポジション、買い戻し日数、約22,000シンボルのランキング |
| SEC提出書類 | EDGAR日次インデックス+ XBRL | 当日のForm 4、8-K、13F。2001年までの全文検索 |
| インサイダー取引/13F | SEC Form 4 & 13Fパーサー | インサイダー取引の詳細、四半期の機関保有 |
| マクロ/カレンダー | 米国財務省、CFTC、Nasdaq決算カレンダー | イールドカーブ(1か月〜30年)、COTポジション、決算日 |
| グローバル金利&FX(V2.1) | BIS、ECB、NY連銀、連邦準備制度理事会、米国財務省 | 38中央銀行の政策金利、EUR/USD、SOFR/EFFR、ユーロ圏イールドカーブ |
| 台湾市場(V2.2) | TWSE & TPExオープンAPI | 最新銘柄情報、PER、配当利回り、月次売上、信用取引データ |
| エネルギー(V2.2) | 米国EIA | 週次の原油/ガソリン在庫、WTI、ブレント、ヘンリーハブの日次スポット価格 |
| ツール | 各種 | シンボル検索、市場全体のティッカーリスト、ニュース、ティッカー↔CIKマッピング |
コンプライアンス区分
- READMEはすべてのデータソースをS(無料、商用利用可)からD(個人利用のみ)まで等級付けし、B(商用再利用に許可が必要)またはC/D(自動スクレイピング禁止)のものを警告します。これにより、開発者は本番環境で安全なエンドポイントを判断できます。
始め方
~/.claude/skills/global-stock-dataディレクトリを作成します。- リポジトリから単一の
SKILL.mdファイルをダウンロードします。 - 唯一のランタイム依存関係をインストールします:
pip install requests(Windowsではtzdataも必要)。 - (任意)SEC必須のユーザーエージェントに
SEC_CONTACTに名前/メールを記入します。 - AIアシスタントからスキルを呼び出します。例:「Claude、AAPLの財務情報を表示」。
一般的なユースケースのプロンプト(READMEから)
- 「NVDAの0DTEオプションフローを表示 – 異常なアクティビティ。」
- 「今週のTSLAの空売り出来高比率のトレンド。」
- 「主要中央銀行の現在の政策金利。」
- 「過去1年間のWTI価格チャート。」
- 「バークシャーの最新13Fの上位10銘柄。」
対象ユーザー
- AIアシスタント駆動の金融ツールを開発する開発者。
- 多数のAPIを扱うことなく公開市場データをコードだけで素早く取得したいクオンツリサーチャー。
- 公開金融フィードをラップした認証不要・Pythonのみのラッパーが必要な方。
制限事項
- リポジトリはコードのみを提供します。各ソースの利用規約(特に区分C/D)を尊重する必要があります。商用プロジェクトは区分Sのソースに限定すべきです。
- 一部のデータ(Yahoo、Nasdaqなど)は技術的に自動スクレイピングが禁止されており、スキルにはコードが含まれていますがユーザーに警告します。
まとめ
global-stock-dataは、公開された米国およびグローバル市場データの広範なソースを単一のAIアシスタントフレンドリーなPythonインターフェースに集約し、明確なコンプライアンスガイダンスを提供する、文書化されたオープンソースの「スキル」です。
関連
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト