ClawWatch — Watchlist Skill

Quick Reference

| User says... | You run... | |---|---| | "Füg Bitcoin zur Watchlist hinzu" | clawwatch add BTC | | "Add NVIDIA and Tesla" | clawwatch add NVDA TSLA --tag portfolio | | "Wie steht meine Watchlist?" | clawwatch check --json → parse & summarize | | "Zeig mir nur die Kryptos" | clawwatch list --type crypto --json | | "Alert wenn BTC über 100k geht" | clawwatch alert add BTC above 100000 | | "Alert if ETH drops 5% in a day" | clawwatch alert add ETH change 5 | | "Wie ist die Marktstimmung?" | clawwatch feargreed | | "Entferne TSLA" | clawwatch remove TSLA | | "Check my alerts" | clawwatch alert check --json | | "Export als CSV" | clawwatch export --format csv |

How to Use

1. Run commands via Bash tool: bash clawwatch <command>
2. Use --json flag to get machine-readable output you can parse
3. Summarize results in natural language for the user
4. For deep analysis, pass the JSON data to market-analyst agent

Important Rules

• Always use --json flag when you need to parse the output programmatically
• Don't run clawwatch check too frequently — respect API rate limits (max every 60 seconds)
• Auto-detection: Just pass symbols like BTC, ETH, NVDA, SAP.DE — the tool auto-detects crypto vs stock
• Alert exit codes: clawwatch alert check returns exit code 0 (no alerts) or 1 (triggered)

Combining with market-analyst

When the user asks for analysis (not just prices), chain:

1. clawwatch check --json → get current prices
2. Pass relevant data to market-analyst for interpretation
3. Deliver combined response

Reading Cached Data

Instead of running CLI commands, you can read cached data directly:

• ~/.clawwatch/latest.json — Last fetched prices
• ~/.clawwatch/watchlist.json — Full watchlist state

Installation

pip install clawwatch
# No API keys needed for crypto! Works out of the box.
# Optional: set CoinCap key for higher rate limits
clawwatch config --coincap-key YOUR_KEY  # optional