trading-skills
Comprehensive financial data CLI for Tushare Pro | 7+ trading skill modules | 52+ data tools | Production-ready
A professional-grade skill development and training project featuring comprehensive tools for financial data querying, analysis, and trading strategy development. Built with a modular skill architecture, complete CLI implementation, and extensive test coverage.
📋 Features
- 7 Specialized Skill Modules: Stock, Futures, Index, Forex, Alpha, Concepts, Financial
- 52+ Data Query Tools: Full parity with Tushare Pro API coverage
- Production CLI: Type-safe command-line client with caching and multiple output formats
- Comprehensive Testing: 992+ tests covering CLI, cache, config, and data output
- Skill-Based Learning: Modular knowledge base for understanding trading concepts and data
- Git-Based Configuration: Configuration management via version control
📁 Project Structure
trading-skills/
├── skills/ # Trading skill modules (7 categories)
│ ├── tushare-stock/ # Stock trading fundamentals and techniques
│ ├── tushare-futures/ # Futures contracts and strategies
│ ├── tushare-index/ # Index data and analysis
│ ├── tushare-forex/ # Foreign exchange trading
│ ├── tushare-alpha/ # Alpha factor generation
│ ├── tushare-concepts/ # Key trading and financial concepts
│ └── tushare-financial/ # Financial statement analysis
├── tools/tushare_cli/ # CLI implementation
│ ├── src/ # Python package
│ │ └── tushare_cli/ # Main CLI code
│ │ ├── commands/ # Command modules by category
│ │ ├── api.py # Tushare API wrapper
│ │ ├── cache.py # Response caching layer
│ │ ├── config.py # Configuration management
│ │ ├── output.py # Output formatting (JSON, CSV, Table)
│ │ └── main.py # CLI entry point
│ └── pyproject.toml # Package configuration
├── tests/ # Test suite (992+ tests)
│ └── tushare_cli/ # CLI tests
│ ├── test_cache.py # Cache functionality tests
│ ├── test_commands_*.py # Command tests by category
│ ├── test_config.py # Configuration tests
│ ├── test_main.py # CLI entry point tests
│ └── test_output.py # Output format tests
└── docs/plans/ # Design and implementation plans
🚀 Quick Start
1. Install the CLI
# Clone the repository
git clone git@github.com:oopslink/trading-skills.git
cd trading-skills
# Install the CLI in development mode
pip install -e tools/tushare_cli/
2. Set Up Your Tushare Token
Get your token at Tushare Pro
# Option 1: Config file (recommended, persists across sessions)
tushare-cli config set-token YOUR_TOKEN
# Option 2: Environment variable
export TUSHARE_TOKEN=YOUR_TOKEN
# Option 3: Command-line flag
tushare-cli --token YOUR_TOKEN stock daily --ts-code 000001.SZ
3. Set Up Skills in Claude Code (Optional)
If you want to use the trading skills in Claude Code:
/plugin marketplace add oopslink/trading-skills
/plugin install trading-skills@trading-skills
This will install all 7 trading skill modules, making them available as reference knowledge in Claude Code conversations.
4. Try Your First Query
# Get stock daily data
tushare-cli stock daily --ts-code 000001.SZ
# Get in JSON format
tushare-cli stock daily --ts-code 000001.SZ --format json
# Get with caching enabled
tushare-cli --cache stock daily --ts-code 000001.SZ
📚 API Categories
| Category | Skills | Commands | Data Tools |
|---|---|---|---|
| Stock | tushare-stock | 8+ commands | Daily, Adj, Weekly, Monthly, Quotes |
| Futures | tushare-futures | 7+ commands | Daily, Continuous, Margin |
| Index | tushare-index | 6+ commands | Daily, Weekly, Constituents |
| Forex | tushare-forex | 4+ commands | Daily, OHLC |
| Alpha | tushare-alpha | 5+ commands | Factors, Scoring, Backtesting |
| Concepts | tushare-concepts | 3+ commands | Concept Stocks, Updates |
| Financial | tushare-financial | 6+ commands | Income, Balance, Cashflow, Indicators |
🛠️ Usage Examples
Query Stock Data
# Daily prices for a stock
tushare-cli stock daily --ts-code 000001.SZ --start-date 20240101
# Weekly prices
tushare-cli stock weekly --ts-code 000001.SZ