docs: improve RSS-BOOK discoverability

Author: Lukas Geiger

CHANGELOG.md

@@ -3,6 +3,9 @@
 ## [Unreleased]
 
 ### Added
+- Added `llms.txt` with canonical links, feature summary, developer commands, and search phrases for crawler/LLM discovery.
+- Added README links to the live Chrome Web Store listing and GitHub Releases page.
+- Added README product screenshot gallery using the existing store screenshots.
 - Added options-page lifecycle diagnostics for service-worker boot, alarm cadence, and recent update-cycle activity.
 - Added automated light/dark theme coverage for popup and options CSS variables.
 - Added a read-only GitHub Actions CI workflow for the Node test suite.
@@ -19,10 +22,11 @@
 - Normalized the German locale file to real UTF-8 Umlaute instead of escaped code points.
 
 ### Changed
+- Clarified README positioning for bookmark-based RSS reader and Chrome Web Store search queries.
 - Added repository line-ending rules, explicitly ignored local pytest caches, and updated the README Edge packaging note.
 
 ### Verified
-- `npm test` now covers 33 dependency-free Node tests, including the 10-feed parser matrix, CDATA cleanup, theme, service-worker scheduling, lifecycle diagnostics, and package-content coverage.
+- `npm test` now covers 34 dependency-free Node tests, including the 10-feed parser matrix, CDATA cleanup, theme, service-worker scheduling, lifecycle diagnostics, and package-content coverage.
 - `npm run package` creates `dist/RSS-BOOK-v1.1.2-edge.zip` with the Manifest V3 runtime files plus license/privacy docs.
 
 ## [1.1.2] — 2026-04-30

README.md

@@ -1,9 +1,13 @@
 # RSS-BOOK
 
+Bookmark-based RSS reader browser extension for Chrome, Edge, Brave and Vivaldi.
+
 RSS-BOOK is a privacy-first RSS and Atom feed reader for Chromium browsers.
 Instead of creating another account or cloud database, it saves feed entries as
 browser bookmarks so Chrome, Edge, Brave and Vivaldi sync can carry them across
-devices.
+devices. It is built for readers who want a lightweight Chrome Web Store RSS
+extension with OPML import/export, feed discovery, notifications, dark mode and
+no tracking.
 
 ![RSS-BOOK](assets/social-preview.png)
 
@@ -18,6 +22,15 @@ devices.
 
 ---
 
+## Get RSS-BOOK
+
+- **Chrome Web Store:** [Install RSS-BOOK](https://chromewebstore.google.com/detail/rss-book/aednfjhookicnhcjhjifbaepglinbdli)
+- **GitHub Releases:** [Download the extension ZIP](https://github.com/file-bricks/RSS-BOOK/releases)
+- **Source code:** [file-bricks/RSS-BOOK](https://github.com/file-bricks/RSS-BOOK)
+
+RSS-BOOK is also usable by sideloading the unpacked repository in Chrome, Edge,
+Brave or Vivaldi.
+
 ## How it works
 
 1. Add RSS or Atom feed URLs in the options page
@@ -41,6 +54,11 @@ Your feeds live in your bookmarks — accessible everywhere your browser syncs,
 
 ## Install
 
+### Chrome Web Store
+
+Install the published extension from the
+[Chrome Web Store](https://chromewebstore.google.com/detail/rss-book/aednfjhookicnhcjhjifbaepglinbdli).
+
 ### From GitHub (Chrome, Edge, Brave, Vivaldi)
 
 1. Download or clone this repository
@@ -52,6 +70,13 @@ Your feeds live in your bookmarks — accessible everywhere your browser syncs,
 
 Create the upload-ready ZIP with `npm run package`. The generated archive stays local under `dist/` and is intentionally ignored by git.
 
+## Product Screenshots
+
+![RSS-BOOK popup with subscribed feeds](assets/screenshot-1-popup.png)
+![RSS-BOOK options page with feed settings](assets/screenshot-2-options.png)
+![RSS-BOOK browser bookmark folders](assets/screenshot-3-folders.png)
+![RSS-BOOK saved feed entries as bookmarks](assets/screenshot-4-entries.png)
+
 ## Usage
 
 **Popup** — click the extension icon to see your feeds and trigger a manual update.
@@ -67,7 +92,7 @@ Create the upload-ready ZIP with `npm run package`. The generated archive stays
 
 ## Development
 
-RSS-BOOK has no bundling step. The repository includes 33 dependency-free Node tests for parser behavior, a 10-fixture RSS/Atom feed matrix, CDATA cleanup, OPML, storage, bookmark cleanup, feed discovery, folder export, store assets, service-worker scheduling, lifecycle diagnostics, light/dark theme CSS coverage, and Edge package contents:
+RSS-BOOK has no bundling step. The repository includes 34 dependency-free Node tests for parser behavior, a 10-fixture RSS/Atom feed matrix, CDATA cleanup, OPML, storage, bookmark cleanup, feed discovery, folder export, store assets, service-worker scheduling, lifecycle diagnostics, light/dark theme CSS coverage, and Edge package contents:
 
 ```bash
 npm test
@@ -132,6 +157,12 @@ RSS-BOOK/
 - [x] Bookmark folder survives rename/move (tracked by ID)
 - [x] Option to delete bookmarks on unsubscribe
 
+## Discovery keywords
+
+`RSS reader`, `Atom feed reader`, `Chrome RSS extension`, `bookmark-based RSS reader`,
+`browser bookmark feed reader`, `Manifest V3 RSS`, `OPML import export`,
+`privacy-first RSS reader`, `no-account feed reader`, `Edge RSS extension`.
+
 ## License
 
 [MIT](LICENSE)

llms.txt

@@ -0,0 +1,42 @@
+# RSS-BOOK
+
+> RSS-BOOK is a privacy-first Manifest V3 browser extension for Chrome, Edge,
+> Brave and Vivaldi. It turns RSS and Atom feed entries into browser bookmarks
+> instead of storing them in a cloud account.
+
+## Canonical links
+
+- GitHub: https://github.com/file-bricks/RSS-BOOK
+- Chrome Web Store: https://chromewebstore.google.com/detail/rss-book/aednfjhookicnhcjhjifbaepglinbdli
+- Releases: https://github.com/file-bricks/RSS-BOOK/releases
+- Privacy policy: https://github.com/file-bricks/RSS-BOOK/blob/main/PRIVACY_POLICY.md
+
+## What it does
+
+- Saves RSS and Atom feed entries as browser bookmarks.
+- Uses local browser storage for configuration and cache metadata.
+- Supports OPML import/export, feed discovery, notifications and dark mode.
+- Avoids accounts, telemetry, analytics and third-party proxy services.
+- Runs as a dependency-free Chromium Manifest V3 extension.
+
+## Developer commands
+
+```bash
+npm test
+npm run package
+```
+
+## Important files
+
+- `manifest.json` - Chromium Manifest V3 extension metadata.
+- `sw.js` - service worker for scheduled feed updates.
+- `lib/rss.js` - RSS/Atom parser.
+- `lib/bookmarks.js` - bookmark folder and item management.
+- `ui/popup.html` / `ui/options.html` - extension interface.
+- `_locales/en/messages.json` and `_locales/de/messages.json` - UI strings.
+
+## Search phrases
+
+RSS reader browser extension, Chrome RSS extension, bookmark-based RSS reader,
+privacy-first RSS reader, Manifest V3 RSS reader, OPML feed reader, Edge RSS
+extension, Atom feed reader for Chromium.

package.json

@@ -3,7 +3,7 @@
   "version": "1.1.2",
   "private": true,
   "type": "module",
-  "description": "Manifest V3 RSS/Atom to bookmarks browser extension.",
+  "description": "Privacy-first Manifest V3 RSS/Atom reader that saves feed entries as browser bookmarks.",
   "scripts": {
     "package": "node scripts/package-extension.mjs",
     "test": "node --test tests/*.test.mjs"