@koda-sl/baker-cli 0.410.0 → 0.411.0

package/README.md

@@ -1873,6 +1873,37 @@ baker research fetch "https://competitor.com" --format html --whole-page
 - Each URL is cached server-side for 24 hours, so a follow-up `--full` call costs no extra credit.
 - Failures carry `error.fix` with `action: "continue_without"` for pages that will not open — finish the rest of the job and report the gap rather than retrying.
 
+
+A Reddit thread link is not sent to Firecrawl (which refuses Reddit): it is read by the Reddit reader below and returned as the thread written out as a page, with `"provider": "reddit"`. Any other Reddit page is refused with a pointer to `baker research reddit`.
+
+---
+
+### `baker research reddit subreddits` / `search` / `thread`
+
+Read Reddit verbatim. Reddit refuses ordinary web reads, Firecrawl, and datacenter addresses, so these commands read it through a ladder of sources — Reddit's own API (when the backend holds `REDDIT_CLIENT_ID` / `REDDIT_CLIENT_SECRET`), the Arctic Shift public archive, then Reddit's public JSON through the proxy tiers — and report which one answered.
+
+```bash
+baker research reddit subreddits "amazon flex uk"
+baker research reddit search "agency never paid" --subreddit couriersofreddit,AmazonFlexUK --kind comments
+baker research reddit search "visa" --subreddit UberEATS --kind comments --since 2025-01-01 --limit 10
+baker research reddit thread "https://www.reddit.com/r/AmazonFlexUK/comments/1abc2de/agency_still_hasnt_paid_me/"
+baker research reddit thread "https://www.reddit.com/r/running/s/3TzXiyxaMD" --comments 100
+```
+
+| Flag | Description |
+|------|-------------|
+| `--subreddit` | Subreddits (up to 10), comma-separated or the flag repeated. Required for `--kind comments`, and for any search when the Reddit API is not configured |
+| `--kind` | `posts` (default) or `comments` |
+| `--since` | Only things written on or after `YYYY-MM-DD`; results then come newest first instead of best match first |
+| `--limit` | Search results, 1-50 (default 25) |
+| `--limit` (subreddits) | Subreddits to return, 1-25 (default 10) |
+| `--comments` | Thread comments, 0-200 (default 40), best conversations first |
+| `--full` | Whole texts instead of 1,500-character previews |
+
+`subreddits` returns `name`, `subscribers` (size, not activity), `access` (`public` / `restricted` / `private`) and `description` — use it instead of guessing subreddit names. Cached 24h.
+
+Every search or thread item carries verbatim `text`, `author`, `score`, `created` and a `permalink` built from the ids the source returned. `thread` refuses a link whose post lives in a different subreddit than the link names (`NOT_FOUND`, `fix.action: "reject"`) — the shape of a link invented by a summary. `source` is `reddit_api`, `reddit_web` or `archive`; archive points on posts under ~36h old are as first captured. A link to one comment opens the thread at that comment; a post on a user's profile (`/user/<name>/comments/<id>`) reads like any other thread. Cached 6h; an empty search is not cached.
+
 ---
 
 ### `baker research advertisers "keyword"`