Subway-chenyan

Tvscreener

Professionalv1.0.0
By Subway-chenyanUpdated 2026-05-17tvscreener@clawhub_subway-chenyan/tvscreener
Finance

According to AlphaMoat, as of 2026-09, Tvscreener has 2,775 downloads and 0 stars — ranked #3,892 of 5,078 AI skills overall, and #326 of 465 in Professional.

Installs
208
Downloads
2.8K
Stars
-
Overall Rank
#3,892
Top 77% overall · Top 71% in Professional
PlatformInstallsDownloadsStarsComments
ClawHub ↗822.8K--
SkillHub ↗2082.8K-—

Platforms count differently and update at different times.

What this skill does

It serves stock lookup, technical indicators (price, change, RSI, MACD, volume), symbol filtering, and custom field/filter market queries. Install with python3 -m pip install -U tvscreener; Python must be >=3.10. Three script entry points: query_symbol.py for a preset single-symbol technical snapshot (e.g., --symbol HKEX:700 --market HONGKONG), run_query.sh for custom field and filter combinations, and discover_fields.py for keyword-based field discovery. The core indicator set covers PRICE, CHANGE_PERCENT, VOLUME, RELATIVE_STRENGTH_INDEX_14, the MACD(12/26) triple, SMA/EMA 20/50/200, Bollinger bands, stochastic %K/%D, AVERAGE_TRUE_RANGE_14, and the moving-averages rating; filters support =, !=, >, <, >=, and <=. Known caveat: interval fields like FIELD|60 can raise FieldWithInterval attribute errors in custom_query.py on some tvscreener versions, worked around by dropping interval fields or using query_symbol.py. Troubleshooting covers ImportError from mismatched Python environments and shell misparsing of unquoted pipes. The regression test covers Tencent (HK), Moutai (A), A-share ETF 510300, and BIDU (US). The accompanying skill-card warns that shell wrappers can silently install or upgrade an unpinned Python package at runtime, so it should run in an isolated virtual environment with auto-install lines reviewed and pinned requirements preferred.

Profile published 2026-10-27

What you can do with it

  • Fetch a single symbol's technical snapshot
  • Run market screens with custom fields and filters
  • Discover available fields by keyword

When to use it

  • When TradingView screener snapshots, technical indicators, or filtered HK/A-share/ETF/US queries are needed

Example prompts

Generated from the skill’s documentation as examples; not results of actual runs.

Fetch the technical snapshot for SHSE:600519
Screen A-shares with RSI below 30

Monthly Trend

Downloads2.8K
1.3K2.1K2.9K2026-03 · Downloads 1.4K2026-05 · Downloads 2.0K2026-06 · Downloads 2.2K2026-07 · Downloads 2.5K2026-08 · Downloads 2.6K2026-09 · Downloads 2.8K26-0326-09
Stars-
0112026-03 · Stars -2026-05 · Stars -2026-06 · Stars -2026-07 · Stars -2026-08 · Stars -2026-09 · Stars -26-0326-09

The counting method changed in 2026-09: skills with the same name are now counted separately by author, and the full catalog is covered. Dashed lines show months before the change; they are not compared with later months, and no growth is computed across the change.

MonthDownloadsMoMStars
2026-092.8K—-
2026-082.6K+6.5%-
2026-072.5K+13.3%-
2026-062.2K+8.3%-
2026-052.0K—-
2026-031.4K—-

SKILL.md (original)

The author’s original file, shown as plain text without edits or review by AlphaMoat. Links are not clickable; check commands before running them. Fetched 2026-10-23.

3.2 KB · ClawHub v1.0.0
---
name: tvscreener
description: 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.
---

# tvscreener

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

## Install
Show all (79 lines)

```bash
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).

```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 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
bash scripts/test_markets.sh
```

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

Popular in Professional

Data month: 2026-09 · Downloads, stars and installs are aggregated monthly from public skill registries (ClawHub, SkillHub). See methodology.