Tushare Skill

The official Tushare Pro skill: quotes, financial statements, indices and macro data of the Chinese market from a natural-language request

  • 460 ★ on the repository
  • Last commit
SkillOfficial

Extended access

Why this level

  • The skill runs Python code and goes online to the Tushare Pro API
  • The Tushare Pro token sits in an environment variable and opens access to your account with the service
All reasons and checks

waditu-tushare/skills

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/tushare-skill

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The skill runs Python code and goes online to the Tushare Pro API
  • The Tushare Pro token sits in an environment variable and opens access to your account with the service

This is third-party code. Review the repository files before installing.

What it does

Tushare Skill is the official kit from the Tushare Pro service for retrieving financial data of the Chinese market. The agent turns a natural-language request into a Tushare interface call: stock quotes, financial statements, funds, indices and macroeconomic indicators. The README claims more than 220 interfaces, and the reference in `references/` documents over 235. Examples from the README include Ping An Bank prices for 30 days, China Merchants Bank financial reports with revenue and profit analysis, finding all bank stocks with an analysis of recent performance, Shanghai Composite index data and a year of GDP and CPI series. The skill runs Python code through the `tushare` package, and the `scripts/` folder holds demo scripts for stocks and funds. Access needs a Tushare Pro token: you get it after registering on tushare.pro and pass it through the `TUSHARE_TOKEN` variable. The skill's permissions are limited to two: running Python (`Bash(python:*)`) and reading the interface reference. It works in Claude Code, OpenClaw, Trae and other agents that support skills.

Who it is for. Analysts and researchers who need Chinese stock-market data, and developers building prototypes on Tushare data.

Good fit when

  • You need prices of a Chinese stock for the last month and phrasing the request in Chinese is easier than hunting for the interface
  • You want to compare a bank's revenue and net profit by year from its financial statements
  • You must pick all banking-sector stocks and see how they behaved recently
  • A study calls for Chinese GDP and CPI series for a year
  • Index or fund data has to be exported to a file for further processing

Not a fit when

  • The data goes into a commercial product: the author permits use only for study and research
  • You need Russian or US exchange data: the skill covers Tushare Pro interfaces
  • The agent should trade or give investment advice: the skill only reads data
  • You have no Tushare Pro token and do not want to register

Example request

Get Ping An Bank stock prices for the last 30 days through Tushare and save them to CSV

Limitations

The README is in Chinese, as are the sample requests. You need Python 3.7 or newer, the `tushare` package and a Tushare Pro token; call limits depend on the account and are described in the official documentation. The author warns that the project is meant for study and research and that commercial use is barred by the Tushare terms. The repository holds two matching skill folders, `tushare` and `tushare-data`, and the install takes the second.

How to disable. Delete the `tushare-data` folder from the agent's skills directory and remove the `TUSHARE_TOKEN` variable from the environment. Reissue the token in your Tushare Pro account if needed.

FAQ

How do I get a token for Tushare Skill?

Register at tushare.pro and copy the token from your account. Then set it with `export TUSHARE_TOKEN="your_token"` before starting the agent. Better not to keep the token in request text.

Can I install the skill from Gitee?

Yes. Besides GitHub the author provides a mirror: `npx skills add https://gitee.com/lwdt/skills.git --skill tushare-data`. You can also just copy the `tushare` directory into the skills folder.

Which language should requests be in?

The README and examples are in Chinese and the skill is built for Chinese requests. Give company names and tickers as they are written on Chinese exchanges.

What is in the scripts folder?

Two Python demo scripts: `stock_data_demo.py` for stocks and `fund_data_demo.py` for funds. They show interface calls and work as a sample.

What permissions does the skill get?

Only running Python through `Bash(python:*)` and reading the interface reference. It touches no other agent tools.

Discussion

No questions or reviews yet.

Skills

A skill with Chinese A-share market data: quotes, research reports, financials, news and 11 more categories from 34 sources, no keys

SkillExtended access11.5KRepository stars

Four skills for China's A-share market: quotes and indicators, trend-pullback signals, a simulated account and backtests

SkillExtended access258Repository stars

A skill and MCP server that give an agent quotes, candles and ticker search for the China, Hong Kong and US markets

SkillExtended access2KRepository stars

A skill that queries Arkvol for China, Hong Kong and US market data and retells it with the date, indicators and limits of use

SkillExtended access200Repository stars

Thirteen skills for quantitative trading on China's A-share market: AKShare and BaoStock data, Backtrader and RQAlpha backtests, QMT and JoinQuant docs

SkillBroad access473Repository stars
Official

A hosted MCP server for financial data: quotes, filings, macro statistics and FTShare's own factors, read-only

MCP serverExtended access257Repository stars

README in short

The Chinese description lists the features: natural-language requests, many data types, readiness out of the box and full interface documentation. Next come dependency installation and ways to attach the skill, token setup, sample requests, the skill's permissions and a link to the documentation with limits.

README badge

Original SKILL.md

---
name: tushare
slug: tushare-data
description: 面向中文自然语言的 Tushare 数据研究技能。用于把“看看这只股票最近怎么样”“帮我查财报趋势”“最近哪个板块最强”“北向资金在买什么”“给我导出一份行情数据”这类请求,转成可执行的数据获取、清洗、对比、筛选、导出与简要分析流程。适用于 A 股、指数、ETF/基金、财务、估值、资金流、公告新闻、板块概念与宏观数据等研究场景。
author: tushare.pro
version: 1.1.16
credentials:
  - name: TUSHARE_TOKEN
    description: Tushare Token,用于认证和授权访问Tushare数据服务。
    how_to_get: "https://tushare.pro/register"
requirements:
  python: 3.7+
  packages:
    - name: tushare
  environment_variables:
    - name: TUSHARE_TOKEN
      required: false
      sensitive: true
  network_access: true
---

# tushare-data

把自然语言财经数据请求,转成可执行的 Tushare 数据工作流。

这是一个面向自然语言的金融数据研究 skill。


## What this skill is for

使用这个 skill 的典型场景:

- 看某只股票、指数、ETF 最近走势
- 查公司基本资料、估值、财务趋势
- 做多标的横向对比
- 看资金流、北向资金、龙虎榜、板块强弱
- 梳理公告、新闻、研报、政策线索
- 查看 CPI / PPI / PMI / 社融 / 利率等宏观数据
- 导出 CSV / parquet 供后续分析或回测使用
- 生成简洁研究摘要,而不是只吐原始字段表

Report a problem

Foxx AITushare Skill
Foxx AI

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.