Name: stock-api
Author: zhangxiangliang

Imported from zhangxiangliang/stock-api (SKILL.md). Install upstream with npx skills add zhangxiangliang/stock-api. Copyright stays with the author.

stock-api

Get normalized stock market data by running the stock-api CLI. It covers China A-shares, Hong Kong, and US markets, with automatic provider fallback across Tencent, Sina, and Eastmoney.

When to use

The user wants a current price or quote for one or more stocks.
The user wants K-line / candlestick history for charting or analysis.
The user knows a company name but not its code (search first, then quote).

How to run

Use npx stock-api <command>. Every command prints JSON to stdout.

Stock codes use a market prefix: SH / SZ (China), HK (Hong Kong), US (US). Examples: SH510500, SZ000651, HK02020, USDJI.

Get one quote

npx stock-api get-stock SH510500

Get several quotes at once

npx stock-api get-stocks SH510500 SZ000651

Get K-line (candlestick) history

npx stock-api get-klines SH600519 --period week --count 20

--period — day (default), week, or month.
--count — number of rows (defaults to the provider default).
--adjust — none (default), qfq (forward), or hfq (backward).

Search a code by keyword

npx stock-api search-stocks 格力电器

Options (all commands)

--source — auto (default), tencent, sina, or eastmoney. Leave it on auto unless the user asks for a specific provider; auto falls back across providers if one fails.

Notes

Output is JSON — parse it, don't reformat by hand, before showing the user.
If a code returns no data, try search-stocks to confirm the correct code.
For programmatic/persistent use, this same engine is also available as an MCP server: npx stock-api mcp. Prefer the CLI commands above for one-off lookups.

Install stock-api and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "zhangxiangliang-stock-api-stock-api", "kind": "skill", "name": "stock-api", "description": "Fetch real-time stock quotes, K-line (candlestick) history, and search symbols for China A-shares, Hong Kong, and US markets. Use when the user asks for a stock price, a quote, market data, candlestick/K-line data, or to look up a stock code by company name.", "publisher": "zhangxiangliang", "version": "1.0.0", "capabilities": { "domains": [ "finance", "coding" ], "tags": [ "skill-md", "github" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Fetch real-time stock quotes, K-line (candlestick) history, and search symbols for China A-shares, Hong Kong, and US markets. Use when the user asks for a stock price, a quote, market data, candlestick/K-line data, or to look up a stock code by company name." ], "primary": false, "metadata": { "source": { "provider": "github", "repository": "https://github.com/zhangxiangliang/stock-api", "path": "SKILL.md", "ref": "0532a83ee095693529fb31986ad1acb0c8f3cfd1", "url": "https://github.com/zhangxiangliang/stock-api/blob/0532a83ee095693529fb31986ad1acb0c8f3cfd1/SKILL.md", "key": "zhangxiangliang/stock-api/SKILL.md" } }, "instructions": "# stock-api\n\nGet normalized stock market data by running the `stock-api` CLI. It covers\nChina A-shares, Hong Kong, and US markets, with automatic provider fallback\nacross Tencent, Sina, and Eastmoney.\n\n## When to use\n\n- The user wants a current price or quote for one or more stocks.\n- The user wants K-line / candlestick history for charting or analysis.\n- The user knows a company name but not its code (search first, then quote).\n\n## How to run\n\nUse `npx stock-api <command>`. Every command prints JSON to stdout.\n\nStock codes use a market prefix: `SH` / `SZ` (China), `HK` (Hong Kong),\n`US` (US).", "cost": { "context_tokens": 431 } }

stock-api

About

stock-api

When to use

How to run

Get one quote

Get several quotes at once

Get K-line (candlestick) history

Search a code by keyword

Options (all commands)

Notes

Install stock-api and it becomes one more candidate the router can pick - when it fits.

Use it

Manifest

Reviews