ashareport

ashareport

ashareport は、中国本土の A 株に関する 9 種類の株価データツール（履歴、リアルタイム株価、ニュース、貸借対照表、損益計算書、キャッシュフロー、内部取引、財務指標）に加え、ローカル時刻ツールを、コマンドラインプログラムおよび stdio MCP サーバーとして提供します。

データツールの仕組み（最初にお読みください）

元の設計では、Python の市場データライブラリをプロセス内で実行します。この TypeScript による再構築では、代わりにエンドポイント実行方式を使用します。次を設定してください。

export ASHAREPORT_API_URL="https://your-data-endpoint.example"

各データツールは JSON {tool, source, params} を {ASHAREPORT_API_URL}/<tool> に POST し、エンドポイントからの JSON 応答を返します。変数が設定されていない場合、データツールは次のエラーを返します。 upstream data endpoint not configured: set ASHAREPORT_API_URL ...。 get_time_info は完全にローカルで動作し、エンドポイントは不要です。

ソースのフォールバックは、ドキュメントに記載された順序でローカルに実装されています。

ドメイン	ソースの順序
historical	eastmoney → eastmoney_direct → sina → ths
realtime	eastmoney_direct → eastmoney → xueqiu → ths（シンボルが指定されていない場合、xueqiu／ths はスキップ）
news	eastmoney → ths
statements / metrics	sina → eastmoney_direct

指定されたソースを最初に試し、fallback が false でない場合はドメインの順序で試行し、最初に空でない結果が返った時点で終了します。すべてのソースで失敗した場合、エラーには各ソースとそのエラーが記載されます。 デフォルト値：interval は day、adjust は none、recent_n は履歴データで 100、その他の直近 N 件取得ツールで 10 です。

indicators_list はローカルで計算されず、そのままエンドポイントに渡されます。get_time_info は今日から土曜日と日曜日を除いてさかのぼり、最終取引日を特定します。取引所の休場日は考慮されません。

インストール

npx @reneturcios/ashareport get_time_info
docker run -i ghcr.io/cloudcorprecords/ashareport   # MCP server

CLI

ashareport get_hist_data --symbol 600519 --interval day --recent-n 20
ashareport get_realtime_data --symbol 600519
ashareport get_realtime_data            # market-wide, symbol optional
ashareport get_news_data --symbol 600519
ashareport get_balance_sheet --symbol 600519
ashareport get_income_statement --symbol 600519
ashareport get_cash_flow --symbol 600519
ashareport get_inner_trade_data --symbol 600519
ashareport get_financial_metrics --symbol 600519
ashareport get_time_info
ashareport --version

終了コード：0 成功、1 ツールエラー、2 使用方法エラー。

MCP サーバー

npx -y @reneturcios/ashareport mcp

{
  "mcpServers": {
    "ashareport": {
      "command": "npx",
      "args": ["-y", "@reneturcios/ashareport", "mcp"],
      "env": { "ASHAREPORT_API_URL": "https://your-data-endpoint.example" }
    }
  }
}

ツール

ツール	必須	その他のパラメーター
get_hist_data	symbol	interval、interval_multiplier、start_date、end_date、adjust、source、fallback、indicators_list、recent_n
get_realtime_data	—（symbol は任意）	source、fallback
get_news_data	symbol	source、fallback、recent_n
get_balance_sheet	symbol	source、fallback、recent_n
get_income_statement	symbol	source、fallback、recent_n
get_cash_flow	symbol	source、fallback、recent_n
get_inner_trade_data	symbol	—
get_financial_metrics	symbol	source、fallback、recent_n
get_time_info	—	—（ローカル：ISO 時刻、Unix タイムスタンプ、最終取引日）

開発

npm install
npm run build   # tsc -> dist/
npm test        # node test runner, fake-fetch only, no network
npm run dev     # run the CLI from source via tsx

ライセンス

MIT — LICENSE を参照してください。