stock-watcher

Stock Watcher Skill

This skill provides comprehensive stock watchlist management capabilities, allowing users to track their favorite stocks and get performance summaries using real-time data from Tonghuashun (10jqka.com.cn).

Watchlist Quote Viewing

When you request to view your watchlist quotes, the system will directly display the following information:

• The code and name of each stock
• Recent performance indicators (key data such as price change)
• Detailed information links (clickable to view)

No additional commands required; a concise and clear quote overview is presented directly to you.

Manage Watchlist

Add Stock

Add to watchlist using a stock code (6-digit number):

• For example: add 600053 九鼎投资

Delete Stock

Delete a watchlist stock by stock code:

• Example: Delete 600053

View Watchlist

Display the complete list of all current watchlist stocks

Clear Watchlist

Completely clear all watchlist stocks

Data Source

Mainly usesTonghuashun (10jqka.com.cn) as the data source:

• Stock pages: https://stockpage.10jqka.com.cn/{stock_code}/
• Supports Shanghai and Shenzhen A-shares and the STAR Market
• Provides real-time quotes, technical analysis, and capital flow data

Watchlist Management

File Format

Watchlist stocks are stored in ~/.clawdbot/stock_watcher/watchlist.txt：

600053|九鼎投资
600018|上港集团
688785|恒运昌

Supported Operations

1. Add stock: Validate the stock code format and add it to the watchlist
2. Delete stock: Delete by exact match on stock code
3. View list: Display current watchlist stocks
4. Clear list: Completely clear the watchlist
5. Quote summary: Retrieve the latest data for all stocks and provide a concise summary

Quote Summary Features

• Directly display key quote indicators with no redundant information
• Provide stock detail links for in-depth viewing
• Automatically handle network errors and data anomalies
• Reasonably control request frequency (1 time per second)

Notes

• Stock code format: Use a 6-digit numeric code (e.g., 600053）
• Data delay: Quotes may have a 1-3 minute delay
• Network dependency: A network connection is required to obtain real-time data
• Market scope: Mainly supports the A-share market (Shanghai/Shenzhen/STAR Market)

Installation and Uninstallation

Installation

Run the scripts/install.sh script to automatically create the necessary directory structure.

Uninstallation

Run the scripts/uninstall.sh script to completely remove all related files.

Script Description

All scripts use a unified configuration file config.py to manage the storage path, ensuring path consistency:

• add_stock.py - Add a stock to the watchlist
• remove_stock.py - Delete a stock from the watchlist
• list_stocks.py - List all watchlist stocks
• clear_watchlist.py - Clear the watchlist
• summarize_performance.py - Get a stock quote summary