mcpField
Y
yfinance-data

yfinance-data

github.com/himself65データ・データベース3.5k4.0k 回インストール4 日前に更新
リポジトリ

yfinance-data について

yfinance-data は、金融データの取得に使うスキルです。Python の yfinance で Yahoo Finance の相場、企業情報、分析データを取得し、依頼に応じた手法と結果の扱い方を案内します。

主な機能

  1. 01株価と過去価格の取得
  2. 02財務諸表と企業行動の確認
  3. 03オプション・アナリスト・保有者データの照会
  4. 04銘柄比較、スクリーニング、セクター調査
  5. 05データ処理と提示のガイド

活用シーン

  1. 01株価や過去の OHLCV データの確認
  2. 02財務諸表、配当、株式分割の確認
  3. 03オプションチェーン、評価、ニュースの照会
  4. 04複数銘柄の比較や市場銘柄の絞り込み

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/himself65/finance-skills --skill yfinance-data

インストール後、Claude Code で/yfinance-dataを入力して読み込まれたか確認します。

同梱ファイルREADME.mdreferences/api_reference.md

詳細

yfinance データスキル

ホストが以下のシェルプローブをまだ実行していない場合（Codex など）、セットアップ方法を選択する前に、シェルツールを使って ! ラッパー内のコマンドを実行してください。実際の出力を使用してください。シェルにアクセスできない場合は、その制限を報告してください。

yfinance Python ライブラリを使用して、Yahoo Finance から金融データと市場データを取得します。

重要：yfinance は Yahoo, Inc. と提携していません。データは研究および教育目的で提供されています。

ステップ 1：yfinance が利用可能であることを確認する

現在の環境の状態：

!`python3 -c "exec('try:\n import yfinance\n print(\'yfinance \' + yfinance.__version__ + \' installed\')\nexcept Exception:\n print(\'YFINANCE_NOT_INSTALLED\')')"`

YFINANCE_NOT_INSTALLED の場合は、コードを実行する前にインストールしてください。

import subprocess, sys
subprocess.check_call([sys.executable, "-m", "pip", "install", "-q", "yfinance"])

yfinance がすでにインストールされている場合は、インストール手順をスキップして、そのまま次に進んでください。

ステップ 2：ユーザーのニーズを特定する

ユーザーのリクエストを以下のデータカテゴリの 1 つ以上に対応させ、references/api_reference.md の該当するコードを使用してください。

ユーザーのリクエストデータカテゴリ主なメソッド
株価、気配値現在価格ticker.info または ticker.fast_info
価格履歴、チャートデータ過去の OHLCVticker.history() または yf.download()
貸借対照表財務諸表ticker.balance_sheet
損益計算書、売上高財務諸表ticker.income_stmt
キャッシュフロー財務諸表ticker.cashflow
配当コーポレートアクションticker.dividends
株式分割コーポレートアクションticker.splits
オプションチェーン、コール、プットオプションデータticker.option_chain()
決算、EPS分析ticker.earnings_history
アナリストの目標株価分析ticker.analyst_price_targets
推奨、評価分析ticker.recommendations
格上げ／格下げ分析ticker.upgrades_downgrades
機関投資家の保有者所有状況ticker.institutional_holders
インサイダー取引所有状況ticker.insider_transactions
企業概要、セクター一般情報ticker.info
複数銘柄の比較一括ダウンロードyf.download()
株式のスクリーニング／絞り込みスクリーナーyf.screen() + yf.EquityQuery
セクター／業界データ市場データyf.Sector / yf.Industry
ニュースニュースticker.news

ステップ 3：コードを作成して実行する

一般的なパターン
import yfinance as yf

ticker = yf.Ticker("AAPL")
# ... use the appropriate method from the reference
主なルール
  1. 必ず try/except で囲む — Yahoo Finance はレート制限をかけたり、空のデータを返したりする場合があります
  2. 複数の銘柄を比較する場合は yf.download() を使用する — マルチスレッド処理により高速です
  3. オプションでは、ticker.option_chain(date) を呼び出す前に ticker.options で有効期限を一覧表示する
  4. 四半期データでは、quarterly_ の接頭辞を使用します：ticker.quarterly_income_stmt、ticker.quarterly_balance_sheet、ticker.quarterly_cashflow
  5. 長期間のデータを取得する場合は、日中データの制限に注意してください。1m データは約 7 日前まで、1h データは約 730 日前までしか取得できません
  6. DataFrame は読みやすく表示する — .to_string() または .to_markdown() を使用するか、主要な列を選択してください
  7. タイムゾーンの扱い — yfinance はタイムゾーン情報付きの日時インデックス（例：America/New_York）を返します。日付を比較する場合は、必ず pd.Timestamp(..., tz=...) を使用するか、.tz_localize(None) でタイムゾーンを取り除いてください。詳細はリファレンスファイルを参照してください。
有効な期間と間隔
期間1d、5d、1mo、3mo、6mo、1y、2y、5y、10y、ytd、max
間隔1m、2m、5m、15m、30m、60m、90m、1h、1d、5d、1wk、1mo、3mo

ステップ 4：データを提示する

まずユーザーが求めた数値を回答し、その後に補足の表（Markdown、または主要な列に絞った DataFrame）を示してください。決算の予想超過や未達、異常な出来高、配当の変更など、データ内で注目すべき点を指摘してください。また、数値の解釈に影響する場合は、セクター平均、過去の範囲、アナリストのコンセンサスなどの背景情報を加えてください。ユーザーがチャートを希望する場合は、データとともに可視化を提示してください。

リファレンスファイル

  • references/api_reference.md — すべてのデータカテゴリについてコード例を含む、yfinance API の完全なリファレンス

正確なメソッドシグネチャやエッジケースの処理を確認する必要がある場合は、リファレンスファイルをお読みください。

コメント

Markdown 対応