@kuandotdev/indicator 0.1.2 → 0.1.3

package/project/skills/tradingview-stock-data/SKILL.md

@@ -0,0 +1,272 @@
+---
+name: tradingview-stock-data
+description: Fetch current market state, prices, OHLCV candles, and price history through the Indicator CLI, Makefile, or MCP data tool. Use when users ask for stock/ETF/crypto/forex/futures/index analysis, current price/latest close, daily or weekly trend, historical prices, OHLCV, CSV export, TradingView symbols, exchange:ticker mapping, or Taiwan tickers such as 2330.tw, 6584.tw, TWSE, or TPEX.
+compatibility: Generic Agent Skill. Works with Claude Code, Pi, Codex-style agents, Gemini CLI, Cursor, and other agents that can read SKILL.md instructions and run shell commands or MCP tools.
+---
+
+# TradingView Market Data Skill
+
+This is a generic, agent-agnostic workflow for getting market prices and price history from TradingView-compatible tooling. It works for stocks, ETFs, crypto, forex, futures, indexes, and other instruments when the TradingView symbol is valid and available to the data backend.
+
+Use it with any agent that can read this `SKILL.md`. It is not Pi-specific.
+
+## Supported agent patterns
+
+| Agent / harness | How this skill is discovered |
+|---|---|
+| Claude Code | `.claude/skills/tradingview-stock-data/SKILL.md` or `~/.claude/skills/...` |
+| Pi | `.pi/agent/skills/tradingview-stock-data/SKILL.md`, `.pi/skills/...`, or Pi package `pi.skills` |
+| Codex / Aider / OpenCode-style agents | `AGENTS.md` points to this skill |
+| Gemini CLI | `GEMINI.md` points to this skill |
+| Cursor | `.cursor/rules/tradingview-stock-data.mdc` points to this skill |
+
+## What the agent should do
+
+When the user asks for a market price, latest close, analysis, or price history:
+
+1. Resolve the user's ticker into TradingView symbol format: `EXCHANGE:TICKER`.
+2. Choose the most direct available tool:
+   - If a TradingView MCP data server is available, use its OHLCV tool.
+   - Else, if a project Makefile has `ohlcv`, use `make ohlcv`.
+   - Else, if the `training-view` CLI is installed, use `training-view data ohlcv`.
+3. Fetch one bar for current/latest price or many bars for history/current-state analysis.
+4. Report the exact command/tool used, resolved symbol, interval, bar count, and latest close.
+5. Mention any data limitation warnings, such as no-login TradingView access.
+
+## Current market state for analysis
+
+For analyze-style requests, this skill is the first data step before checking cached artifacts or model output.
+
+Fetch enough OHLCV to summarize:
+
+- latest close and candle timestamp
+- daily trend and weekly trend
+- day range / recent swing range
+- volume versus recent average when available
+- nearby support/resistance from recent highs/lows and moving averages
+- whether the latest candle may still be in progress
+
+Suggested commands:
+
+```bash
+make ohlcv SYMBOL=NASDAQ:TSLA INTERVAL=1D BARS=120
+make ohlcv SYMBOL=NASDAQ:TSLA INTERVAL=1W BARS=80
+```
+
+Use this current-state snapshot to decide whether a same-day `temp/{YYYYMMDD}_*/{TARGET_ID}/analyzed_result.md` artifact is still usable. If price/news/technicals materially changed, update the final report and artifact instead of returning stale levels.
+
+Do not use `technical_rating` / `make rating` as the final report rating. Reports use the agent-evaluated `Rating: {Buy | Sell | hold}` plus Buy score and Sell score from the active market-analysis prompt. TradingView technical data may be used only as raw context when explicitly requested.
+
+## Tool preference order
+
+### 1. MCP, if available
+
+If the environment exposes a TradingView data MCP server, prefer it for structured calls.
+Typical tool names may include:
+
+- `get_ohlcv`
+- `search_symbol`
+- `technical_rating`
+- `screener`
+
+Use `get_ohlcv(symbol, interval, bars)` for prices and history.
+
+### 2. Makefile, if available
+
+From an Indicator project root:
+
+```bash
+make ohlcv SYMBOL=<TRADINGVIEW_SYMBOL> INTERVAL=<INTERVAL> BARS=<N>
+```
+
+Example:
+
+```bash
+make ohlcv SYMBOL=TPEX:6584 INTERVAL=1D BARS=1
+```
+
+### 3. CLI, if available
+
+If `training-view` is available directly:
+
+```bash
+training-view data ohlcv "<TRADINGVIEW_SYMBOL>" --interval <INTERVAL> --bars <N>
+```
+
+If Indicator uses a conda env:
+
+```bash
+conda run -n tv-indicator --live-stream --no-capture-output \
+  training-view data ohlcv "<TRADINGVIEW_SYMBOL>" --interval <INTERVAL> --bars <N>
+```
+
+CSV export:
+
+```bash
+conda run -n tv-indicator --live-stream --no-capture-output \
+  training-view data ohlcv "<TRADINGVIEW_SYMBOL>" --interval <INTERVAL> --bars <N> --csv <file.csv>
+```
+
+## Symbol resolution
+
+Always prefer TradingView symbol format:
+
+```text
+EXCHANGE:TICKER
+```
+
+Examples:
+
+| User input | TradingView symbol | Notes |
+|---|---|---|
+| `AAPL` | `NASDAQ:AAPL` | Verify if ambiguous |
+| `MSFT` | `NASDAQ:MSFT` | Verify if ambiguous |
+| `TSLA` | `NASDAQ:TSLA` | Verify if ambiguous |
+| `SPY` | `AMEX:SPY` | ETF, verify exchange |
+| `2330.tw` | `TWSE:2330` | Taiwan listed stock |
+| `2317.tw` | `TWSE:2317` | Taiwan listed stock |
+| `6584.tw` / `6584.two` | `TPEX:6584` | Taiwan OTC/TPEX stock |
+| Yahoo `.TW` | usually `TWSE:<ticker>` | Taiwan listed stocks |
+| Yahoo `.TWO` | usually `TPEX:<ticker>` | Taiwan OTC/TPEX stocks |
+| `BTCUSDT` | `BINANCE:BTCUSDT` or another requested exchange | Crypto spot pair; verify exchange if ambiguous |
+| `BTCUSD` | `COINBASE:BTCUSD` / `BITSTAMP:BTCUSD` / requested exchange | Crypto spot pair; verify exchange if ambiguous |
+| `EURUSD` | `FX:EURUSD` / broker-specific exchange | Forex pair; verify venue/source |
+| `ES1!` | `CME_MINI:ES1!` | Futures continuous contract; verify contract source |
+
+If symbol search returns no matches, do **not** immediately conclude the ticker is invalid. Some TradingView search/data endpoints are limited without login. Try known exchange prefixes directly.
+
+Taiwan fallback order:
+
+```bash
+make ohlcv SYMBOL=TWSE:<ticker> INTERVAL=1D BARS=1
+make ohlcv SYMBOL=TPEX:<ticker> INTERVAL=1D BARS=1
+make ohlcv SYMBOL=BINANCE:BTCUSDT INTERVAL=1D BARS=1
+```
+
+## Current/latest price
+
+Fetch one daily bar and report the `close` field:
+
+```bash
+make ohlcv SYMBOL=TPEX:6584 INTERVAL=1D BARS=1
+```
+
+Interpretation:
+
+- `close` is the latest available candle close.
+- During market hours, TradingView may return the latest in-progress candle depending on data access.
+- For intraday checks, use `1`, `5`, `15`, or `60` minute intervals.
+
+Examples:
+
+```bash
+make ohlcv SYMBOL=TPEX:6584 INTERVAL=1D BARS=1
+make ohlcv SYMBOL=TWSE:2330 INTERVAL=1D BARS=1
+make ohlcv SYMBOL=NASDAQ:AAPL INTERVAL=1D BARS=1
+make ohlcv SYMBOL=BINANCE:BTCUSDT INTERVAL=1D BARS=1
+```
+
+## Price history
+
+Increase `BARS` to retrieve historical OHLCV candles:
+
+```bash
+make ohlcv SYMBOL=TPEX:6584 INTERVAL=1D BARS=20
+make ohlcv SYMBOL=TPEX:6584 INTERVAL=1D BARS=500
+```
+
+Common intervals:
+
+| Interval | Meaning |
+|---|---|
+| `1` | 1-minute candles |
+| `5` | 5-minute candles |
+| `15` | 15-minute candles |
+| `60` | 1-hour candles |
+| `240` | 4-hour candles |
+| `1D` | daily candles |
+| `1W` | weekly candles |
+| `1M` | monthly candles |
+
+Examples:
+
+```bash
+# Daily history
+make ohlcv SYMBOL=TPEX:6584 INTERVAL=1D BARS=100
+
+# Weekly history
+make ohlcv SYMBOL=TPEX:6584 INTERVAL=1W BARS=100
+
+# 1-hour history
+make ohlcv SYMBOL=TPEX:6584 INTERVAL=60 BARS=200
+make ohlcv SYMBOL=BINANCE:BTCUSDT INTERVAL=60 BARS=200
+```
+
+## CSV export
+
+Prefer CSV when the user asks for all rows, downstream analysis, spreadsheet use, or a saved file.
+
+```bash
+mkdir -p data
+conda run -n tv-indicator --live-stream --no-capture-output \
+  training-view data ohlcv "TPEX:6584" --interval 1D --bars 500 --csv data/TPEX_6584_1D_500.csv
+```
+
+Suggested filename format:
+
+```text
+<EXCHANGE>_<TICKER>_<INTERVAL>_<BARS>.csv
+```
+
+## Response format
+
+When reporting results, include:
+
+```text
+Resolved symbol: <EXCHANGE:TICKER>
+Command/tool used: <exact command or MCP tool>
+Interval: <interval>
+Bars: <N>
+Latest close: <value> <currency if known>
+Warnings: <nologin/limited data warnings, if any>
+```
+
+For history, summarize the range if visible and the row count returned.
+
+## Troubleshooting
+
+### `No matches for '<ticker>'`
+
+Try explicit exchange prefixes:
+
+```bash
+make ohlcv SYMBOL=TWSE:<ticker> INTERVAL=1D BARS=1
+make ohlcv SYMBOL=TPEX:<ticker> INTERVAL=1D BARS=1
+```
+
+### `you are using nologin method, data you access may be limited`
+
+The command may still work, but data may be limited. If Indicator supports browser login:
+
+```bash
+make login
+make session-check
+```
+
+### Conda environment missing
+
+If this is Indicator, repair the environment:
+
+```bash
+make install
+make doctor
+```
+
+### Need all rows printed
+
+Some CLIs print only the tail by default. Use CSV export or pass a larger tail:
+
+```bash
+conda run -n tv-indicator --live-stream --no-capture-output \
+  training-view data ohlcv "TPEX:6584" --interval 1D --bars 100 --tail 100
+```