back
loading skill details...
Market news briefings with AI summaries. Use when asked about stock news, market updates, portfolio performance, morning/evening briefings, financial headlin...
---
name: finance-news
description: "Market news briefings with AI summaries. Use when asked about stock news, market updates, portfolio performance, morning/evening briefings, financial headlines, or price alerts. Supports US/Europe/Japan markets, WhatsApp delivery, and English/German output."
---
# Finance News Skill
AI-powered market news briefings with configurable language output and automated delivery.
## First-Time Setup
Run the interactive setup wizard to configure your sources, delivery channels, and schedule:
```bash
finance-news setup
```
The wizard will guide you through:
- 📰 **RSS Feeds:** Enable/disable WSJ, Barron's, CNBC, Yahoo, etc.
- 📊 **Markets:** Choose regions (US, Europe, Japan, Asia)
- 📤 **Delivery:** Configure WhatsApp/Telegram group
- 🌐 **Language:** Set default language (English/German)
- ⏰ **Schedule:** Configure morning/evening cron times
You can also configure specific sections:
```bash
finance-news setup --section feeds # Just RSS feeds
finance-news setup --section delivery # Just delivery channels
finance-news setup --section schedule # Just cron schedule
finance-news setup --reset # Reset to defaults
finance-news config # Show current config
```
## Quick Start
```bash
# Generate morning briefing
finance-news briefing --morning
# View market overview
finance-news market
# Get news for your portfolio
finance-news portfolio
# Get news for specific stock
finance-news news AAPL
```
## Features
### 📊 Market Coverage
- **US Markets:** S&P 500, Dow Jones, NASDAQ
- **Europe:** DAX, STOXX 50, FTSE 100
- **Japan:** Nikkei 225
### 📰 News Sources
- **Premium:** WSJ, Barron's (RSS feeds)
- **Free:** CNBC, Yahoo Finance, Finnhub
- **Portfolio:** Ticker-specific news from Yahoo
### 🤖 AI Summaries
- SkillBoss API Hub powered analysis (auto-routes to best available model via /v1/pilot)
- Configurable language (English/German)
- Briefing styles: summary, analysis, headlines
### 📅 Automated Briefings
- **Morning:** 6:30 AM PT (US market open)
- **Evening:** 1:00 PM PT (US market close)
- **Delivery:** WhatsApp (configure group in cron scripts)
## Commands
### Briefing Generation
```bash
# Morning briefing (English is default)
finance-news briefing --morning
# Evening briefing with WhatsApp delivery
finance-news briefing --evening --send --group "Market Briefing"
# German language option
finance-news briefing --morning --lang de
# Analysis style (more detailed)
finance-news briefing --style analysis
```
### Market Data
```bash
# Market overview (indices + top headlines)
finance-news market
# JSON output for processing
finance-news market --json
```
### Portfolio Management
```bash
# List portfolio
finance-news portfolio-list
# Add stock
finance-news portfolio-add NVDA --name "NVIDIA Corporation" --category Tech
# Remove stock
finance-news portfolio-remove TSLA
# Import from CSV
finance-news portfolio-import ~/my_stocks.csv
# Interactive portfolio creation
finance-news portfolio-create
```
### Ticker News
```bash
# News for specific stock
finance-news news AAPL
finance-news news TSLA
```
## Configuration
### Portfolio CSV Format
Location: `~/clawd/skills/finance-news/config/portfolio.csv`
```csv
symbol,name,category,notes
AAPL,Apple Inc.,Tech,Core holding
NVDA,NVIDIA Corporation,Tech,AI play
MSFT,Microsoft Corporation,Tech,
```
### Sources Configuration
Location: `~/clawd/skills/finance-news/config/config.json` (legacy fallback: `config/sources.json`)
- RSS feeds for WSJ, Barron's, CNBC, Yahoo
- Market indices by region
- Language settings
## Cron Jobs
### Setup via OpenClaw
```bash
# Add morning briefing cron job
openclaw cron add --schedule "30 6 * * 1-5" \
--timezone "America/Los_Angeles" \
--command "bash ~/clawd/skills/finance-news/cron/morning.sh"
# Add evening briefing cron job
openclaw cron add --schedule "0 13 * * 1-5" \
--timezone "America/Los_Angeles" \
--command "bash ~/clawd/skills/finance-news/cron/evening.sh"
```
### Manual Cron (crontab)
```cron
# Morning briefing (6:30 AM PT, weekdays)
30 6 * * 1-5 bash ~/clawd/skills/finance-news/cron/morning.sh
# Evening briefing (1:00 PM PT, weekdays)
0 13 * * 1-5 bash ~/clawd/skills/finance-news/cron/evening.sh
```
## Sample Output
```markdown
🌅 **Börsen-Morgen-Briefing**
Dienstag, 21. Januar 2026 | 06:30 Uhr
📊 **Märkte**
• S&P 500: 5.234 (+0,3%)
• DAX: 16.890 (-0,1%)
• Nikkei: 35.678 (+0,5%)
📈 **Dein Portfolio**
• AAPL $256 (+1,2%) — iPhone-Verkäufe übertreffen Erwartungen
• NVDA $512 (+3,4%) — KI-Chip-Nachfrage steigt
🔥 **Top Stories**
• [WSJ] Fed signalisiert mögliche Zinssenkung im März
• [CNBC] Tech-Sektor führt Rally an
🤖 **Analyse**
Der S&P zeigt Stärke. Dein Portfolio profitiert von NVDA's
Momentum. Fed-Kommentare könnten Volatilität auslösen.
```
## Integration
### With OpenBB (existing skill)
```bash
# Get detailed quote, then news
openbb-quote AAPL && finance-news news AAPL
```
### With OpenClaw Agent
The agent will automatically use this skill when asked about:
- "What's the market doing?"
- "News for my portfolio"
- "Generate morning briefing"
- "What's happening with AAPL?"
### With Lobster (Workflow Engine)
Run briefings via [Lobster](https://github.com/openclaw/lobster) for approval gates and resumability:
```bash
# Run with approval before WhatsApp send
lobster "workflows.run --file workflows/briefing.yaml"
# With custom args
lobster "workflows.run --file workflows/briefing.yaml --args-json '{\"time\":\"evening\",\"lang\":\"en\"}'"
```
See `workflows/README.md` for full documentation.
## Files
```
skills/finance-news/
├── SKILL.md # This documentation
├── Dockerfile # NixOS-compatible container
├── config/
│ ├── portfolio.csv # Your watchlist
│ ├── config.json # RSS/API/language configuration
│ ├── alerts.json # Price target alerts
│ └── manual_earnings.json # Earnings calendar overrides
├── scripts/
│ ├── finance-news # Main CLI
│ ├── briefing.py # Briefing generator
│ ├── fetch_news.py # News aggregator
│ ├── portfolio.py # Portfolio CRUD
│ ├── summarize.py # AI summarization
│ ├── alerts.py # Price alert management
│ ├── earnings.py # Earnings calendar
│ ├── ranking.py # Headline ranking
│ └── stocks.py # Stock management
├── workflows/
│ ├── briefing.yaml # Lobster workflow with approval gate
│ └── README.md # Workflow documentation
├── cron/
│ ├── morning.sh # Morning cron (Docker-based)
│ └── evening.sh # Evening cron (Docker-based)
└── cache/ # 15-minute news cache
```
## Environment Variables
- `SKILLBOSS_API_KEY` — SkillBoss API Hub key for all AI inference (LLM summaries, translations, analysis)
## Dependencies
- Python 3.10+
- `feedparser` (`pip install feedparser`)
- `requests` (`pip install requests`)
- OpenBB (existing `openbb-quote` wrapper)
- OpenClaw message tool (for WhatsApp delivery)
## Troubleshooting
### AI summary not working
```bash
# Verify SKILLBOSS_API_KEY is set
echo $SKILLBOSS_API_KEY
```
### RSS feeds timing out
- Check network connectivity
- WSJ/Barron's may require subscription cookies for some content
- Free feeds (CNBC, Yahoo) should always work
### WhatsApp delivery failing
- Verify WhatsApp group exists and bot has access
- Check `openclaw doctor` for WhatsApp status
don't have the plugin yet? install it then click "run inline in claude" again.