mcpField
F
findata-toolkit-cn

findata-toolkit-cn

github.com/yuping322データ・データベース2149 回インストール36 週間前に更新
リポジトリ

findata-toolkit-cn について

A株の調査や定量分析向けの金融データツールキットです。AKShare経由で相場、財務、マクロ経済データを取得し、356のインターフェースと再利用可能なビューを備えています。データソースにAPIキーは不要です。

主な機能

  1. 01356個のAKShareインターフェース実行
  2. 02複数ツールをデータビューに統合
  3. 03A株の相場・財務データ取得
  4. 04中国のマクロ経済指標の照会
  5. 05JSON出力とファイルキャッシュ

活用シーン

  1. 01A株のスクリーニングと財務指標の確認
  2. 02過去の相場と資金フローの分析
  3. 03金利・インフレ・PMIデータの確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/yuping322/finskills --skill findata-toolkit-cn

インストール後、Claude Code で/findata-toolkit-cnを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

LICENSE.txt
requirements.txt
config/
data_sources.yaml
scripts/
akshare_tools.py
macro_data.py
stock_data.py
views_runner.py
scripts/common/
__init__.py
akshare_runner.py
cache.py
config.py
litellm_tools.py
utils.py
scripts/views/
__init__.py
_helpers.py
ab_ah_premium_dashboard.py
block_deal_dashboard.py
cninfo_disclosure_relation_search.py
cninfo_disclosure_search.py
concept_board_detail.py
concept_board_snapshot.py
dividend_actions_dashboard.py
dragon_tiger_daily.py
dragon_tiger_stock_detail.py
equity_pledge_dashboard.py
fund_flow_dashboard.py
goodwill_dashboard.py
hot_rank_sentiment_dashboard.py
hsgt_dashboard.py
industry_board_detail.py

詳細

プロジェクトの README より

金融数据工具包 — A股市场

自包含的数据工具包，提供A股市场实时金融数据和定量计算。所有数据源免费，无需API密钥。

安装

安装依赖（一次性）：

pip install -r requirements.txt

可用工具

所有脚本位于 scripts/ 目录。从技能根目录运行。

0. AKShare 工具全集（config/litellm_tools.json → scripts/akshare_tools.py）

本工具包内置 config/litellm_tools.json（356 个接口定义），并提供统一的“工具运行器”脚本：

  • 列出工具：python scripts/akshare_tools.py list --contains fund_flow
  • 查看某工具入参 schema：python scripts/akshare_tools.py describe stock_zt_pool_em
  • 直接调用（无参数）：python scripts/akshare_tools.py stock_zh_a_spot_em
  • 直接调用（带参数）：python scripts/akshare_tools.py stock_individual_info_em --set symbol=000001
  • JSON 入参调用：python scripts/akshare_tools.py stock_zh_a_hist --args '{"symbol":"000001","period":"daily","start_date":"20250101","end_date":"20250201","adjust":"qfq"}'

说明：

  • 默认启用文件缓存（FINSKILLS_CACHE_DIR 可指定缓存目录）；可用 --no-cache 关闭，--refresh 强制刷新。
  • token/timeout 等参数在工具定义中可能被标记为必填但默认 None；运行器会尽量做兼容处理（缺省则填 None）。
0.5 组合视图 Views（scripts/views_runner.py）

Views 用于把多个底层工具（356 个接口）组合成更稳定、可复用的“数据视图”，供上层分析技能直接引用。

  • 同时，Views Runner 会把 356 个底层工具自动暴露为同名 view（view 名 == tool 名），从而在上层只需要统一调用 views。
  • 列出可用 views：python scripts/views_runner.py list
  • 查看 view 入参：python scripts/views_runner.py describe fund_flow_dashboard
  • 运行 view：python scripts/views_runner.py fund_flow_dashboard
  • 常用视图示例：python scripts/views_runner.py repurchase_dashboard、python scripts/views_runner.py block_deal_dashboard
  • 运行“工具同名 view”（等价于直接调用 tool）：python scripts/views_runner.py stock_zh_a_spot_em
  • 只看计划不执行（便于写 references）：python scripts/views_runner.py dragon_tiger_daily --set date=20250211 --dry-run

远程模式（推荐用于产品化/稳定取数）：

  • 设置 FINSKILLS_VIEW_API_URL 或使用 --remote-url，list/describe/run 会直连远端 View API（只消费 {meta,data,warnings,errors}，不做本地清洗/转换）。
  • 示例：FINSKILLS_VIEW_API_URL=http://127.0.0.1:8808 python scripts/views_runner.py list
  • 示例：python scripts/views_runner.py --remote-url http://127.0.0.1:8808 repurchase_dashboard --set symbol=000001
  • 远端可以暴露任意 view 名称（包括“工具同名 view”）；本地只按 view 名调用。
  • 远程模式下 --dry-run 不可用（远端 API 默认不暴露 plan）。

可选鉴权/超时：

  • FINSKILLS_VIEW_API_TOKEN（Bearer）或 FINSKILLS_VIEW_API_KEY
  • FINSKILLS_VIEW_API_TIMEOUT（秒，默认 30）

输出可靠性提示：

  • 所有 tool/view 输出均为统一 envelope：{meta, data, warnings, errors}；请优先检查 errors 和 warnings 再做结论。
  • meta.as_of 记录抓取时间；若命中缓存，会在 meta.cache 里看到缓存 age/ttl。
  • 每次 tool 调用的 meta.result 会尽量附带结果类型与规模（如 type/rows/columns）；空结果会写入 warnings，避免“无数据=无事件”的误判。
1. A股数据 (scripts/stock_data.py)

通过 AKShare 获取A股基本面、行情、财务指标。

命令用途
python scripts/stock_data.py 600519基本信息（贵州茅台）
python scripts/stock_data.py 600519 --metrics完整财务指标（估值、盈利、杠杆、增长）
python scripts/stock_data.py 600519 --history历史OHLCV行情
python scripts/stock_data.py 600519 --financials利润表、资产负债表、现金流量表
python scripts/stock_data.py 600519 --insider董监高增减持数据
python scripts/stock_data.py --northbound北向资金流向（沪股通/深股通）
python scripts/stock_data.py 600519 000858 --screen批量筛选
2. 宏观数据 (scripts/macro_data.py)

通过 AKShare 获取中国宏观经济指标。

命令用途
python scripts/macro_data.py --dashboard完整宏观仪表盘
python scripts/macro_data.py --rates利率数据（LPR、Shibor）
python scripts/macro_data.py --inflationCPI/PPI数据
python scripts/macro_data.py --pmiPMI数据（制造业/非制造业）
python scripts/macro_data.py --social-financing社会融资规模 + M2
python scripts/macro_data.py --cycle经济周期阶段判断

数据来源

来源数据内容API密钥
AKShareA股行情、财务数据、董监高交易、北向资金、宏观指标无需

输出格式

所有脚本以 JSON 输出到标准输出，便于解析。错误信息输出到标准错误。

配置

可选：编辑 config/data_sources.yaml 自定义速率限制或添加付费数据源API密钥。

コメント

Markdown 対応