---
id: berabuddies/Semia/finance-watcher
version: "ef5d6091"
license: Apache-2.0
install: manual
updated: 2026-07-21
---

# finance-watcher — Finance Watcher tracks stock and cryptocurrency prices from free sources, letting you set alerts when prices hit your targets and generate daily portfolio reports. Build a watchlist of assets, check current prices anytime, and get notified automatically—all without needing API keys or registration.

Publisher: berabuddies · Stars: 587 · Updated: 2026-07-21

Install (manual): `git clone https://github.com/berabuddies/Semia`

## SKILL.md

# Finance Watcher

Monitor stock and cryptocurrency prices with ease. Set alerts, track your portfolio, and generate daily reports.

## Features

- ✅ **Real-time Prices** - Crypto (CoinGecko) & Stocks (Yahoo Finance)
- ✅ **Price Alerts** - Get notified when prices hit your targets
- ✅ **Portfolio Tracking** - Watchlist for all your assets
- ✅ **Daily Reports** - Markdown reports with price changes
- ✅ **No API Key** - Free data sources, no registration needed

## Quick Start

```bash
# Install
npm install

# Add assets to watchlist
finance-watcher add BTC --type crypto
finance-watcher add AAPL --type stock

# Check current prices
finance-watcher prices

# Set an alert
finance-watcher alert BTC --above 50000

# Generate report
finance-watcher report --output daily-report.md
```

## Commands

| Command | Description |
|---------|-------------|
| `add <symbol>` | Add to watchlist (`--type crypto/stock`) |
| `remove <symbol>` | Remove from watchlist |
| `list` | Show watchlist |
| `prices` | Get current prices |
| `alert <symbol>` | Set price alert (`--above`, `--below`, `--percent`) |
| `check` | Check all alerts |
| `report` | Generate portfolio report |

## Data Sources

- **Crypto**: CoinGecko API (free, no key)
- **Stocks**: Yahoo Finance API (unofficial, free)

## Use Cases

1. **Personal Portfolio** - Track your investments daily
2. **Trading Alerts** - Never miss entry/exit points
3. **Market Research** - Compare crypto vs stock performance
4. **Automated Reports** - Schedule daily summaries

## Integration

Works great with:
- Cron jobs for scheduled checks
- Feishu/Slack webhooks for alerts
- Content Watcher for market news + price data combo


[View on SkillFed](https://skillfed.io/berabuddies/Semia/finance-watcher) · [View on GitHub](https://github.com/berabuddies/Semia)