finance-news

What the source does

• FilesystemDeclared2 observations
• NetworkDeclared6 observations
• ShellNone observedNo commands run in the source
• DependenciesNot pinnedSome versions float
• SecretsNone foundNo keys in source

Five audit layers

Gates applied: no behavioural pass.

feedparser, yfinance

Audit 0.4.1 · source sha 3acc7a260379 · 27 Oct 2026Report an issue or request a re-scan

• Publishersundial-org GitHub organizationOwner of the repository this skill is read from
• Source foldersundial-org/awesome-openclaw-skills/skills/finance-newsThe exact folder we audited
• LicenceNot declaredAs the repository states it
• Commit pinned for this verdict3acc7a260379A new audit runs when the source changes
• Repository statusNot archivedLast push 234 days ago
• Sandboxed runNot runSkills are read, not executed; layer L4 is skipped

Its 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,…

---
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
- Gemini-powered analysis
- 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     # Ne

Excerpt, first 6,013 characters of SKILL.md, verbatim from the audited commit. It is text from someone else’s repository, quoted so you can judge it before your agent reads it.

1. 2026-10-27
   ✓SAFE B 89 / 100

   first audit · source 3acc7a260379

Questions about finance-news

• github.com/sundial-org/awesome-openclaw-skills/tree/main/skills/ — the audited source at commit 3acc7a260379 and every finding aboveObserved · 27 Oct 2026

Spotted something wrong? Report a correction · Methodology