stock-watcher

name	stock-watcher
description	Stock watchlist management — add, remove, list stocks and get performance summaries. Use when user wants to track stocks, check prices, or manage their watchlist.
version	2.0.0
requires	{"bins":["python3"]}
always	false
pinned	["stocks/watchlist.txt"]

Stock Watcher

Manage a personal stock watchlist with performance tracking via Google Finance.

Setup

Install Python dependencies (one-time):

pip3 install requests beautifulsoup4

Storage

Watchlist stored per-user at .janus/users/{userId}/files/stocks/watchlist.txt. Format: ticker|stock_name (one per line).

The watchlist is automatically loaded into your context as <pinned_skill_state> — you do NOT need to call list_stocks.py to see what's tracked. Read from <pinned_skill_state> instead.

Scripts

All scripts are in the scripts/ subdirectory of this skill. Run via exec. Every script requires --user {userId} — substitute the actual user ID when calling.

Add stock

python3 scripts/add_stock.py --user {userId} <ticker> [stock_name]
# Example: python3 scripts/add_stock.py --user {userId} AAPL "Apple Inc"
# Example: python3 scripts/add_stock.py --user {userId} CDR:WSE

List watchlist

python3 scripts/list_stocks.py --user {userId}

Remove stock

python3 scripts/remove_stock.py --user {userId} <ticker>

Clear watchlist

python3 scripts/clear_watchlist.py --user {userId}

Performance summary

python3 scripts/summarize_performance.py --user {userId}

Data Source

• Google Finance: https://www.google.com/finance/quote/{TICKER}:{EXCHANGE}
• Supported exchanges: NASDAQ, NYSE, WSE (Warsaw), and others supported by Google Finance
• Ticker format: standard symbol (e.g., AAPL, MSFT, CDR:WSE)

Rules

• Ticker symbols are validated (1-10 alphanumeric chars, optional :EXCHANGE suffix)
• Rate limiting: 1 request per second to external APIs
• Network errors are handled gracefully with clear messages
• Always show ticker + name in output
• State uncertainty. If the watchlist content is unclear, missing from <pinned_skill_state>, or contradicts what you remember: re-read it via python3 scripts/list_stocks.py --user {userId} OR ask the user. NEVER explain confusion in terms of memory, sessions, summarization, or other Janus internals.