ashareport

ashareport exposes nine A-share (China mainland) stock-data tools — history, realtime quotes, news, balance sheet, income statement, cash flow, inner trades, and financial metrics, plus a local time tool — as a command line program and as a stdio MCP server.

How the data tools work (read this first)

The original design runs a Python market-data library in-process. This TypeScript rebuild uses an endpoint executor instead: set

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

and each data tool POSTs JSON {tool, source, params} to {ASHAREPORT_API_URL}/<tool> and returns the endpoint's JSON answer. With the variable unset, data tools return an error: upstream data endpoint not configured: set ASHAREPORT_API_URL .... get_time_info is fully local and needs no endpoint.

Source fallback is implemented locally, in the documented order:

The requested source is tried first, then the domain order when fallback is not false, stopping at the first non-empty result. If every source fails, the error lists each source and its error. Defaults: interval day, adjust none, recent_n 100 for historical data and 10 for the other recent-N tools.

indicators_list is passed through to the endpoint, not computed locally. get_time_info walks back from today skipping Saturday and Sunday to find the last trading day; exchange holidays are not modelled.

Related MCP server: ashare-mcp

Install

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

Exit codes: 0 success, 1 tool error, 2 usage error.

MCP server

npx -y @reneturcios/ashareport mcp

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

Tools

Development

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

License

MIT — see LICENSE.