← 返回 Skills 市场
investment-data
作者
StanleyChanH
· GitHub ↗
· v1.0.0
883
总下载
1
收藏
4
当前安装
1
版本数
在 OpenClaw 中安装
/install investment-data
功能描述
获取高质量 A 股投资数据,基于 investment_data 项目。支持日终价格、涨跌停数据、指数数据等。每日更新,多数据源交叉验证。触发词:股票数据、A股数据、金融数据、量化数据、历史行情。
使用说明 (SKILL.md)
A 股投资数据获取 Skill
基于 investment_data 项目,提供高质量 A 股投资数据。
🎯 核心功能
- 数据下载 - 自动下载最新数据集
- 数据查询 - 查询股票历史数据
- 数据更新 - 每日自动更新
- 多格式支持 - Qlib、CSV、JSON
📊 数据类型
- 日终价格 - 开高低收、成交量、成交额
- 涨跌停数据 - 涨跌停价格、涨跌停状态
- 指数数据 - 主要指数价格和权重
- 复权数据 - 前复权、后复权价格
🚀 快速开始
1. 下载最新数据
python scripts/download_data.py --latest
2. 查询股票数据
from scripts.data_client import InvestmentData
# 初始化客户端
client = InvestmentData()
# 查询单只股票
df = client.get_stock_data("000001.SZ", start_date="2024-01-01", end_date="2024-12-31")
# 查询指数成分
weights = client.get_index_weights("000300.SH")
# 查询涨跌停
limits = client.get_limit_data("000001.SZ", date="2024-12-01")
3. 批量查询
python scripts/query_batch.py --stocks "000001.SZ,000002.SZ" --start 2024-01-01 --end 2024-12-31 --output csv
📖 详细文档
🔧 配置
环境变量
# 数据存储路径(可选)
export INVESTMENT_DATA_DIR=~/.qlib/qlib_data/cn_data
# Tushare Token(可选,用于实时更新)
export TUSHARE_TOKEN=your_token_here
配置文件
编辑 config/config.yaml:
data:
# 数据存储路径
data_dir: ~/.qlib/qlib_data/cn_data
# 自动更新
auto_update: true
update_time: "09:00"
# 数据源优先级
sources:
- final
- ts
- ak
- yahoo
query:
# 默认输出格式
output_format: csv
# 日期格式
date_format: "%Y-%m-%d"
📝 使用示例
Python API
from scripts.data_client import InvestmentData
client = InvestmentData()
# 查询股票日 K 线
df = client.get_stock_daily("000001.SZ", "2024-01-01", "2024-12-31")
print(df.head())
# 查询指数数据
index_df = client.get_index_daily("000300.SH", "2024-01-01", "2024-12-31")
# 查询股票列表
stocks = client.get_stock_list(date="2024-12-31")
# 查询退市股票
delisted = client.get_delisted_stocks()
命令行
# 查询单只股票
python scripts/query.py --stock 000001.SZ --start 2024-01-01 --end 2024-12-31
# 批量查询
python scripts/query_batch.py --file stocks.txt --start 2024-01-01 --output json
# 更新数据
python scripts/update_data.py --daily
# 导出数据
python scripts/export.py --stock 000001.SZ --format excel
🔄 自动化
定时更新
使用 OpenClaw cron 自动更新:
# 每天早上 9:00 更新数据
schedule:
cron: "0 9 * * *"
task: "python scripts/update_data.py --daily"
批量处理
# 批量导出多只股票
python scripts/batch_export.py --stocks stocks.txt --output ./data/
⚠️ 注意事项
- 数据延迟:每日更新,T+1 数据
- 存储空间:需要约 5GB 存储空间
- 网络要求:需要访问 GitHub 和 DoltHub
- Tushare Token:实时更新需要 token
📊 数据质量
- ✅ 多源验证:交叉验证多个数据源
- ✅ 完整性好:包含退市公司数据
- ✅ 修正错误:自动修正数据异常
- ✅ 每日更新:自动化 CI/CD 流程
📚 相关资源
- GitHub:https://github.com/chenditc/investment_data
- DoltHub:https://www.dolthub.com/repositories/chenditc/investment_data
- 原始文档:https://github.com/chenditc/investment_data/blob/master/docs/README-ch.md
🤝 贡献
欢迎贡献代码、报告问题或提出建议!
📄 许可证
Apache 2.0
安全使用建议
这是一个以 GitHub release 为数据源、通过 Python 下载并在用户主目录下存储大数据集的技能。推荐在安装前注意以下几点:
- 验证 GitHub 仓库地址和发布页面是否可信(https://github.com/chenditc/investment_data)。
- 下载与解压会把大量文件写入 ~/.qlib/...(约 5GB);确保你同意并且有足够空间。
- download_data.py 使用 tarfile.extractall() 解压远程归档,存在路径遍历的风险(如果归档被篡改可能写入任意路径)。若你对安全敏感,可先手动下载并用安全工具检查归档内容再解压,或审计发布的 tar 内容。
- SKILL.md 声明 system binaries 包含 wget/tar,但脚本实际上使用 Python requests 与 tarfile;在某些环境下脚本用到的 'python' 可执行文件可能不是 python3,运行前确认 python 可执行文件指向合适的解释器(或手动用 python3 运行脚本)。
- 文档引用了若干在包内未找到的脚本(query_batch.py、update_data.py 等),这可能表示打包不完整或文档未同步;在依赖这些功能前先检查仓库/包内实际文件。
如果你仍想继续:在受控环境(非生产关键主机)中先运行 tests/或手动审查下载的 tar 内容;确认不提供 TUSHARE_TOKEN 给不可信方,因为该 token 是可选的,但若你提供则为个人凭证。
功能分析
Type: OpenClaw Skill
Name: investment-data
Version: 1.0.0
The skill is designed to download and manage financial data, which inherently involves network requests to GitHub and local file system operations (downloading, extracting, writing data files). The `scripts/download_data.py` fetches a `.tar.gz` archive from `github.com/chenditc/investment_data` and extracts it locally. While this functionality is central to the skill's stated purpose, it introduces a supply chain risk: if the upstream GitHub repository were compromised, malicious content could be delivered and executed. Additionally, `scripts/data_client.py` uses `subprocess.run` to execute `scripts/download_data.py`, which, while currently an internal call, represents a risky capability (potential RCE vulnerability) if not carefully controlled or if the target script were compromised. There is no evidence of intentional malicious behavior like data exfiltration or unauthorized remote control.
能力评估
Purpose & Capability
Skill 名称与说明表明它用于获取 A 股数据;代码和说明确实实现了下载、查询与导出功能,所需 Python 库(pandas/numpy/requests)与功能相匹配。值得注意的不一致:SKILL 要求系统二进制包含 wget 和 tar,但实际脚本使用 Python 的 requests 和 tarfile(并未调用系统 wget/tar)。文档中还引用了若干脚本(如 query_batch.py、update_data.py、export.py)在包内未全部找到,这表明打包或文档存在差异,但不足以表明恶意。
Instruction Scope
SKILL.md 指示运行 scripts/download_data.py 下载来自 GitHub release 的数据包并解压,脚本确实会向 api.github.com 和 github.com 发起请求并将归档解压到用户数据目录(默认 ~/.qlib/...)。脚本没有读取系统范围的敏感配置或请求额外环境变量(TUSHARE_TOKEN 为可选)。风险提示:download_data.py 使用 tarfile.extractall() 解压远端归档,若归档包含恶意路径或文件会导致写入任意路径(tar 路径遍历风险);不过下载源为 GitHub releases(受信任程度较高)。
Install Mechanism
没有 registry 层面的 install spec(instruction-only),SKILL.md 建议通过 pip 安装常见 Python 包,下载数据来自 GitHub Releases(常见且可审计的发布源)。没有看到来自不明域名、短链接或个人服务器的可疑二进制下载请求。唯一需要注意的是脚本会把解压内容写入用户数据目录(可能占用 ~5GB)。
Credentials
所需环境变量都是可选的:INVESTMENT_DATA_DIR(数据路径)和可选的 TUSHARE_TOKEN(用于实时更新)。没有要求任何 API keys、云凭据或其他敏感/无关的凭证,所需权限与功能相称。
Persistence & Privilege
skill 不具有 always:true,也没有请求修改其他技能或系统范围配置。它会在用户主目录下创建/写入数据目录并可能写日志文件,这是为了存储数据所需的有限本地持久化,权限和持久性在合理范围内。
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install investment-data - 安装完成后,直接呼叫该 Skill 的名称或使用
/investment-data触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
首个版本发布:基于 investment_data 项目的 A 股数据获取工具,支持日终价格、涨跌停、指数数据查询
元数据
常见问题
investment-data 是什么?
获取高质量 A 股投资数据,基于 investment_data 项目。支持日终价格、涨跌停数据、指数数据等。每日更新,多数据源交叉验证。触发词:股票数据、A股数据、金融数据、量化数据、历史行情。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 883 次。
如何安装 investment-data?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install investment-data」即可一键安装,无需额外配置。
investment-data 是免费的吗?
是的,investment-data 完全免费(开源免费),可自由下载、安装和使用。
investment-data 支持哪些平台?
investment-data 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 investment-data?
由 StanleyChanH(@stanleychanh)开发并维护,当前版本 v1.0.0。
推荐 Skills