Tushare Openclaw Skill

Tushare Pro 金融数据 API 查询助手。用于帮助用户查询中国股票、基金、期货、债券等金融数据。当用户需要获取股票行情、财务数据、基础信息、宏观经济数据时使用此 skill。

Security Scan

The skill is an instruction-only helper for the Tushare Pro API and its declared behavior aligns with that purpose; it does not request unrelated credentials or install code, but it omits mentioning runtime dependencies (Python/tushare) and expects the user to supply a Tushare token.

Purpose & Capability

The SKILL.md shows Python SDK and HTTP examples for Tushare Pro and all instructions are consistent with a Tushare helper. However, the skill metadata declares no required binaries or installs even though the instructions assume Python and the 'tushare' package (or curl for HTTP). This is a minor mismatch: the skill will need a runtime with Python and/or curl and the tushare package to operate as documented.

Instruction Scope

Instructions are scoped to calling Tushare endpoints (api.tushare.pro) and using the Python SDK or curl. They do not instruct the agent to read unrelated files, system credentials, or to transmit data to third-party endpoints beyond Tushare. A referenced local doc path (references/api-reference.md) is mentioned but not included, which is a documentation inconsistency only.

Install Mechanism

No install spec (instruction-only), so nothing will be downloaded or written to disk by an installer. This is the lowest-risk install pattern.

Credentials

The skill requests no environment variables or credentials in metadata. The SKILL.md correctly notes that a Tushare token is required for API calls; asking the user for that token is appropriate and proportional to the stated purpose. There are no unrelated credential requests.

Persistence & Privilege

always:false and no special persistence or system modifications are requested. Autonomous invocation is allowed (platform default) but not combined with other concerning privileges.

Assessment

This skill appears to do what it says: it provides examples for calling the Tushare Pro API. Before installing/using it, note: (1) you will need a valid Tushare token — keep it secret and do not paste it in public channels; prefer the agent's secure secret storage if available; (2) the skill assumes a runtime with Python and the 'tushare' package (or curl) but does not declare or install them — ensure those tools are present and up-to-date; (3) the skill talks to api.tushare.pro and follows Tushare's rate/points limits — be aware of quota and potential costs for high-frequency queries; (4) the SKILL.md references a local doc file that is not included, which is only a documentation gap. If you need the agent to run code on your machine, confirm the execution environment and dependency availability first.

Tushare API Skill

简介

Tushare Pro 是中国领先的金融数据平台，提供股票、基金、期货、债券、外汇、数字货币等全品类金融大数据。

官网: https://tushare.pro API 文档: https://tushare.pro/document/2

股票代码规范

所有股票代码都需要带后缀：

交易所	后缀	示例
上海证券交易所	.SH	600000.SH
深圳证券交易所	.SZ	000001.SZ
北京证券交易所	.BJ	835305.BJ
香港证券交易所	.HK	00001.HK

常用 API 接口

基础数据

• stock_basic - 股票基础信息
• trade_cal - 交易日历
• stock_company - 上市公司基本信息
• new_share - IPO 新股列表

行情数据

• daily - 日线行情
• weekly - 周线行情
• monthly - 月线行情
• adj_factor - 复权因子
• daily_basic - 每日指标（PE/PB/市值等）

财务数据

• income - 利润表
• balance_sheet - 资产负债表
• cashflow - 现金流量表
• forecast - 业绩预告
• express - 业绩快报
• dividend - 分红送股
• fina_indicator - 财务指标

市场数据

• moneyflow - 个股资金流向
• limit_list - 每日涨跌停股票
• top_list - 龙虎榜数据
• block_trade - 大宗交易

使用方法

Python SDK

import tushare as ts

# 设置 token（需要用户自行申请）
pro = ts.pro_api('your_token_here')

# 获取股票列表
df = pro.stock_basic(exchange='', list_status='L', fields='ts_code,symbol,name,area,industry,list_date')

# 获取日线行情
df = pro.daily(ts_code='000001.SZ', start_date='20240101', end_date='20240201')

# 获取财务数据
df = pro.income(ts_code='600000.SH', start_date='20230101', end_date='20231231')

HTTP API

curl -X POST https://api.tushare.pro \
  -H "Content-Type: application/json" \
  -d '{
    "api_name": "daily",
    "token": "your_token",
    "params": {"ts_code": "000001.SZ", "start_date": "20240101"},
    "fields": "ts_code,trade_date,open,high,low,close,vol"
  }'

积分系统

• 注册赠送初始积分
• 通过签到、分享、贡献数据等方式获取积分
• 不同 API 调用消耗不同积分
• 积分与频次对应表: https://tushare.pro/document/1?doc_id=290

详细文档

更多接口详情见 references/api-reference.md

注意事项

1. 需要申请 token 才能使用 API
2. 注意积分消耗，高频接口消耗更多积分
3. 数据有更新延迟，日线数据通常在收盘后 1-2 小时更新
4. 免费用户有调用频次限制