← Back to Skills Marketplace
forevershu

Akshare Router Cn

by forevershu · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
394
Downloads
0
Stars
3
Active Installs
1
Versions
Install in OpenClaw
/install akshare-router-cn
Description
中文期货期权数据路由器,根据频率、品类和计算需求匹配免费AKShare数据源及对应处理方案。
README (SKILL.md)

akshare-router-cn

面向中文用户的「AKShare 数据路由器」skill:把期货/期权问题按 频率(实时/分钟/日频)品类(期货/期权)是否需要二次加工(指标/Greeks/RR25) 三步分流到最合适的数据源与 recipe。

一期只覆盖 免费可用源:东方财富/新浪等公开页面对应的 AKShare 接口。不包含奇货可查/付费源


你要做的事(路由协议,必须遵守)

当用户提问时:

Step 0:抽取意图槽位

  • freq:realtime | intraday(minute) | daily/历史
  • asset:futures | options
  • need_compute:none | indicators | greeks_iv | rr25 | (组合)
  • scope:单合约 | 品种全合约 | 全市场/列表

Step 1:先判频率(实时优先)

  • 命中【实时/盘面/盘口/最新价/当前/成交量/持仓/分时/分钟/5m/30m】→ realtimeintraday
  • 命中【日线/历史/从…到…/近一年/回测】→ daily/历史

Step 2:再判品类(期货 vs 期权)

  • 命中【期货/主连/次主连/合约如 IF2403/ RB主连】→ futures
  • 命中【期权/看涨/看跌/行权价/隐含波动率/Delta/Gamma】→ options

Step 3:最后判是否二次加工

  • 命中【MA/EMA/MACD/RSI/布林/ATR/5m指标/30m指标】→ indicators
  • 命中【隐含波动率/IV/Delta/Gamma/Theta/Vega/Rho】→ greeks_iv
  • 命中【RR25/25D 风险逆转/Skew】→ rr25(需要 greeks_iv + 规则)

Step 4:按需加载(只读需要的文件)

  1. read maps/router.yml:找到对应 recipe
  2. read recipes/\x3Cname>.md:按步骤执行
  3. 如果 recipe 引用 method(例如 RR25/指标计算),再 read methods/\x3Cname>.md

入口路由表(文件)

  • maps/router.yml:意图 → recipe 文件名(唯一真源
  • maps/keywords.yml:中文关键词归一化(减少误判)
  • references/INDEX.md:AKShare 可用接口索引(只列一期用到的)

MVP 覆盖的用户高频需求

期货

  • 实时盘面/成交(某个品种所有合约):recipes/futures_realtime_board.md
  • 5m/30m 分钟线 + 技术指标:recipes/futures_kline_indicators.md

期权

  • 隐含波动率 + Greeks(基于上交所 ETF 期权):recipes/options_iv_greeks.md
  • RR25(基于 Delta 近似):recipes/options_rr25.md

运行方式(给会用工具的 agent)

  • 数据抓取与计算脚本在 scripts/;可用 exec 运行,例如:
    • python3 skills/akshare-router-cn/scripts/futures_realtime.py --symbol PTA
    • python3 skills/akshare-router-cn/scripts/futures_indicators.py --contract IF2008 --period 30
    • python3 skills/akshare-router-cn/scripts/options_rr25.py --underlying 510050 --trade_date 202603

TODO:如果未来要把脚本封装成统一 CLI(如 akrcn ...),可以在二期做,不影响本期路由文档结构。

Usage Guidance
This skill appears to do what it claims: route user intent to AKShare-based recipes and run small Python scripts that fetch and compute market data. Before installing, ensure your agent environment has Python with akshare and pandas available (the package is not installed by the skill). Understand that the scripts will make network requests to public data sources (Sina, Eastmoney via AKShare) and may fetch many contracts (which can be rate-limited or slow). If you don't trust the code, review the provided scripts (they are short and readable) before allowing the agent to execute them. If you plan to allow autonomous invocation, be aware the agent could run these scripts and issue network requests without prompting, so grant that capability only to agents you trust.
Capability Analysis
Type: OpenClaw Skill Name: akshare-router-cn Version: 1.0.0 The skill bundle is a legitimate financial data routing tool designed to interface with the AKShare library for Chinese futures and options data. It contains well-structured Python scripts (e.g., futures_indicators.py, options_rr25.py) for data retrieval and technical analysis, and the SKILL.md instructions provide a clear, non-malicious logic for an AI agent to process user intents. No evidence of data exfiltration, unauthorized execution, or harmful prompt injection was found.
Capability Assessment
Purpose & Capability
Name/description (AKShare router for CN futures/options) align with the included files and runtime behaviour: the repository contains recipes, routing maps, method docs, and Python scripts that call AKShare functions to fetch and post-process market data. No unrelated credentials, binaries, or config paths are requested.
Instruction Scope
SKILL.md limits actions to reading the included maps/recipes/methods and running the provided scripts. The scripts only access AKShare APIs and local files in the skill; they do not read arbitrary system files or environment variables, nor do they post data to unexpected external endpoints beyond the public data sources AKShare uses.
Install Mechanism
There is no install spec; this is instruction-only. The Python scripts import third-party packages (akshare, pandas) but the skill does not declare or install them. This is not malicious but means the runtime must already provide those dependencies; failing to do so will break execution. No downloads from untrusted URLs or archive extraction are present.
Credentials
The skill declares no required environment variables, credentials, or config paths and the code does not access secrets. All network access is to public market-data sources via akshare, which is appropriate for the stated functionality.
Persistence & Privilege
Flags show no forced persistence (always:false) and the skill does not request elevated privileges or modify other skills' configs. Autonomous invocation is allowed by platform default but this skill's scope and resource needs are limited.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install akshare-router-cn
  3. After installation, invoke the skill by name or use /akshare-router-cn
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of akshare-router-cn skill for Chinese financial data routing: - Directs futures and options queries by frequency, asset type, and processing need to the best free data source and recipe. - Supports real-time, minute, and daily data needs using public AKShare-compatible APIs (e.g., 东方财富, 新浪). - Covers high-frequency user scenarios: futures live board, intraday indicators, options Greeks/IV, and RR25 calculations. - Modular "router protocol" with intent extraction and stepwise routing for precise source selection. - Agent-guided workflow: YAML-based routing table and script execution instructions included.
Metadata
Slug akshare-router-cn
Version 1.0.0
License
All-time Installs 3
Active Installs 3
Total Versions 1
Frequently Asked Questions

What is Akshare Router Cn?

中文期货期权数据路由器,根据频率、品类和计算需求匹配免费AKShare数据源及对应处理方案。 It is an AI Agent Skill for Claude Code / OpenClaw, with 394 downloads so far.

How do I install Akshare Router Cn?

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

Is Akshare Router Cn free?

Yes, Akshare Router Cn is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Akshare Router Cn support?

Akshare Router Cn is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Akshare Router Cn?

It is built and maintained by forevershu (@forevershu); the current version is v1.0.0.

💬 Comments