cn-stock

🇨🇳 cn-stock — 中国 A 株データ（sc-proxy 経由の Tushare）

Tushare Pro を唯一の上流ソースとして使用する包括的な A 株スキルです。 すべての API 呼び出しは sc-proxy（透過プロキシの tushare プラグイン）を経由してルーティングされ、 サーバー側で実際の API トークンが注入され、リクエストごとに課金されます。 ローカルの TUSHARE_TOKEN 環境変数は不要です — スキルは偽のトークンを送信し、 リクエストが Tushare に到達する前に sc-proxy がそれを置き換えます。

ソース戦略

your call → exports.py (cn-stock)
            └─ proxied_post → sc-proxy (tushare plugin) → http://api.tushare.pro/

• Sina / Eastmoney / akshare のスクレイピングによるフォールバックはありません。
• ローカルの API キーは不要です。
• 課金は sc-proxy 経由でリクエストごとに行われます。

出力契約

ほとんどの関数は次を返します：

{"ok": bool, "source": str, "data": <payload>, "error": str|None, "ts": int}

例外：

• get_full_report(code) はサブ結果を統合した dict を返します。

コード形式

受け付ける形式：

• 000001 / 603186 / 300476（推奨）
• 000001.SZ / 600000.SH / 830799.BJ（こちらも受け付けます）

6 桁コードの自動マッピング：

• 60/68/90 → SH
• 00/20/30 → SZ
• 4/8 → BJ

関数マップ

相場 / 企業 / K ライン

関数	返す内容	Tushare エンドポイント
get_realtime_quote(code)	最新の相場スナップショット + バリュエーション	daily + daily_basic
get_company_info(code)	上場企業のプロフィール	stock_company
get_kline(code, period, start, end, adjust, limit)	日足/週足/月足 K ライン（未調整）	daily/weekly/monthly
get_adj_factor(code, days)	調整係数シリーズ（qfq/hfq を手動計算するため）	adj_factor
get_bid_ask(code)	L1～L5 の板情報	基本権限では利用できません
get_stock_list(market, industry, list_status, limit)	任意のフィルター付き上場銘柄ユニバース	stock_basic
get_trade_calendar(start, end, exchange, open_only)	取引日カレンダー	trade_cal

財務

関数	返す内容	Tushare エンドポイント
get_financial(code, max_periods)	期間ごとの主要財務指標	fina_indicator
get_income_statement(code, max_periods, period)	利润表	income
get_balance_sheet(code, max_periods, period)	资产负债表	balancesheet
get_cashflow_statement(code, max_periods, period)	现金流量表	cashflow
get_earnings_forecast(code, limit)	业绩预告	forecast
get_earnings_express(code, limit)	业绩快报	express
get_dividends(code, limit)	分红送股	dividend

株主と持株

関数	返す内容	Tushare エンドポイント
get_holders(code, top)	最新の主要株主	top10_holders
get_shareholder_count(code, periods)	股东户数变化	stk_holdernumber
get_shareholder_trades(code, days)	重要股东增减持	stk_holdertrade
get_block_trades(code, days)	大宗交易	block_trade

資金フローとノースバウンド

関数	返す内容	Tushare エンドポイント
get_fund_flow(code, days)	直近の資金フロー	moneyflow
get_margin_detail(code, days)	融资融券明细	margin_detail
get_north_holdings(code, days)	沪深股通持股明细（ノースバウンド）	hk_hold
get_north_flow(days)	沪深港通每日资金流向	moneyflow_hsgt

コンセプト / 業種 / ドラゴン・タイガー / 市場全体

関数	返す内容	Tushare エンドポイント
get_concept_boards(top, sort_by)	コンセプトボード一覧	ths_index
get_stock_concepts(code)	銘柄のコンセプト所属	ths_member
get_lhb(code, days)	銘柄のドラゴン・タイガー記録	top_list（直近日付をスキャン）
get_top_movers(direction, limit)	市場全体の上昇/下落上位銘柄	daily（+ daily_basic）
get_limit_prices(code, trade_date, days)	每日涨跌停价	stk_limit
get_limit_board(trade_date, limit_type)	当日涨停/跌停/炸板股	limit_list_d
get_suspended(trade_date)	每日停复牌	suspend_d

指数データ

関数	返す内容	Tushare エンドポイント
get_index_basic(market)	指数列表（SSE/SZSE/MSCI/CSI/SW/...）	index_basic
get_index_kline(index_code, period, start, end, limit)	指数 K ライン（沪深300/上证/创业板などを含む）	index_daily/weekly/monthly

ワンショットバンドル

関数	返す内容
get_full_report(code)	quote + company + holders + fund_flow	combo

このスキルが意図的に対象としていないもの

• ニュース。 株関連のニュース、発表、記事には通常の Web 検索（例：web_search）を使用してください。Tushare のニュースはレート制限が厳しく、一般的な Web のカバレッジと重複するため、有料プロキシ経由で実行しても価値はありません。
• 調整済み K ライン（qfq/hfq）。 HTTP パスは未調整のバーしか返しません。調整済み価格が必要な場合は、get_adj_factor と get_kline の未調整バーを組み合わせて使用してください。
• イントラデイのティック / 板情報 L1-L5。 ベースラインに含まれない上流の独立したリアルタイム権限が必要です。
• 分足。 上流の独立した権限が必要で、ここでは公開されていません。終値には get_kline を使用してください。

ユーザー向けの返信ガイダンス

ユーザーに回答する際：

• 値は読みやすい中国市場の単位（亿、%）で表示してください。
• データがイントラデイのティックではなく終値であることを明確に示してください。
• 利用できない機能がある場合は、率直にその旨を伝えてください。
• 出典注記を追加してください：数据来源：Tushare Pro，非投资建议。

メンテナンスに関する注意事項

• すべてのリクエストはボディ {api_name, token, params, fields} を付けて http://api.tushare.pro/ に POST します。
• token フィールドにはダミーキーが設定されています。sc-proxy の tushare プラグインが上流呼び出しの前にこれを置き換えます。
• 価格設定やレート制限を変更するには、このスキルではなくプロキシの tushare プラグインを編集してください（transparent-proxy-maintenance スキルを参照）。
• 新しい Tushare エンドポイントの追加 = _call(api_name, **params) をラップする薄いラッパーを 1 つ追加することです。