stock-watcher

Original：🇨🇳 Chinese
Translated
8 scripts

Manage and monitor a personal stock watchlist with support for adding, removing, listing stocks, and summarizing their recent performance using data from 10jqka.com.cn. Use when the user wants to track specific stocks, get performance summaries, or manage their watchlist.

10installs
Sourceagentbay-ai/agentbay-skills
Added on

NPX Install

npx skill4agent add agentbay-ai/agentbay-skills stock-watcher

Tags

Translated version includes tags in frontmatter
stock-watcherwatchlist-managementstock-data-summarypython-scriptstonghuashun-integration

SKILL.md Content (Chinese)

View Translation Comparison →

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 Market Quote Inquiry

When you request to check watchlist market quotes, the system will directly display the following information:
  • Stock code and name for each stock
  • Recent performance indicators (key data such as price change percentage)
  • Detailed information link (clickable for more details)
No additional commands are required; a concise and clear market overview will be presented directly to you.

Watchlist Management

Add Stocks

Add stocks to the watchlist using 6-digit stock codes:
  • Example: Add 600053 Jiuding Investment

Remove Stocks

Remove stocks from the watchlist via stock code:
  • Example: Remove 600053

View Watchlist

Display the complete list of all current stocks in the watchlist

Clear Watchlist

Completely clear all stocks from the watchlist

Data Source

Primarily uses Tonghuashun (10jqka.com.cn) as the data source:
  • Stock Page: 
    https://stockpage.10jqka.com.cn/{stock_code}/
  • Supports Shanghai, Shenzhen A-shares and STAR Market
  • Provides real-time quotes, technical analysis and capital flow data

Watchlist Administration

File Format

Watchlist stocks are stored in 
~/.clawdbot/stock_watcher/watchlist.txt
:
600053|Jiuding Investment
600018|Shanghai Port Group
688785|Hengyunchang

Supported Operations

  1. Add Stock: Verify stock code format and add to the watchlist
  2. Remove Stock: Precisely match and remove by stock code
  3. View List: Display current watchlist stocks
  4. Clear List: Completely clear the watchlist
  5. Market Summary: Obtain the latest data for all stocks and provide a concise summary

Market Summary Features

  • Directly displays key market indicators with no redundant information
  • Provides stock detail links for in-depth viewing
  • Automatically handles network errors and data anomalies
  • Reasonably controls request frequency (1 request per second)

Notes

  • Stock Code Format: Use 6-digit numeric codes (e.g., 
    600053
    )
  • Data Delay: Market quotes may have a 1-3 minute delay
  • Network Dependency: Requires an internet connection to obtain real-time data
  • Market Scope: Mainly supports 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 storage paths, ensuring path consistency:
  • add_stock.py
    - Add stocks to the watchlist
  • remove_stock.py
    - Remove stocks from the watchlist
  • list_stocks.py
    - List all watchlist stocks
  • clear_watchlist.py
    - Clear the watchlist
  • summarize_performance.py
    - Obtain stock market summary