Description

财跃星辰金融数据服务。提供实时行情、板块数据、公司信息、宏观经济、研报新闻等全方位金融数据。触发条件：用户查询股票行情、板块涨跌、公司财务、宏观数据、研报公告等金融信息。

README (SKILL.md)

FinStep Tool 金融数据服务

Name: finstep-mcp
Author: fa1c0n4826

财跃星辰提供的专业金融数据 API，覆盖 A 股市场全维度数据。

Requirements

Environment variables

环境变量	必填	说明
`FINSTEP_SIGNATURE`	✅ 必填（机密）	Finstep API 签名令牌，所有脚本调用均需此变量。可从财跃星辰获取。

注意：未设置 FINSTEP_SIGNATURE 时，所有脚本调用均会失败（HTTP 401/403 或连接被拒）。请通过 .env 文件、密钥管理工具或 shell 配置预先设置，切勿明文写入代码。

Required binaries

工具	用途
`bash`	运行所有脚本（需 bash 3.2+，macOS/Linux 内置）
`curl`	发起 HTTP 请求调用 Finstep API
`jq`	构建请求参数 JSON 及解析响应（需 1.6+）
`date`	生成默认日期参数（macOS/Linux 内置）

服务列表

服务	脚本	功能
搜索	`search.sh`	新闻、公告、研报、微信公众号、投资者问答
行情	`quote.sh`	实时行情、K线、龙虎榜、资金流向
板块	`plates.sh`	板块列表、涨跌排名、成分股
公司	`company.sh`	财务报表、估值、股东信息
宏观	`macro.sh`	LPR利率、国债收益率、央行操作、CPI/PPI/GDP等
通用	`common.sh`	交易日历、时间信息

使用方法

脚本位于 skill 目录的 scripts/ 子目录下，使用 bash \x3C脚本> \x3C子命令> [参数...] 格式调用。调用前请确保 FINSTEP_SIGNATURE 已通过安全方式预先配置（详见 Requirements）。

1. 搜索新闻/研报/公告

bash scripts/search.sh news "关键词"
bash scripts/search.sh report "关键词"
bash scripts/search.sh announcement "股票代码或名称"
bash scripts/search.sh morning

2. 查询行情

# 实时行情快照 (支持代码或名称)
bash scripts/quote.sh snapshot "茅台"
bash scripts/quote.sh snapshot "600519"

# 板块行情快照
bash scripts/quote.sh snapshot_plate "白酒"

# K线数据 (代码 数量 类型 复权)
# 类型: 1=日K, 2=周K, 3=月K  |  复权: 1=不复权, 2=前复权, 3=后复权
bash scripts/quote.sh kline "600519" 30 1 2

# 分时数据
bash scripts/quote.sh intraday "600519"

# 大盘行情
bash scripts/quote.sh market

# 龙虎榜 (日期 [关键词])
bash scripts/quote.sh leader "2026-02-05"

# 资金流向 (关键词 [结束日期] [开始日期])
bash scripts/quote.sh flow "600519"

# 热门行业
bash scripts/quote.sh trending

# 投资日历 (开始日期 结束日期)
bash scripts/quote.sh calendar "2026-02-05" "2026-02-10"

# 港股K线
bash scripts/quote.sh hk_kline "00700" 30

# 美股K线
bash scripts/quote.sh us_kline "AAPL" 30

3. 板块数据

# 板块列表 ([关键词] [类型: concept/industry])
bash scripts/plates.sh list "白酒"

# 板块涨跌排名
bash scripts/plates.sh ranking

# 查询股票所属板块
bash scripts/plates.sh stock "茅台"

# 板块成分股
bash scripts/plates.sh stocks "白酒"

4. 公司信息

bash scripts/company.sh base "600519"        # 公司基本信息
bash scripts/company.sh security "600519"    # 证券信息
bash scripts/company.sh finance "600519"     # 财务信息 ([结束日期])
bash scripts/company.sh valuation "600519"   # 估值指标 ([结束日期] [开始日期])
bash scripts/company.sh holders "600519" "01"  # 股东信息 (01=十大股东, 02=十大流通股东)
bash scripts/company.sh holders_num "600519" # 股东人数
bash scripts/company.sh balance "600519"     # 资产负债表
bash scripts/company.sh cashflow "600519"    # 现金流量表
bash scripts/company.sh income "600519"      # 利润表
bash scripts/company.sh business "600519"    # 主营业务
bash scripts/company.sh industry "600519"    # 申万行业分类

5. 宏观数据

bash scripts/macro.sh lpr          # LPR 利率
bash scripts/macro.sh bond         # 中美国债收益率
bash scripts/macro.sh pboc         # 央行公开市场操作 ([日期])
bash scripts/macro.sh pboc_week    # 央行一周操作汇总 ([周末日期])
bash scripts/macro.sh rrr          # 存款准备金率
bash scripts/macro.sh pmi          # PMI指数 ([结束日期] [开始日期])
bash scripts/macro.sh cpi          # CPI
bash scripts/macro.sh ppi          # PPI
bash scripts/macro.sh gdp          # GDP季度
bash scripts/macro.sh unemployment # 失业率
bash scripts/macro.sh house "北京" # 主要城市房价 (城市 [结束日期] [开始日期])

6. 通用工具

bash scripts/common.sh time        # 获取当前时间
bash scripts/common.sh trade_info  # 交易日信息（是否交易日、上下一个交易日）

# 交易日历 (开始日期 结束日期 市场)
# 市场: 18=北交所, 83=上交所, 90=深交所, 72=港交所, 78=纽交所
bash scripts/common.sh trade_date "2026-02-01" "2026-02-28" 83

API 端点

Base URL: http://fintool-mcp.finstep.cn

端点	用途
/common	通用工具
/market_quote	行情数据
/plates	板块数据
/company_info	公司信息
/macro	宏观数据
/search	搜索服务

已知问题

plates.sh stocks (板块成分股): 接口返回"暂未找到相关股票信息"，可能是后端问题

注意事项

所有接口返回 JSON 格式
股票检索支持代码、名称、拼音等多种方式
部分接口有调用频率限制
K线数据单次最多100条，需要更多数据请分批调用

Usage Guidance

This package appears to be a straightforward Bash-based client for the Finstep MCP financial API and only needs a single API signature (FINSTEP_SIGNATURE). Before installing or using it: - Confirm the skill's provenance (owner/source is unknown and there is no homepage). Prefer code from a known vendor. - Provide FINSTEP_SIGNATURE as a secret (env var or secret manager), not in plaintext files. Be aware the scripts append the signature in the URL query string, which can leak in some logs/referrers; consider modifying the scripts to send the token in an Authorization header if the API supports it. - Review and decide if you want the 'url_parse' capability (common.sh) to be available, since it will cause the service to fetch arbitrary URLs you provide; avoid passing sensitive internal URLs. - Because this skill makes network calls to a remote domain, run it in an environment whose network access and secrets you control. If you need higher assurance, validate the service domain (fintool-mcp.finstep.cn) independently and prefer an official distribution or homepage.

Capability Analysis

Type: OpenClaw Skill Name: finstep-mcp Version: 1.0.6 The skill bundle provides a legitimate interface for the FinStep financial data service, covering stock quotes, company information, and macro-economic data. The Bash scripts (e.g., quote.sh, company.sh, search.sh) use curl and jq to interact with the official API endpoint (fintool-mcp.finstep.cn) and handle user-provided parameters safely using jq's argument binding to prevent injection. No evidence of data exfiltration, malicious execution, or prompt injection was found.

Capability Assessment

ℹ Purpose & Capability

The skill's name, description, SKILL.md, scripts, and skill.json consistently implement a financial-data client for the Finstep MCP service. However, the registry metadata at the top of the package summary (which listed no required env vars) contradicts the included skill.json and SKILL.md that require FINSTEP_SIGNATURE. Source is listed as unknown (no homepage), so provenance is unclear.

ℹ Instruction Scope

Runtime instructions (the bash scripts) stay within the declared scope: they build JSON-RPC requests and POST to fintool-mcp.finstep.cn endpoints for market, company, macro, plates, and search data. One function (common.sh -> url_parse) accepts an arbitrary URL and forwards it to the MCP 'url_parse' tool — this enables fetching/parsing arbitrary web pages (expected for a parsing helper but worth noting). Scripts don't read other system files or unrelated environment variables.

✓ Install Mechanism

This is an instruction-only skill with bundled shell scripts. There is no install spec that downloads external code, no package installs, and nothing is written to disk by an installer. Risk from install mechanism is low.

ℹ Credentials

The only secret required is FINSTEP_SIGNATURE (declared in skill.json and SKILL.md), which is proportionate to the stated API usage. Two minor concerns: (1) the registry metadata summary erroneously listed 'no required env vars', a mismatch to the code; (2) the scripts send the signature as a query parameter (?signature=...) which can leak the token in logs, referrers, or process listings — storing and using the token securely is recommended.

✓ Persistence & Privilege

always is false and the skill does not request persistent elevated privileges or modify other skills/config. It only performs outbound HTTPS requests to the service domain and requires a single API token.

Version History

v1.0.6

Version 1.0.6 - Added documentation of required binaries (bash, curl, jq, date) for script operation. - Expanded Requirements section to clarify environment and tool dependencies. - No changes to code or scripts; update is documentation-only for improved usability.

v1.0.5

- 增加了“Requirements”部分，明确说明必须设置 `FINSTEP_SIGNATURE` 环境变量，否则所有脚本调用会失败。 - 对环境变量使用进行了安全提示，建议使用 `.env`、密钥管理等规范方式配置，不要明文写入代码。 - 用表格格式突出必填环境变量，提高易用性和安全性。 - 其余脚本文档、用法和注意事项未做功能性更改，仅优化了说明结构和可读性。

v1.0.4

finstep-mcp 1.0.4 Changelog - 首次发布，提供财跃星辰金融数据全维度 API 服务，覆盖 A 股实时行情、板块、公司、宏观等数据。 - 提供 Bash 脚本工具，支持搜索、行情、板块、公司、宏观、通用工具等多类查询命令。 - 支持多种股票检索方式，接口全部返回 JSON 格式。 - 详细文档说明 API 使用方法和脚本参数要求。 - 列出已知限制及注意事项，帮助用户高效集成与使用服务。

v1.0.3

- 明确补充了 API 签名可从财跃星辰平台 https://product.finstep.cn/ 获取的说明。 - 其它文档内容无变化。

v1.0.2

finstep-mcp 1.0.0 - 首个版本发布，提供财跃星辰 A 股金融数据服务。 - 支持实时行情、板块数据、公司信息、宏观经济、研报新闻等多项查询脚本。 - 提供详细使用说明，包括 API 签名配置和各类数据脚本命令示例。 - 覆盖新闻/公告/研报搜索、快照与K线行情、板块列表与排名、公司财务/股东等信息、宏观经济指标及通用时间/交易日历工具。 - 提及接口调用注意事项与已知问题（如板块成分股接口异常）。

v1.0.0

Initial release of finstep-mcp skill, providing comprehensive financial data services for A-share markets. - Supports real-time stock quotes, sector data, company information, macroeconomic indicators, and research/news search. - Offers multiple Bash scripts for modular access to data: search, quote, plates, company, macro, and common utilities. - Requires users to set an API signature via the FINSTEP_SIGNATURE environment variable before use. - Covers diverse query scenarios, including K-line (A/H/US stocks), financial statements, macro reports, and board rankings. - Includes detailed usage examples and troubleshooting notes in the documentation.

Metadata

Slug finstep-mcp

Version 1.0.6

License MIT-0

All-time Installs 0

Active Installs 0

Total Versions 6

Frequently Asked Questions

What is finstep-mcp?

财跃星辰金融数据服务。提供实时行情、板块数据、公司信息、宏观经济、研报新闻等全方位金融数据。触发条件：用户查询股票行情、板块涨跌、公司财务、宏观数据、研报公告等金融信息。 It is an AI Agent Skill for Claude Code / OpenClaw, with 313 downloads so far.

How do I install finstep-mcp?

Run "/install finstep-mcp" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is finstep-mcp free?

Yes, finstep-mcp is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does finstep-mcp support?

finstep-mcp is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created finstep-mcp?

It is built and maintained by fa1c0n4826 (@fa1c0n4826); the current version is v1.0.6.

More Skills

finstep-mcp