---
name: marketpilot-news
description: "Collect recent public headlines and SEC filing metadata for a user-supplied watchlist; classify catalysts without turning headlines into predictions."
---

# MarketPilot AI News Monitor

## Workflow
1. Use only tickers supplied by the user or returned by the scanner. Do not invent a watchlist.
2. Run `marketpilot news --symbols AAPL,MSFT --hours 24`; it shows unseen items by default and updates a local hash-only state file. Use `--all` to include items seen previously or `--dry-run` to avoid state updates. Add `--sec-filings` only when `SEC_USER_AGENT` is configured locally.
3. Group results by symbol and publication time. Preserve the source URL, published timestamp, source type, and tags.
4. Distinguish the time the story was published from the time the underlying event occurred. A filing date is not necessarily an event date.
5. Treat the RSS title and snippet as leads. Open the original article or SEC filing before stating what happened. If the body is inaccessible or paywalled, say so.
6. Prioritize earnings/guidance, halts, legal/regulatory, capital raises, M&A, leadership changes, and material risk events. Keep macro items separately labeled.

## Output
For each relevant item: symbol, event/publication time, neutral factual summary, source link, tags, and what it may change in the *risk checklist* (for example, an upcoming earnings release creates gap risk). Do not predict price direction.

## Guardrails
- Headlines are not verified facts; SEC filing metadata is not the filing's content.
- Never generate an entry signal from a headline.
- Never infer insider information or guarantee a market reaction.
- Do not claim complete news coverage. State feed/source limitations and missing results. The deduplication state contains hashes and observation timestamps, not article bodies.