feat: initial Reddit adapter for browserkit

4 public tools using Reddit JSON API:
- get_subreddit: posts from any subreddit with sort/time/count
- get_thread: post + top-level comments
- search: site-wide or subreddit-scoped search
- get_user: public profile (overview/submitted/comments)

Uses Reddit JSON API (no bot detection, works in CI without auth).
85 tests: 49 L1 unit, 14 L3 protocol, 7 L4 reliability, 15 L2 live.

Made-with: Cursor

Author: jonzarecki

.github/workflows/ci.yml

@@ -0,0 +1,63 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    name: Build & Test
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          path: adapter-reddit
+
+      - uses: actions/checkout@v4
+        with:
+          repository: browserkit-dev/browserkit
+          path: browserkit
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Install & build @browserkit/core
+        working-directory: browserkit
+        run: |
+          npm install -g pnpm
+          pnpm install --frozen-lockfile
+          pnpm --filter @browserkit/core build
+
+      - name: Patch @browserkit/core dep path
+        working-directory: adapter-reddit
+        run: |
+          npm pkg set 'devDependencies.@browserkit/core'='file:../browserkit/packages/core'
+          npm pkg set 'peerDependencies.@browserkit/core'='>=0.1.0'
+
+      - name: Install adapter dependencies
+        working-directory: adapter-reddit
+        run: npm install
+
+      - name: Install Patchright Chromium
+        working-directory: adapter-reddit
+        run: npx patchright install chromium --with-deps
+
+      - name: Build
+        working-directory: adapter-reddit
+        run: npm run build
+
+      # L1 unit + L3 protocol + L4 reliability (Reddit is public — network OK in CI)
+      # L2 integration tests also run (Reddit is public, no auth needed)
+      - name: Test
+        working-directory: adapter-reddit
+        run: npm test
+        timeout-minutes: 10
+
+      - name: Integration tests
+        working-directory: adapter-reddit
+        run: npm run test:integration
+        timeout-minutes: 15

.gitignore

@@ -0,0 +1,4 @@
+node_modules/
+dist/
+.DS_Store
+*.storage-state.json

README.md

@@ -0,0 +1,74 @@
+# @browserkit/adapter-reddit
+
+[Reddit](https://old.reddit.com) adapter for [browserkit](https://github.com/browserkit-dev/browserkit) — browse subreddits, threads, search, and user profiles via your local browser session.
+
+Targets `old.reddit.com` — Reddit's classic r2 HTML interface with stable class names unchanged since ~2015. No React DOM churn.
+
+## Tools
+
+| Tool | Key inputs | Description |
+|---|---|---|
+| `get_subreddit` | `subreddit`, `sort?` (hot/new/top/rising/controversial), `time?`, `count?` | Posts from a subreddit |
+| `get_thread` | `thread_id` (post ID or URL), `sort?`, `count?` | Post + top-level comments |
+| `search` | `query`, `subreddit?`, `sort?`, `time?`, `count?` | Search Reddit |
+| `get_user` | `username`, `section?` (overview/submitted/comments), `count?` | Public user profile |
+
+Plus auto-registered management tools from the framework: `browser` (health check, screenshot, page state, mode switch, navigate), `close_session`.
+
+## Setup
+
+```bash
+pnpm add @browserkit/adapter-reddit
+```
+
+```js
+// browserkit.config.js
+import { defineConfig } from "@browserkit/core";
+
+export default defineConfig({
+  adapters: {
+    "@browserkit/adapter-reddit": { port: 3849 },
+  },
+});
+```
+
+No login required — all four Phase 1 tools work on public Reddit content without authentication.
+
+```bash
+browserkit start --config browserkit.config.js
+```
+
+Connect your MCP client to `http://127.0.0.1:3849/mcp`.
+
+## Examples
+
+```
+// Hot posts from r/programming
+get_subreddit({ subreddit: "programming", sort: "hot", count: 10 })
+
+// Top posts of the past week
+get_subreddit({ subreddit: "worldnews", sort: "top", time: "week", count: 25 })
+
+// Get a thread and its comments
+get_thread({ thread_id: "abc123", sort: "confidence", count: 20 })
+get_thread({ thread_id: "https://old.reddit.com/r/programming/comments/abc123/", count: 10 })
+
+// Search
+search({ query: "TypeScript performance", subreddit: "programming", sort: "top", time: "month" })
+
+// User profile
+get_user({ username: "GovSchwarzenegger", section: "submitted", count: 10 })
+```
+
+## Tests
+
+```bash
+pnpm test                # L1 unit + L3 MCP protocol + L4 reliability
+pnpm test:integration    # L2 live scraping against real old.reddit.com
+```
+
+Reddit is a public site — both test suites run without authentication and are safe for CI.
+
+## License
+
+MIT