finmindlisted
Install: claude install-skill chenwei791129/agent-skills
# FinMind Taiwan Financial Report Query
Query Taiwan listed/OTC company financial data via FinMind REST API. Covers income statements, balance sheets, cash flows, monthly revenue, dividends, PER/PBR, and stock prices.
## Prerequisites
**Optional**: Set `FINMIND_TOKEN` for higher rate limits (600 req/hr vs 300 req/hr without token).
Register at https://finmindtrade.com/ to get a free token, then:
```bash
export FINMIND_TOKEN="your-token-here"
```
## Available Commands
All commands are run via:
```bash
uv run ~/.claude/skills/finmind/scripts/finmind_query.py <command> [options]
```
### Financial Data Commands
| Command | Description | Key Fields |
|---------|-------------|------------|
| `income` | Comprehensive Income Statement | EPS, revenue, gross profit, operating income, net income |
| `balance-sheet` | Balance Sheet | total assets, liabilities, equity, cash |
| `cash-flow` | Cash Flow Statement | operating/investing/financing cash flows |
| `revenue` | Monthly Revenue | monthly revenue, YoY growth, MoM growth |
| `dividend` | Dividend Policy | cash dividend, stock dividend |
| `per` | PER / PBR / Dividend Yield | price-to-earnings, price-to-book, yield |
| `price` | Daily Stock Price | open, high, low, close, volume |
### Utility Commands
| Command | Description |
|---------|-------------|
| `datasets` | List all available FinMind datasets |
| `translate --dataset <name>` | Show Chinese-English field name mapping |
## Date Range Guidelines
**IMPORTANT**: Choos