功夫财经

MCP Tools

Mainland China A-share stock and sector analysis tool (中国A股个股与板块分析). Current repo build focuses on stable deterministic products for stock snapshots, basic finance indicators, chip/price levels, sector detail lookup, plus bucket, phase-2 strategy, researcher, bayesian monitor, and preview stock/sector deep research flows.

Install

openclaw skills install kungfu-finance

功夫财经 | KungfuFinance

Publisher

Organization: kungfu-trader
Source repository: github.com/kungfu-trader/kungfu-skills
Tianshan API operator: kungfu-trader (same organization)

Runtime Model

Local runtime: Node.js .mjs scripts (bundled executable scripts with zero npm dependencies — no npm install needed)
Outbound APIs:
- https://tianshan-api.kungfu-trader.com — deterministic products (snapshot, finance, bucket, strategy, researcher, bayesian monitor)
- https://push2.eastmoney.com / https://push2his.eastmoney.com — stock/sector deep research market data (free public API, no key required)
- https://ifzq.gtimg.cn / https://qt.gtimg.cn — fallback market data via Tencent Finance (free public API, no key required)
- https://wry-manatee-359.convex.site / https://clawhub.ai — check-update version query (ClawHub registry, public, no key required)
Authentication: KUNGFU_OPENKEY environment variable, sent as Authorization: Bearer <token> (Tianshan API only; EastMoney/Tencent/ClawHub APIs require no authentication)
Platform header: KUNGFU_PLATFORM (optional, defaults to openclaw)
File I/O: reads bundled assets; indicator-chart flow writes SVG/PNG to ~/.openclaw/workspace/finance-master/charts/
Subprocesses: indicator-chart flow invokes inkscape for SVG→PNG conversion; no other subprocesses

All environment variables are read from the host process; none are accepted from user prompts.

Optional Research Search Surface

When separately configured, stock/sector deep research may call an additional search endpoint. This surface is independent from the Tianshan API and uses its own credential boundary:

Env Var	Purpose
`KUNGFU_ENABLE_RESEARCH_SEARCH`	Set to `1` to enable
`KUNGFU_RESEARCH_SEARCH_PROVIDER`	Provider name (currently `web_search`)
`KUNGFU_RESEARCH_SEARCH_ENDPOINT`	Search service URL
`KUNGFU_RESEARCH_SEARCH_API_KEY`	Search service credential
`KUNGFU_RESEARCH_SEARCH_TIMEOUT_MS`	Search request timeout (default: 15000)

When search is enabled, requests are POSTed as JSON to KUNGFU_RESEARCH_SEARCH_ENDPOINT with KUNGFU_RESEARCH_SEARCH_API_KEY as Bearer token. KUNGFU_OPENKEY is never reused for search requests. If search is enabled but misconfigured, the result returns misconfigured status instead of silently failing.

Non-Secret Tuning Variables

Env Var	Purpose
`KUNGFU_ENABLE_EXPERIMENTAL_PRODUCTS`	Set to `1` to enable unreleased products
`KUNGFU_RESEARCH_DEFAULT_TARGET_DATE`	Override default research date (YYYYMMDD format, for testing)

Rollout Status

Deterministic products (snapshot, finance, bucket, strategy, researcher, bayesian monitor) use revalidated Tianshan backend routes
Preview stock-research / sector-research use public EastMoney/Tencent APIs for market data — no backend dependency for these flows
Experimental products require KUNGFU_ENABLE_EXPERIMENTAL_PRODUCTS=1
Preview stock-research / sector-research produce markdown_svg_preview with explicit degradation reporting

Data Handling & Network Surface

KUNGFU_OPENKEY is sent only to tianshan-api.kungfu-trader.com — never to EastMoney, Tencent, or any other host
EastMoney and Tencent Finance APIs are public and require no authentication
The code contacts no other hosts beyond those listed in the Runtime Model table above
Do not use this skill with secrets, personal data, or other sensitive user content

Scope

Mainland China A-shares only
Direct market-data lookup stays within one stock or one sector
No arbitrary whole-market screening
Not for US stocks
Not for Hong Kong stocks
Not for cryptocurrencies
Not for futures or forex
No free-form SQL
No user-facing base URL
No user-facing runtime credential parameters

Public Intents

Route the user into the currently enabled intent families below. Do not expose internal product names unless needed for implementation.

1. Stock Snapshot

Use when the user wants one A-share stock's current state, recent走势, K-line window, holders,筹码分布,支撑压力位, or other narrow deterministic data.

Default behavior:

Prefer the narrowest data product that answers the question
If the stock code is unknown, prefer instrument_name
If code mode is used, exchange_id must be SSE or SZE

2. Finance Analysis

Use when the user wants one A-share stock's基础财务指标或基础财务上下文。

Default behavior:

Prefer finance_basic_indicators for narrow factual questions
Prefer finance_context for lightweight finance context

3. Sector Analysis

Use when the user asks about one A-share industry or sector.

Default behavior:

deterministic sector detail products may still use sector_name
fuzzy sector resolution is not exposed as a standalone public product, but sector-research resolves theme words by matching against the full EastMoney concept sector list
preview sector-research accepts sector_name or sector_id directly; when the local resolver cannot disambiguate, it returns needs_input for the user to provide a BK code

3C. Sector Deep Research

Use when the user wants one A-share sector's deep research, hype-cycle view, thematic thesis, dragon-head observation, committee-style bull/bear review, or a longer structured report.

Default behavior:

current runtime only supports one mainland China A-share sector per invocation
the preview path accepts sector_name or sector_id; target_date is optional and defaults to the current market date in Asia/Shanghai
the current version is markdown_svg_preview and returns explicit degradations for remaining search / adapter gaps
the result surface now also exposes the migrated orchestration contract from the original sector-analysis skill
the result surface now includes report_svg and quality_gate
structured inputs now use public EastMoney APIs: concept sector list resolution, sector constituents, sector index K-line, and per-leader stock quotes and money flow
the sector resolver matches user input against the full EastMoney concept sector list; if ambiguous, returns needs_input for the user to provide a BK code
when the separate web_search runtime is enabled and configured, macro / policy / catalyst / industry-trend / competition / money-flow evidence may be attached as external search evidence (7 search buckets)
otherwise the report must surface missing search evidence as degraded coverage instead of silently inventing facts

3B. Stock Deep Research

Use when the user wants one A-share stock's deep research, investment thesis, catalyst map, committee-style bull/bear review, or a longer structured report.

Default behavior:

current runtime only supports one mainland China A-share stock per invocation
the preview path accepts optional target_date and defaults it to the current market date in Asia/Shanghai
the current version is markdown_svg_preview and returns explicit degradations for remaining search / adapter gaps
the result surface now also exposes the migrated orchestration contract from the original stock-analysis-v2 skill
the result surface now includes report_svg and quality_gate
structured market data now comes from public EastMoney APIs: real-time quote, daily K-line, real weekly K-line (klt=102, not aggregated from daily), and 20-day money flow; Tencent Finance APIs serve as fallback
financial statements, company profile, and other non-market data are sourced from web search (8 search buckets: macro, catalyst, risk, competition, financials, company profile, governance, sector trend)
when the separate web_search runtime is enabled and configured, these evidence buckets are populated; otherwise the report surfaces explicit degradations

4. Bucket Flow

Use when the user wants to:

view current-user buckets
choose one existing bucket
add one or more instruments into that bucket

Default behavior:

only operate on the current authenticated user's own buckets
do not create or delete buckets in the current release build
when adding a batch, resolve instruments first and filter invalid ones before writing
when required information is missing or ambiguous, return a structured needs_input response so the host can continue the dialogue
if all inputs are invalid, return needs_input for corrected instruments instead of calling the write API

5. Strategy Flow

Use when the user wants to:

view public strategies
view public strategies by market mode
view current-user private strategies
query one public or private strategy on one stock
query one public or private select strategy's whole-market picks for one day or one date range
count buy signals for one stock across eligible public paid strategies
batch scan one public paid strategy across multiple stocks

Default behavior:

strategy module requires runtime auth even when listing public strategies
public and private strategies both support single-strategy query
public and private select strategies both support controlled whole-market result query
private strategies do not support first-stage batch scan
batch scan only supports public strategies with non-empty lago_plan
market-select supports InstrumentSelect, TemplateInstrumentSelect, BuySell, and TemplateBuySell
when market-select is used on BuySell or TemplateBuySell, whole-market results only return buy points
market-select accepts either target_date, or strategy_start_date + strategy_end_date
if market-select mixes the two date modes, or only provides half of a range, return a structured needs_input response
when strategy selector or stock input is missing or ambiguous, return a structured needs_input response so the host can continue the dialogue
when the selected public paid strategy lacks permission for batch scan, return a structured blocked response instead of pretending the scan succeeded

6. Researcher Flow

Use when the user wants to:

view top researchers by score
view one stock's covered researchers together with report titles
view one researcher's reports

Default behavior:

researcher module requires runtime auth
researcher backend also enforces Journeyman membership or above
stock-reports is a composed flow built from researcher score plus researcher report list
author-reports prefers researcher-author-id
if the user only gives researcher-name, resolve it conservatively; if not unique, return needs_input
do not pretend the backend supports direct global researcher-name search if it does not

7. Bayesian Monitor Flow

Use when the user wants to:

view current-user bayesian monitor tasks
choose one existing bayesian monitor task
inspect that task's initial report and recent monitor records

Default behavior:

bayesian monitor module requires runtime auth
only operate on the current authenticated user's own tasks
current release build is read-only: do not create, delete, or run bayesian monitor tasks
list returns task summaries only and must not expose full original_report
reports supports bayesian-task-id and conservative bayesian-topic resolution
when task selector is missing or ambiguous, return a structured needs_input response so the host can continue the dialogue
when the current user has no tasks, return a structured blocked response instead of pretending the task exists

8. Indicator Chart

Use when the user wants to see one A-share stock's technical indicator chart. The script automatically renders SVG, converts to PNG via inkscape, and returns file paths (no SVG text in stdout). Supported chart types:

kline — K线图 (candlestick chart with optional chip distribution overlay, price level lines, and custom annotations)
lushan_shadow — 庐山照影图 (CM mountain + FC shadow dual-bar chart)
lushan_4season — 庐山四季图 (GG/HY/DP lines + RS bars + bottom resonance/strong markers)
shuanglun — 双轮驱动图 (K-wheel + R-wheel stacked bars with trend coloring)
liumai — 六脉神剑图 (6-signal heatmap matrix with buy/sell signal row)
smart_money — 聪明钱图 (smart money vs follow money dual-line chart)
finance_score — 个股综合得分 (radar chart with 行业统治力/财务健康度/发展前景 three-dimensional scoring)

K-line chart additional options:

--with-chip-peak true — overlay chip distribution (筹码峰) on the right side
--with-price-levels true — draw support/resistance/concentration price level lines (阻力位/支撑位)
--annotations '[{"date":"20260328","price":15.5,"type":"buy","label":"买入点","color":"#ef4444"}]' — mark custom points on the chart

9. Finance Score

Use when the user wants one A-share stock's comprehensive scoring across three dimensions:

行业统治力 (Industry Dominance) — scored 0-5 with S/A/B/C/D/E grade
财务健康度 (Financial Health) — scored 0-5 with S/A/B/C/D/E grade
发展前景 (Growth Potential) — scored 0-5 with S/A/B/C/D/E grade
综合得分 (Total Score) — 0-15

Available as both a data product (finance_score) and a rendered SVG chart (indicator-chart --chart-type finance_score).

10. Subscription Flow (自选)

Use when the user wants to:

view current-user subscribed instruments (自选列表)
add instruments to subscription (加自选)
remove instruments from subscription (删自选)
view anomaly report for one subscribed instrument (异动报告)
view aggregate anomaly summary (异动汇总)

Default behavior:

only operate on the current authenticated user's own subscriptions
when adding, resolve instrument names first and skip invalid or duplicate entries
list groups subscriptions by instrument and shows instrument name, code, auto-update status
anomaly returns unusual movements sorted by date descending, plus signals count and analysis
summary returns aggregate UM_ct (异动数量) and UM_SG_ct (异动信号) counts
when required information is missing, return a structured needs_input response

Not Yet Enabled In Experience Build

The following capabilities are still under route-contract cleanup and should not be used in the current public rollout:

full finance-analysis bundles
money flow
fuzzy sector resolution / similar sectors
market news lookup
standalone fuzzy sector resolution as a separate public deterministic intent outside sector-research

Intent Routing

Pick one default route from the list below.

User asks "这只股票现在怎么样 / 最近走势 / 看看价格": Route to Stock Snapshot
User asks "分析财报 / 财务怎么样 / 估值怎么看": Route to Finance Analysis
User asks "分析白酒 / 算力 / 某个板块 / 某个概念": Route to Sector Analysis
User asks "给我做贵州茅台的深度研究 / 做一个投资论题 / 看催化剂和风险 / 写一份个股深度报告": Route to Stock Deep Research
User asks "看看我的票池 / 把这些股票加到票池里": Route to Bucket Flow
User asks "有哪些策略 / 看看我的私人策略 / 某个策略今天有没有买卖点 / 庐山升龙今天选了哪些股票 / 某个策略最近一周选股结果 / 用某个策略扫一组股票": Route to Strategy Flow
User asks "画一下贵州茅台的K线图 / 庐山照影 / 庐山四季 / 双轮驱动 / 六脉神剑 / 聪明钱 / 带筹码峰的K线 / 标注买卖点": Route to Indicator Chart
User asks "贵州茅台的综合得分 / 行业统治力 / 财务健康度 / 发展前景": Route to Finance Score
User asks "评分最高的研究员有哪些 / 某个股票有哪些研究员和研报 / 某个研究员写过哪些研报": Route to Researcher Flow
User asks "看看我的贝叶斯监控 / 某个贝叶斯监控任务的报告 / 某个主题最近的贝叶斯监控记录": Route to Bayesian Monitor Flow
User asks "功夫财经连接正常吗 / OpenKey 配置对吗 / health check / 检查配置": Route to Health Check
User asks "配置 OpenKey / 设置 OpenKey / 我的 key 是 kf_xxx": Route to Config OpenKey
User asks "看看我的自选 / 自选列表 / 我订阅了哪些股票": Route to Subscription Flow (action: list)
User asks "把贵州茅台加入自选 / 加自选 / 订阅这些标的": Route to Subscription Flow (action: add)
User asks "从自选中移除平安银行 / 取消订阅 / 删除自选": Route to Subscription Flow (action: delete)
User asks "贵州茅台有什么异动 / 查看异动 / 最近的异动报告": Route to Subscription Flow (action: anomaly)
User asks "自选整体异动情况 / 今天有多少异动 / 异动汇总": Route to Subscription Flow (action: summary)
User asks "功夫财经有更新吗 / 检查更新 / check update / 升级 skill": Route to Check Update

If the user asks for arbitrary whole-market screening or market-news bundles, do not use this skill in the current release build.

Input Rules

Stock Identification

For single-stock requests, use exactly one:

--instrument-name
--instrument-id and --exchange-id

Never mix both modes. If the stock code is unknown, prefer --instrument-name. When using code mode, --exchange-id must be SSE or SZE.

Stock Date Mode

For stock products and flows, use:

--target-date
optional --visual-days-len

Strategy Date Mode

For strategy actions, use:

signal and count: --target-date with optional --visual-days-len
batch-scan: --target-date
market-select: either --target-date, or --strategy-start-date plus --strategy-end-date

Never mix single-day mode and range mode in the same market-select request.

Sector Mode

For sector detail products, use exactly one:
- --sector-name
- --sector-id

Prefer --sector-name. Only reuse --sector-id after the backend has already returned it. The current release build does not expose fuzzy sector resolution as a standalone public data product, but sector-research can resolve theme words via the EastMoney concept sector list.

Hidden Parameters

Do not generate or expose these from the model side:

start_date
end_date
is_realtime
limit
days
periods

Internal Building Blocks

The internal deterministic product contract lives here:

data_products.md

Use that file only when you need exact internal product names, allowed parameter shapes, or output keys. Do not dump that whole catalog into the user-facing reasoning path by default.

Bucket flow contract lives here:

bucket_flow.md

Strategy flow contract lives here:

strategy_flow.md

Researcher flow contract lives here:

researcher_flow.md

Bayesian monitor flow contract lives here:

bayesian_monitor_flow.md

Research Methodologies

Documented research methods live here:

Use them as methodology references and migration inputs for deep research. The repo build currently has preview CLI/runtime entrypoints via stock-research and sector-research. The sector preview accepts sector_name first and uses best-effort EastMoney concept list resolution before falling back to needs_input. Read runtime_parity.md before treating any research wrapper or asset as implementation-ready truth.

Prompt assets are flow-specific. Do not mix finance-analysis formatting requirements into movement-analysis outputs, or vice versa.

Standard Commands

Stock Snapshot

node scripts/flows/run_data_request.mjs --product price_snapshot --instrument-name 贵州茅台 --target-date 20260301

Sector Detail

node scripts/flows/run_data_request.mjs --product sector_performance --sector-name 白酒 --target-date 20260301

Bucket List

node scripts/router/run_router.mjs bucket --bucket-action list

Bucket Add

node scripts/router/run_router.mjs bucket --bucket-action add --bucket-name 观察池 --bucket-instrument 贵州茅台 --bucket-instrument 平安银行

Strategy List

node scripts/router/run_router.mjs strategy --strategy-action list

Strategy Signal

node scripts/router/run_router.mjs strategy --strategy-action signal --strategy-name 三分归元 --instrument-name 贵州茅台 --target-date 20260331 --visual-days-len 22

Strategy Batch Scan

node scripts/router/run_router.mjs strategy --strategy-action batch-scan --strategy-id 900 --strategy-instrument 600519.SSE --strategy-instrument 000001.SZE --target-date 20260331

Strategy Market Select

node scripts/router/run_router.mjs strategy --strategy-action market-select --strategy-name 庐山升龙 --target-date 20260331

Stock Deep Research

node scripts/router/run_router.mjs stock-research --instrument-name 贵州茅台 --target-date 20260331 --visual-days-len 120

Sector Deep Research

node scripts/router/run_router.mjs sector-research --sector-name 机器人 --target-date 20260331 --visual-days-len 780

Indicator Chart — K-line

node scripts/router/run_router.mjs indicator-chart --chart-type kline --instrument-name 贵州茅台 --target-date 20260331 --visual-days-len 120

Indicator Chart — K-line with Chip Peak and Price Levels

node scripts/router/run_router.mjs indicator-chart --chart-type kline --instrument-name 贵州茅台 --target-date 20260331 --visual-days-len 120 --with-chip-peak true --with-price-levels true

Indicator Chart — K-line with Annotations

node scripts/router/run_router.mjs indicator-chart --chart-type kline --instrument-name 贵州茅台 --target-date 20260331 --visual-days-len 60 --annotations '[{"date":"20260310","type":"buy","label":"买入"},{"date":"20260325","type":"sell","label":"卖出"}]'

Indicator Chart — 庐山照影图

node scripts/router/run_router.mjs indicator-chart --chart-type lushan_shadow --instrument-name 贵州茅台 --target-date 20260331 --visual-days-len 120

Indicator Chart — 庐山四季图

node scripts/router/run_router.mjs indicator-chart --chart-type lushan_4season --instrument-name 贵州茅台 --target-date 20260331 --visual-days-len 120

Indicator Chart — 双轮驱动图

node scripts/router/run_router.mjs indicator-chart --chart-type shuanglun --instrument-name 贵州茅台 --target-date 20260331 --visual-days-len 120

Indicator Chart — 六脉神剑图

node scripts/router/run_router.mjs indicator-chart --chart-type liumai --instrument-name 贵州茅台 --target-date 20260331 --visual-days-len 120

Indicator Chart — 聪明钱图

node scripts/router/run_router.mjs indicator-chart --chart-type smart_money --instrument-name 贵州茅台 --target-date 20260331 --visual-days-len 120

Finance Score (data only)

node scripts/flows/run_data_request.mjs --product finance_score --instrument-name 贵州茅台 --target-date 20260331

Finance Score (SVG radar chart)

node scripts/router/run_router.mjs indicator-chart --chart-type finance_score --instrument-name 贵州茅台 --target-date 20260331

Researcher Rank

node scripts/router/run_router.mjs researcher --researcher-action rank --researcher-rank-by 1m --researcher-limit 10

Researcher Stock Reports

node scripts/router/run_router.mjs researcher --researcher-action stock-reports --instrument-name 贵州茅台

Researcher Author Reports

node scripts/router/run_router.mjs researcher --researcher-action author-reports --researcher-author-id author-1

Health Check

node scripts/router/run_router.mjs health

Returns { healthy: true/false, checks: { openkey, api_test } }. Verifies KUNGFU_OPENKEY is set and authenticates against the backend.

Config OpenKey

node scripts/router/run_router.mjs config-openkey --openkey kf_ok_live_xxxxx

Validates the key against the backend, then writes it to ~/.openclaw/.env. Returns user_id and plan_code on success.

Subscription List (自选列表)

node scripts/router/run_router.mjs subscription --subscription-action list

Subscription Add (加自选)

node scripts/router/run_router.mjs subscription --subscription-action add --subscription-instrument 贵州茅台 --subscription-instrument 平安银行

Subscription Delete (删自选)

node scripts/router/run_router.mjs subscription --subscription-action delete --subscription-instrument 贵州茅台

Subscription Anomaly Report (异动报告)

node scripts/router/run_router.mjs subscription --subscription-action anomaly --instrument-name 贵州茅台 --target-date 20260401

Subscription Summary (异动汇总)

node scripts/router/run_router.mjs subscription --subscription-action summary

Check Update

node scripts/router/run_router.mjs check-update

Checks ClawHub registry for a newer version. Returns { update_available, local_version, remote_version, update_command }. When an update is available, the agent should run the returned update_command (clawhub update kungfu-finance) in a shell to apply it.

功夫财经

Install

功夫财经 | KungfuFinance

Publisher

Runtime Model

Optional Research Search Surface

Non-Secret Tuning Variables

Rollout Status

Data Handling & Network Surface

Scope

Public Intents

1. Stock Snapshot

2. Finance Analysis

3. Sector Analysis

3C. Sector Deep Research

3B. Stock Deep Research

4. Bucket Flow

5. Strategy Flow

6. Researcher Flow

7. Bayesian Monitor Flow

8. Indicator Chart

9. Finance Score

10. Subscription Flow (自选)

Not Yet Enabled In Experience Build

Intent Routing

Input Rules

Stock Identification

Stock Date Mode

Strategy Date Mode

Sector Mode

Hidden Parameters

Internal Building Blocks

Research Methodologies

Standard Commands

Stock Snapshot

Sector Detail

Bucket List

Bucket Add

Strategy List

Strategy Signal

Strategy Batch Scan

Strategy Market Select

Stock Deep Research

Sector Deep Research

Indicator Chart — K-line

Indicator Chart — K-line with Chip Peak and Price Levels

Indicator Chart — K-line with Annotations

Indicator Chart — 庐山照影图

Indicator Chart — 庐山四季图

Indicator Chart — 双轮驱动图

Indicator Chart — 六脉神剑图

Indicator Chart — 聪明钱图

Finance Score (data only)

Finance Score (SVG radar chart)

Researcher Rank

Researcher Stock Reports

Researcher Author Reports

Health Check

Config OpenKey

Subscription List (自选列表)

Subscription Add (加自选)

Subscription Delete (删自选)

Subscription Anomaly Report (异动报告)

Subscription Summary (异动汇总)

Check Update

Related skills