shanxi-securities-tushare

山西证券 Tushare データスキル

自然言語による金融データのリクエストを、実行可能な Tushare ワークフローに変換します：環境確認 → タスクの理解 → 対象の特定 → API の選択 → パラメーターの検証 → データ取得 → 整理 → 説明 → 提供。

典型的なシナリオ

この skill が担当するのはデータ取得とデータの提供のみです。ユーザーが対象の分析／評価／比較／詳細調査を求める場合は、sxsc-tushare-analysis skill を使用してください。

• 個別株／指数／ETF の相場、バリュエーション、活発度データの取得
• 複数対象のデータ一括取得（業績、バリュエーション、騰落率、ROE などの項目）
• 財務データの取得（利益の推移、ROE、売上総利益率、キャッシュフロー）
• 資金フローデータの取得（北向資金、主力資金、龍虎榜、資金流入の多いセクター）
• セクターローテーション、指数構成銘柄データの取得
• マクロデータの取得（CPI / PPI / GDP / PMI / 金利 / マネーサプライ）
• バックテストや後続の分析向けのデータエクスポート（CSV / Parquet）

コアワークフロー

実行のたびに、次の順序で進めます：

1. 環境確認 — scripts/env_check.json のキャッシュが存在するか確認します：
   • 存在する → 直接読み込み、mode フィールド（sdk/http）に基づいてデータの取得方法を決定します。
   • 存在しない → まず python scripts/check_env.py を実行してキャッシュを生成し、読み込みます。
   • 終了コードが 0 以外（token が未設定）→ 中断し、ユーザーに SXSC_TUSHARE_TOKEN の設定を促します。データ取得に進んではいけません。
2. タスクの理解 — ユーザーが解決しようとしている問題を特定します（下記「タスクの分類」を参照）。
3. 対象の特定 — 名称／コードを標準の ts_code（例：600519.SH）に変換し、市場、期間、項目はデフォルト値で補完します。
4. 表を確認して API を選択 — まず references/API接口对应表.md を参照し、pro.api_name と対応するドキュメントパスを確認します。記憶に頼って API を記述してはいけません。
5. パラメーターの検証 — 日付形式 YYYYMMDD、開始日と終了日の順序、競合の調整、未来日の切り詰めを確認します（ルールは下記「重要なデフォルト値」の 71～73 行を参照）。
6. データ取得の実行 — 手順 1 の mode に基づいて方法を選択します：
   • sdk：scripts/ 配下のテンプレート（stock_data_demo.py、fund_data_demo.py、index_sector_demo.py、fin_report_demo.py、moneyflow_demo.py）にある SDK 関数を参考にし、references/调取数据.md の Python SDK セクションに従います。
   • http：テンプレート内の HTTP 関数（http_call）を参考にし、references/调取数据.md の HTTP プロトコルセクションに従います（SDK への依存はありません）。
7. 構造化して提供 — 1 文の結論 → データ基準 → 主要指標／表 → リスク／制限 → ファイルパス。

重要な原則：「これはどのようなタスクか、どのワークフローを使うか」を先に考え、その後で「どの API を使うか」を考えます。API 名を先に調べてはいけません。データ取得の前に、環境が整っていることを必ず確認します（手順 1）。token がない場合、データ取得には意味がありません。

タスクの分類

タスクの種類	代表的な表現
相場／トレンドデータ	直近の相場、騰落、ローソク足、出来高データの取得
基本情報	どのような会社か、いつ上場したか、業種
財務データ	財務諸表、利益、ROE、キャッシュフローの取得
バリュエーションデータ	PE/PB、配当利回りデータの取得
資金フロー／市場行動データ	北向資金、主力資金、龍虎榜、資金流入の多いセクターデータの取得
セクター／指数／テーマデータ	セクター構成銘柄、指数構成銘柄、コンセプトデータの取得
ストップ高・安／センチメントデータ	ストップ高銘柄の段階、連続ストップ高、活発度データの取得
発表／ニュース／レポート	発表、カタリスト、ニュース（制限あり：対応範囲の説明と代替手段のみ）
マクロ／複数市場	CPI、PMI、金利、香港株、米国株
データエクスポート／調査準備	CSV、バックテスト用データテーブル、Parquet の取得

ユーザーが対象の分析／評価／比較／詳細調査を求める場合は、sxsc-tushare-analysis skill に切り替えてください。

重要なデフォルト値

曖昧な中国語表現	デフォルトの基準
「最近」／「直近」	直近 20 取引日
「最近の一定期間」／「直近 3 か月」	直近 60 取引日
「今年」	当年 1 月 1 日から現在まで
「財務諸表」／「業績」	直近 8 四半期 + 直近の年度
「資金フローは最近どうか」	直近 5～20 取引日
「マクロは最近どうか」	直近 6～12 期
業種分類	申万／中信（より安定）
コンセプト分類	同花順／東方財富（より旬なテーマ）
証券コード	600519.SH / 000001.SZ の標準形式

コードのみ（例：000001）の場合、ルールに従って補完できれば補完して説明し、補完できなければ必要最小限の確認を行います。
日付が競合する場合（trade_date と start_date/end_date が両方指定されている場合）は、呼び出し前にどちらを優先するか決めます。
未来の日付は最新の取得可能日まで自動的に切り詰め、ユーザーに伝えます。

このスキルの対象外

• 売買の推奨、投資アドバイザーの代替
• 自動注文や取引の実行
• リアルタイム相場（T-1 日のデータのみ）
• バックテストエンジンやポートフォリオ最適化システムの実装
• token がない場合や権限がない場合にデータを捏造すること

環境確認

データ取得タスクを実行する前に、環境が利用可能か確認します（結果は scripts/env_check.json にキャッシュされ、毎回の重複確認を避けます）：

python scripts/check_env.py          # token_set=true 则直接复用缓存，否则实时检测
python scripts/check_env.py --force  # 强制重新校验并覆盖缓存
python scripts/check_env.py --check  # 只校验不写缓存

確認項目：

項目	必須	不足した場合の影響
SXSC_TUSHARE_TOKEN が設定済み	はい	skill を実行できず、ゼロ以外の終了コードを返します。まず環境変数を設定する必要があります
sxsc_tushare ライブラリがインストール済み	いいえ	インストール済み → SDK 方式（sxsc_tushare）を使用。未インストール → HTTP プロトコル方式を使用

• 終了コードが 0 以外の場合は token が不足しています。まず環境を整えてからデータを取得してください。
• キャッシュに保存されるのは token_set の状態と SDK のインストール情報のみで、token 本体やそのハッシュは保存されません。token_set=true の場合はキャッシュをそのまま再利用します。
• 取得方法は確認結果の mode フィールドに基づいて選択します。sdk は references/调取数据.md の Python SDK セクション、http は HTTP プロトコルセクションを使用します。

References クイックインデックス

用途	パス
API 名 ↔ ドキュメントの対応表	references/API接口对应表.md
インストールと HTTP による呼び出し	references/调取数据.md
株式呼び出しテンプレート	scripts/stock_data_demo.py
ファンド呼び出しテンプレート	scripts/fund_data_demo.py
指数／業種呼び出しテンプレート	scripts/index_sector_demo.py
財務三表呼び出しテンプレート	scripts/fin_report_demo.py
資金フロー／龍虎榜呼び出しテンプレート	scripts/moneyflow_demo.py

コード例

初期化と日次データ

import sxsc_tushare as sx
import os

token = os.getenv('SXSC_TUSHARE_TOKEN') or 'YOUR_TOKEN_HERE'
sx.set_token(token)
pro = sx.get_api(env='prd')  # 'prd' 仿真, 'qa' 生产

# 股票列表
pro.stock_basic(exchange='', list_status='L',
                fields='ts_code,symbol,name,area,industry,list_date')

# 日线行情（ah_vol/ah_amount 为盘后成交量/额，2026-07-06 起有数据，需显式用 fields 指定）
pro.daily(ts_code='600519.SH', start_date='20250101', end_date='20251231')
# 取盘后数据示例：
# pro.daily(trade_date='20260707', fields='ts_code,open,close,ah_vol,ah_amount')

エラー処理

try:
    df = pro.daily(ts_code='600519.SH', start_date='20250101', end_date='20251231')
except Exception as e:
    print(f"获取数据失败：{e}")

結果が空でも、必ずしも失敗とは限りません。非取引日、対象銘柄が未上場、パラメーターの誤り、権限不足などの可能性があります。区別したうえで結論を出してください。