File size: 4,992 Bytes
f7f0470
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
"""yfinanceから日本株データを取得するユーティリティモジュール."""

import logging

import pandas as pd
import yfinance as yf

logger = logging.getLogger(__name__)

_TOKYO_SUFFIX = ".T"


def _to_ticker_symbol(code: str) -> str:
    """銘柄コードに東証サフィックスを付与する."""
    code = code.strip()
    if not code.endswith(_TOKYO_SUFFIX):
        return f"{code}{_TOKYO_SUFFIX}"
    return code


def validate_stock_code(code: str) -> bool:
    """銘柄コードが有効かチェックする.

    東証の銘柄コード形式(4桁の数字)を検証し、
    yfinanceでデータが取得可能かも確認する。

    Args:
        code: 銘柄コード(例: "7203")

    Returns:
        有効な銘柄コードの場合True
    """
    code = code.strip()
    if not code.isdigit() or len(code) != 4:
        return False

    try:
        ticker = yf.Ticker(_to_ticker_symbol(code))
        info = ticker.info
        return info is not None and info.get("regularMarketPrice") is not None
    except Exception:
        logger.warning("銘柄コード %s の検証に失敗しました", code)
        return False


def get_stock_data(code: str, period: str = "1y") -> pd.DataFrame | None:
    """指定銘柄のOHLCVデータを取得する.

    Args:
        code: 銘柄コード(例: "7203")
        period: 取得期間("1mo", "3mo", "6mo", "1y", "3y")

    Returns:
        OHLCVデータのDataFrame。取得失敗時はNone。
    """
    try:
        symbol = _to_ticker_symbol(code)
        ticker = yf.Ticker(symbol)
        df = ticker.history(period=period)

        if df.empty:
            logger.warning("銘柄 %s のデータが空です(period=%s)", code, period)
            return None

        return df
    except Exception:
        logger.warning("銘柄 %s のデータ取得に失敗しました", code)
        return None


def get_stock_info(code: str) -> dict | None:
    """銘柄の企業情報を取得する.

    Args:
        code: 銘柄コード(例: "7203")

    Returns:
        企業情報の辞書。取得失敗時はNone。
        含まれるキー:
            name, marketCap, per, pbr, dividendYield,
            roe, roa, eps, revenue, operatingMargin
    """
    try:
        symbol = _to_ticker_symbol(code)
        ticker = yf.Ticker(symbol)
        info = ticker.info

        if info is None:
            return None

        return {
            "name": info.get("longName") or info.get("shortName", "不明"),
            "marketCap": info.get("marketCap"),
            "per": info.get("trailingPE") or info.get("forwardPE"),
            "pbr": info.get("priceToBook"),
            "dividendYield": info.get("dividendYield"),
            "roe": info.get("returnOnEquity"),
            "roa": info.get("returnOnAssets"),
            "eps": info.get("trailingEps") or info.get("forwardEps"),
            "revenue": info.get("totalRevenue"),
            "operatingMargin": info.get("operatingMargins"),
        }
    except Exception:
        logger.warning("銘柄 %s の企業情報取得に失敗しました", code)
        return None


def get_raw_ticker_info(code: str) -> dict | None:
    """銘柄のyfinance生データ(ticker.info)を取得する.

    Args:
        code: 銘柄コード(例: "7203")

    Returns:
        yfinanceのticker.info辞書そのまま。取得失敗時はNone。
    """
    try:
        symbol = _to_ticker_symbol(code)
        ticker = yf.Ticker(symbol)
        info = ticker.info

        if info is None:
            return None

        return dict(info)
    except Exception:
        logger.warning("銘柄 %s のticker.info取得に失敗しました", code)
        return None


def get_stock_name(code: str) -> str:
    """銘柄コードから銘柄名を取得する.

    Args:
        code: 銘柄コード(例: "7203")

    Returns:
        銘柄名。取得失敗時は銘柄コードをそのまま返す。
    """
    try:
        symbol = _to_ticker_symbol(code)
        ticker = yf.Ticker(symbol)
        info = ticker.info
        if info is not None:
            return info.get("longName") or info.get("shortName", code)
    except Exception:
        logger.warning("銘柄 %s の名前取得に失敗しました", code)
    return code


def get_multiple_stocks(
    codes: list[str], period: str = "1y"
) -> dict[str, pd.DataFrame]:
    """複数銘柄のOHLCVデータを一括取得する.

    Args:
        codes: 銘柄コードのリスト(例: ["7203", "6758"])
        period: 取得期間("1mo", "3mo", "6mo", "1y", "3y")

    Returns:
        銘柄コードをキー、DataFrameを値とする辞書。
        取得失敗した銘柄は含まれない。
    """
    results: dict[str, pd.DataFrame] = {}

    for code in codes:
        df = get_stock_data(code, period)
        if df is not None:
            results[code] = df

    return results