tushare

**Quick judgment** A solid, task-focused skill for accessing Chinese A-share, futures, and macroeconomic data via the Tushare API. It is best suited for users already comfortable with Python/CLI workflows who need structured access to China-focused financial data. **What it does well** - Wraps common Tushare endpoints (stock, futures, macro) into straightforward CLI commands (`stock_basic`, `daily`, `weekly`, `monthly`, `realtime`, `moneyflow`, `company`, `fut_basic`, `fut_daily`, `fut_holding`, `gdp`, `cpi`, `ppi`). - Provides concrete examples for symbol formats (e.g., `000001.SZ`, `600519.SH`, `CU.SHF`, `IF.CFX`) and typical queries, which reduces setup friction. - Documentation includes quick-start steps and FAQ for common misconfigurations (missing token, incorrect code format, permission issues). **Key risks / limitations** - **External dependency & uptime**: All data depends on the Tushare service and the user’s Tushare account; outages, API changes, or permission tier limitations will directly affect this skill. - **Token management**: Requires `TUSHARE_TOKEN` in the environment. Misconfigured or exposed tokens could lead to account misuse; the integration must avoid logging or sharing tokens. - **Access/quotas**: Some Tushare endpoints require points or paid access; users may see incomplete or empty results if their account lacks sufficient permissions. - **Market scope**: Focused on Chinese markets; not suitable for global coverage. - **Error handling**: While basic FAQ is provided, robustness against network failures, malformed parameters, or partial data is not fully clear from the snippet. **Recommended scenarios** - China-focused quant researchers or data engineers who want a quick, scriptable way to pull A-share and futures data without hand-coding every Tushare call. - Automated jobs (cron/CI) that periodically fetch Chinese stock/futures and macro data into local storage or analytics pipelines. - Prototyping and exploratory analysis where a CLI-based data puller is sufficient and integration with other tools (e.g., pandas, databases) happens downstream. **Less ideal for** - Users needing global or multi-asset coverage beyond Chinese markets. - Non-technical users who are uncomfortable setting environment variables, Python dependencies, or interpreting CLI output. - Highly latency-sensitive trading systems that require direct, optimized API integration rather than a generic CLI wrapper.