trader-news

1# trader-news
2 
3A position you hold can change in a minute: an earnings miss, a CEO leaving,
4a lawsuit, a restatement. This skill reads the two feeds that carry those
5first for each of your stocks and tells you only what is new.
6 
7Tool in this folder (standard library Python, no keys):
8 
9```bash
10python3 "${CLAUDE_SKILL_DIR}/news.py" --help
11```
12 
13## What it reads and writes
14 
15- Your tickers: `--tickers`, else `trader/portfolio.json` positions, else
16  `trader/targets.json` weights (so it works right after `/trader-copycat`).
17- Headlines: Yahoo Finance's public headline RSS, one feed per ticker
18  (`https://feeds.finance.yahoo.com/rss/2.0/headline?s=AAPL&region=US&lang=en-US`).
19- Filings: SEC EDGAR's company Atom feed, 8-K by default (`--forms 8-K,10-Q`
20  for more). Needs the SEC User-Agent from `trader/config.json`
21  (`sec_user_agent`) or `SEC_USER_AGENT`. Without it, filings are skipped with
22  a note and headlines still run.
23- Writes `trader/state/news.json`: what has been shown (kept 30 days) and the
24  CIK for each ticker, so every item appears once.
25 
26## The rules
27 
28- **Headlines are leads, not facts.** Before telling the user something
29  happened, open the story or the filing and read it. Quote the source and
30  link it. Never summarise a paywalled story you could not read: say it is
31  paywalled.
32- **Filings beat headlines.** If an 8-K and a headline disagree, the 8-K is
33  what the company told the SEC.
34- **Say what it touches.** Every item lists the tickers it touches (the feed
35…