Stock Watcher THS

Manage and summarize an A-share watchlist

Stock Watcher

Use this skill to manage a local A-share watchlist and summarize current quotes.

Scope

• Supports common 6-digit A-share stock codes.
• Infers 同花顺 market 17 for 6xxxxx; infers market 33 for 0xxxxx and 3xxxxx.
• Stores watchlist data inside this skill folder at data/watchlist.txt.
• Supports STOCK_WATCHER_DATA_DIR to override the watchlist directory.
• Uses the 同花顺 structured quote API first.
• Falls back to parsing https://stockpage.10jqka.com.cn/{stock_code}/ when the API path fails.

Do not store browser cookies, user login tokens, or other credentials in this skill.

Commands

Run scripts from the skill folder or by passing their full path:

bash

bash scripts/install.sh
python3 scripts/list_stocks.py
python3 scripts/add_stock.py 600188 兖矿能源
python3 scripts/remove_stock.py 600188
python3 scripts/clear_watchlist.py
python3 scripts/summarize_performance.py

If dependencies are missing, install them first:

bash

python3 -m pip install -r requirements.txt

Watchlist Format

data/watchlist.txt uses one stock per line:

text

600188|兖矿能源
002384|东山精密

Set STOCK_WATCHER_DATA_DIR when the watchlist should live outside the skill folder:

bash

STOCK_WATCHER_DATA_DIR="$HOME/.stock-watcher" python3 scripts/list_stocks.py

Output

summarize_performance.py prints concise quote summaries:

text

600188 - 兖矿能源 - 最新价: 20.27 - 涨跌幅: 1.35% - 涨跌额: 0.27 - 成交额: 1229165230.0 - 来源: API

If the API fails but HTML parsing succeeds, output is marked 来源: HTML.

Limitations

• 同花顺 endpoints are not official public APIs and may change or block requests.
• Output may be delayed or unavailable depending on network and market status.
• The data is for analysis and monitoring only, not investment advice.