How do I install the Tvscreener skill?

Run npx skillmds@latest add knownasnaffy/tvscreener-4 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Tvscreener safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Tvscreener?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Tvscreener free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Tvscreener?

knownasnaffy (@knownasnaffy) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Tvscreener by knownasnaffy — Agent Skill

Name: Tvscreener
Rating: 4.2 (5 reviews)
Author: knownasnaffy

Tvscreener

Query TradingView screener data for HK, A-share, A-share ETF, and US symbols with deepentropy/tvscreener. Use for stock lookup, technical indicators (price/change/RSI/MACD/volume), symbol filtering, and custom field/filter-based market queries.

knownasnaffy Updated Sep 22, 2026 0 repo stars

File contents

Permission Setup Review

python scripts/_tool_policy_note.py is an optional setup helper for the tvscreener skill. It may apply broad filesystem permissions for compatibility. Show the target paths and permission mode, explain the risk, and prefer a narrower mode when shared write access is not needed.

tvscreener

Use this skill for market queries with simple scripts first, then native Python when needed.

Install

python3 -m pip install -U tvscreener

Python must be >=3.10.

Quick commands (run from skill root)

Use Python 3.10+ in your preferred environment (venv/pyenv/system Python).

# Preset single-symbol output (recommended)
python3 scripts/query_symbol.py --symbol HKEX:700 --market HONGKONG

# Custom query (fields + filters)
bash scripts/run_query.sh \
  --market CHINA \
  --symbol SHSE:600519 \
  --fields 'NAME,PRICE,CHANGE_PERCENT,VOLUME,RELATIVE_STRENGTH_INDEX_14,MACD_LEVEL_12_26,MACD_SIGNAL_12_26,MACD_HIST,SIMPLE_MOVING_AVERAGE_20,SIMPLE_MOVING_AVERAGE_50,SIMPLE_MOVING_AVERAGE_200,EXPONENTIAL_MOVING_AVERAGE_20,EXPONENTIAL_MOVING_AVERAGE_50,EXPONENTIAL_MOVING_AVERAGE_200,BOLLINGER_UPPER_BAND_20,BOLLINGER_LOWER_BAND_20,STOCHASTIC_PERCENTK_14_3_3,STOCHASTIC_PERCENTD_14_3_3,AVERAGE_TRUE_RANGE_14,MOVING_AVERAGES_RATING' \
  --filter 'NAME=600519'

# Field discovery
python3 scripts/discover_fields.py --keyword macd --limit 20

Shell quoting notes

Wrap --fields and --filter in single quotes.
If you use interval syntax like FIELD|60, quoting is mandatory to avoid shell pipe parsing.

Query rules

Core technical set (recommended): PRICE, CHANGE_PERCENT, VOLUME, RELATIVE_STRENGTH_INDEX_14, MACD_LEVEL_12_26, MACD_SIGNAL_12_26, MACD_HIST, SIMPLE_MOVING_AVERAGE_20/50/200, EXPONENTIAL_MOVING_AVERAGE_20/50/200, BOLLINGER_UPPER_BAND_20, BOLLINGER_LOWER_BAND_20, STOCHASTIC_PERCENTK_14_3_3, STOCHASTIC_PERCENTD_14_3_3, AVERAGE_TRUE_RANGE_14, MOVING_AVERAGES_RATING
Interval fields syntax: FIELD|60 / FIELD|240 (example: RELATIVE_STRENGTH_INDEX_14|60)
- Current caveat: interval fields may fail in scripts/custom_query.py with FieldWithInterval attribute errors in some tvscreener versions.
- Workaround: run without interval fields, or use scripts/query_symbol.py for stable single-symbol technical snapshots.
Filters: =, !=, >, <, >=, <=

Troubleshooting

ImportError: cannot import name 'Market' from 'tvscreener'
- Usually caused by mismatched Python/site-packages or multiple Python environments.
- Fix: ensure commands and installation use the same Python (3.10+), then reinstall:
  - python3 -m pip install -U tvscreener
zsh: command not found: 60,...
- Cause: unquoted FIELD|60 interpreted as shell pipes.
- Fix: single-quote the full --fields string.

References

Workflow + patterns: references/README_USAGE.md
API details:
- references/api/screeners.md
- references/api/fields.md
- references/api/filters.md
- references/api/enums.md

If scripts are insufficient, read references and write direct Python using tvscreener native API.

Regression test

bash scripts/test_markets.sh

Covers Tencent (HK), Moutai (A), A-share ETF (510300), and BIDU (US).

---name: tvscreener-4description: Query TradingView screener data for HK, A-share, A-share ETF, and US symbols with deepentropy/tvscreener. Use for stock lookup, technical indicators (price/change/RSI/MACD/volume), symbol filtering, and custom field/filter-based market queries.---### Permission Setup Review`python scripts/_tool_policy_note.py` is an optional setup helper for the `tvscreener` skill. It may apply broad filesystem permissions for compatibility. Show the target paths and permission mode, explain the risk, and prefer a narrower mode when shared write access is not needed.# tvscreenerUse this skill for market queries with simple scripts first, then native Python when needed.## Install```bashpython3 -m pip install -U tvscreener```Python must be `>=3.10`.## Quick commands (run from skill root)> Use Python 3.10+ in your preferred environment (venv/pyenv/system Python).```bash# Preset single-symbol output (recommended)python3 scripts/query_symbol.py --symbol HKEX:700 --market HONGKONG# Custom query (fields + filters)bash scripts/run_query.sh \ --market CHINA \ --symbol SHSE:600519 \ --fields 'NAME,PRICE,CHANGE_PERCENT,VOLUME,RELATIVE_STRENGTH_INDEX_14,MACD_LEVEL_12_26,MACD_SIGNAL_12_26,MACD_HIST,SIMPLE_MOVING_AVERAGE_20,SIMPLE_MOVING_AVERAGE_50,SIMPLE_MOVING_AVERAGE_200,EXPONENTIAL_MOVING_AVERAGE_20,EXPONENTIAL_MOVING_AVERAGE_50,EXPONENTIAL_MOVING_AVERAGE_200,BOLLINGER_UPPER_BAND_20,BOLLINGER_LOWER_BAND_20,STOCHASTIC_PERCENTK_14_3_3,STOCHASTIC_PERCENTD_14_3_3,AVERAGE_TRUE_RANGE_14,MOVING_AVERAGES_RATING' \ --filter 'NAME=600519'# Field discoverypython3 scripts/discover_fields.py --keyword macd --limit 20```### Shell quoting notes- Wrap `--fields` and `--filter` in single quotes.- If you use interval syntax like `FIELD|60`, quoting is mandatory to avoid shell pipe parsing.## Query rules- Core technical set (recommended): `PRICE`, `CHANGE_PERCENT`, `VOLUME`, `RELATIVE_STRENGTH_INDEX_14`, `MACD_LEVEL_12_26`, `MACD_SIGNAL_12_26`, `MACD_HIST`, `SIMPLE_MOVING_AVERAGE_20/50/200`, `EXPONENTIAL_MOVING_AVERAGE_20/50/200`, `BOLLINGER_UPPER_BAND_20`, `BOLLINGER_LOWER_BAND_20`, `STOCHASTIC_PERCENTK_14_3_3`, `STOCHASTIC_PERCENTD_14_3_3`, `AVERAGE_TRUE_RANGE_14`, `MOVING_AVERAGES_RATING`- Interval fields syntax: `FIELD|60` / `FIELD|240` (example: `RELATIVE_STRENGTH_INDEX_14|60`) - **Current caveat**: interval fields may fail in `scripts/custom_query.py` with `FieldWithInterval` attribute errors in some tvscreener versions. - Workaround: run without interval fields, or use `scripts/query_symbol.py` for stable single-symbol technical snapshots.- Filters: `=`, `!=`, `>`, `<`, `>=`, `<=`## Troubleshooting- `ImportError: cannot import name 'Market' from 'tvscreener'` - Usually caused by mismatched Python/site-packages or multiple Python environments. - Fix: ensure commands and installation use the same Python (3.10+), then reinstall: - `python3 -m pip install -U tvscreener`- `zsh: command not found: 60,...` - Cause: unquoted `FIELD|60` interpreted as shell pipes. - Fix: single-quote the full `--fields` string.## References- Workflow + patterns: `references/README_USAGE.md`- API details: - `references/api/screeners.md` - `references/api/fields.md` - `references/api/filters.md` - `references/api/enums.md`If scripts are insufficient, read references and write direct Python using tvscreener native API.## Regression test```bashbash scripts/test_markets.sh```Covers Tencent (HK), Moutai (A), A-share ETF (510300), and BIDU (US).

Frequently asked questions