FTShare Skill
A skill connects an agent to the FTShare API: market data and factors for A-shares are chosen from a plain-language question.
- 64 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Every call reaches an external service with your API key.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/ftshare-skillDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Every call reaches an external service with your API key.
This is third-party code. Review the repository files before installing.
What it does
The repository installs the parent skill `ftshare-market-data`. The agent reads it, picks a matching internal sub-skill from the `sub-skills/` directory, runs `run.py` with the needed parameters and reads the JSON reply. This turns a plain-language question into a call to a specific FTShare basic financial data or special factor interface. The scripts run on the Python standard library, version 3.9 or newer, with no external dependencies. Every request needs the `FTSHARE_API_KEY` environment variable, and the key is issued by the FTShare service. Tickers must carry the exchange suffix, for example `600519.SH`. The data is for research and is not a stock recommendation.
Who it is for. Researchers and analysts of the Chinese market who need financial data and factors directly in an agent workflow.
Good fit when
- The agent fetches data for a security by a suffixed code such as `600519.SH`.
- The right factor interface is chosen for a question about news sentiment on securities.
- Board lists and market indicators are pulled for a daily overview.
- The result is read as JSON and merged into a research table.
Not a fit when
- You need a non-Chinese market that the README does not claim to support.
- You have no `FTSHARE_API_KEY` or paid plan for the needed factors.
- You need trading or advice on buying securities.
Example request
Using FTShare, get the indicators for 600519.SH over the last month and show the result as a table.Limitations
Every request calls the FTShare service and needs `FTSHARE_API_KEY`, and the available factors depend on the account plan. Installing needs Node.js (for `npx`) and running needs Python 3.9 or newer. The skill only reads data and has no orders or trading operations. The repository texts are in Chinese and an English README is available. Factors count as research data, not a return forecast or purchase advice.
How to disable. Run `npx skills remove ftshare-market-data` and remove the `FTSHARE_API_KEY` variable from the environment.
FAQ
How do I install the skill?
Run `npx skills add FTShare-Lab/FTShare-skill`. The `skills` CLI detects agents on the machine and asks whether to install per project or per user.
Where do I get the API key?
On the FTShare website, in the profile. It is passed through the `FTSHARE_API_KEY` environment variable.
How do I update or remove the skill?
With `npx skills update ftshare-market-data` and `npx skills remove ftshare-market-data`.
What is the ticker format?
With an exchange suffix, for example `600519.SH`.
What dependencies do the scripts have?
Only the Python standard library, version 3.9 or newer.
Discussion
No questions or reviews yet.
Related
SkillsThe official Tushare Pro skill: quotes, financial statements, indices and macro data of the Chinese market from a natural-language request
A hosted MCP server for financial data: quotes, filings, macro statistics and FTShare's own factors, read-only
A skill that queries Arkvol for China, Hong Kong and US market data and retells it with the date, indicators and limits of use
Four skills for China's A-share market: quotes and indicators, trend-pullback signals, a simulated account and backtests
A skill connects agents to FinLab data and its Python engine for stock research and local historical strategy backtesting.
A set of installable finance skills for the agent: news, stock data, sentiment, forecasting, signals, reports and search
README in short
The skill routes a natural-language question to FTShare data interfaces. Detailed sub-skills live inside `ftshare-market-data/sub-skills/`.