ClawHub

Akshare Router Cn

v1.0.0

中文期货期权数据路由器，根据频率、品类和计算需求匹配免费AKShare数据源及对应处理方案。

⭐ 0· 383·3 current·3 all-time
by@forevershu

Install

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for forevershu/akshare-router-cn.

Previewing Install & Setup.
Prompt PreviewInstall & Setup
Install the skill "Akshare Router Cn" (forevershu/akshare-router-cn) from ClawHub.
Skill page: https://clawhub.ai/forevershu/akshare-router-cn
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.

Command Line

CLI Commands

Use the direct CLI path if you want to install manually and keep every step visible.

OpenClaw CLI

Canonical install target

openclaw skills install forevershu/akshare-router-cn

ClawHub CLI

Package manager switcher

npx clawhub@latest install akshare-router-cn
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
high confidence
✓
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.
Assessment
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.

Like a lobster shell, security has layers — review code before you run it.

latestvk972c6jst3sc3c1zr3b1ytwxed82f6jf
383downloads
0stars
1versions
Updated 1mo ago
v1.0.0
MIT-0
@forevershu
latest
Download

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】→ realtime 或 intraday
  • 命中【日线/历史/从…到…/近一年/回测】→ 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/<name>.md：按步骤执行
  3. 如果 recipe 引用 method（例如 RR25/指标计算），再 read methods/<name>.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 ...），可以在二期做，不影响本期路由文档结构。

Comments

Loading comments...