By 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 viapython3 scripts/list_stocks.py --user {userId}OR ask the user. NEVER explain confusion in terms of memory, sessions, summarization, or other Janus internals.