fetch-market-data

Language: 日本語 | English

fetch-market-data

米国株・日本株向けの2つのCLIツールを提供するパッケージです。

ツール	用途
fetch-market-data	ティッカーシンボルを指定して指標をJSON取得
screen-market-data	条件を指定して銘柄をスクリーニング、ティッカーリストをJSON取得

概要

株価データの取得には yfinance を使用しています。Yahoo Finance のデータを Python から利用できる非公式ライブラリです。

Claude Code Plugin

このリポジトリは Claude Code Plugin として配布されています。インストールすることで AI エージェントがこのツールを自律的に使いこなせる Skill が利用可能になります。

# 1. マーケットプレイスを登録
claude plugin marketplace add Trippy3/fetch_market_data

# 2. プラグインをインストール
claude plugin install fetch-market-data@fetch-market-data-marketplace

要件

• uv がインストールされていること

インストール不要で実行 (uvx)

# GitHub から直接実行
uvx --from git+https://github.com/Trippy3/fetch_market_data fetch-market-data AAPL MSFT 7203.T
uvx --from git+https://github.com/Trippy3/fetch_market_data screen-market-data --region jp --roe-min 10

# ローカル開発時（変更後は --reinstall を付ける）
uvx --from . --reinstall fetch-market-data AAPL --price
uvx --from . screen-market-data --region jp --roe-min 10

fetch-market-data の使い方

fetch-market-data SYMBOL [SYMBOL ...] [--price] [--market-cap] [--trailing-pe] ...

指標オプションを省略した場合は --price がデフォルトで適用されます。複数の指標を同時に指定できます。

例

# デフォルト (--price と同じ)
fetch-market-data AAPL MSFT 7203.T

# 複数指標を同時指定
fetch-market-data AAPL MSFT --price --market-cap --trailing-pe --dividend-yield

# 日本株
fetch-market-data 7203.T 6758.T --price --pbr --roe

出力形式

ティッカーシンボルをキーとするJSONオブジェクトを stdout に出力します。

{
  "AAPL": {
    "price": 255.92,
    "market-cap": 3761492983808,
    "trailing-pe": 32.354,
    "dividend-yield": 0.0041,
    "currency": "USD",
    "error": null
  },
  "7203.T": {
    "price": 3255.0,
    "market-cap": 42423669489664,
    "trailing-pe": 11.4564,
    "dividend-yield": 0.0291,
    "currency": "JPY",
    "error": null
  }
}

currency と error は常に含まれる固定フィールドです。取得できなかった指標は null になります。

対応市場

市場	ティッカー形式	例
米国株	シンボルそのまま	AAPL, MSFT
日本株	証券コード + .T	7203.T, 6758.T

指標一覧

株価・市場データ

オプション	説明
--price	現在株価（デフォルト）
--volume	出来高（直近）
--avg-volume	出来高（3ヶ月平均）
--week52-high	52週高値
--week52-low	52週安値
--market-cap	時価総額
--price-change	前日比（金額）
--price-change-pct	前日比（%、小数）
--weekly-change	週足変化率（小数）
--monthly-change	月足変化率（小数）

バリュエーション

オプション	説明
--trailing-pe	PER（実績）
--forward-pe	PER（予想）
--pbr	PBR
--psr	PSR
--ev-ebitda	EV/EBITDA
--peg	PEGレシオ
--dividend-yield	配当利回り
--payout-ratio	配当性向

財務・業績

オプション	説明
--revenue	売上高（直近年度）
--revenue-growth	売上高YoY成長率・年次財務諸表ベース（小数）
--revenue-growth-ttm	売上高TTM成長率・screen-market-data と同一ソース（小数）
--operating-income	営業利益（直近年度）
--operating-margin	営業利益率（小数）
--gross-margin	売上総利益率（小数）
--net-income	純利益（直近年度）
--trailing-eps	EPS（実績）
--forward-eps	EPS（予想）
--cash	現金・現金同等物
--goodwill	のれん
--intangible-assets	無形資産
--equity-ratio	自己資本比率（小数）
--debt-ebitda	有利子負債/EBITDA
--operating-cf	営業キャッシュフロー
--fcf	フリーキャッシュフロー
--fcf-margin	FCFマージン（小数）

収益性・リスク

オプション	説明
--roe	ROE
--roa	ROA
--beta	ベータ値

株主還元

オプション	説明
--buyback	自己株買い金額（直近年度、通常負値）
--dividend-history	配当履歴（日付→金額のJSON）
--dividend-growth	増配率・YoY（小数）
--total-return-ratio	総還元性向（配当＋自己株買い）/純利益

成長・アナリストデータ

オプション	説明
--eps-estimate	アナリストEPS予想（DataFrame形式のJSON）
--revenue-estimate	アナリスト売上予想（DataFrame形式のJSON）
--price-target	アナリスト目標株価（min/mean/max等のJSON）
--ratings	レーティング分布（buy/hold/sell等のJSON）

イベント・定性情報

オプション	説明
--guidance	業績ガイダンス・カレンダー情報（JSON）
--next-earnings	次回決算発表予定日
--insider-trades	インサイダー取引履歴（JSON）
--major-holders	大株主保有状況（JSON）

screen-market-data の使い方

条件を組み合わせて銘柄をスクリーニングし、ティッカーシンボルの一覧をJSON形式で返します。

screen-market-data (--region jp|us | --exchange nasdaq|nyse|us) [フィルタオプション]

--region と --exchange はいずれか一方が必須です。

例

# 国内株: ROE 10%以上, 配当利回り 1.5%以上, 連続増配 3年以上
screen-market-data --region jp --roe-min 10 --div-yield-min 1.5 --div-growth-years 3

# 米国 NASDAQ: 売上成長 15%以上, 粗利率 50%以上, FCF プラス
screen-market-data --exchange nasdaq --revenue-growth-min 15 --gross-margin-min 50 --fcf-positive

# 米国 NYSE+NASDAQ テックセクター, インサイダー保有 5%以上, 上位 20 件
screen-market-data --region us --sector Technology --insider-min 5 --size 20

# NYSE: PEGレシオ 1.0未満, 有利子負債/EBITDA 5倍以下
screen-market-data --exchange nyse --peg-max 1.0 --debt-ebitda-max 5

出力形式