Markcat Web App Guide

Overview

The Markcat web app is a Progressive Web App (PWA) at markcat.app. It provides the full bookmark management experience in your browser — no extension or local service needed.

Features

• Real-time feed — bookmarks appear and update via Server-Sent Events (SSE) as they’re fetched and classified.
• Category tree — hierarchical browsing, same as the extension.
• Search — find bookmarks by title, URL, or content.
• Responsive — works on desktop and mobile. Installable as a PWA.
• Themes — System, Daylight, Dusk, Midnight.

Saving Bookmarks

From the web app:

• Add URL — paste a URL into the add bookmark form.
• Android share sheet — once the PWA is installed, Markcat appears in Android’s Share menu. Share a link from Chrome (or any app) → pick Markcat → the bookmark is added and you land back in the list. No extension needed. Requires being signed in; if you aren’t, you’re sent to login and returned to the share once authenticated.
• Apple Shortcut — on iOS, use the Markcat shortcut to share a URL directly from Safari (requires a Personal Access Token).

Import / Export

Open the Import / Export dialog from the toolbar:

• Import — drop a Netscape .html bookmark file (Chrome/Firefox/Safari export format).
• Export HTML — choose the folder structure:
  • By category (classified) — folders mirror Markcat’s classified category_path (default).
  • By import folder (original browser hierarchy) — folders mirror the import_tag captured at import time, preserving the original browser layout. Bookmarks added directly (extension, manual add) land at the root.
• Export JSON — full bookmark records. The Include extracted page content checkbox controls whether content_raw (the full extracted page text) is included. It is off by default for privacy and smaller payloads.

Reviewing and Fixing Classifications

Not every page classifies cleanly. When bookmarks fail classification or come back with low confidence, an Open Review Queue button appears in the sidebar with a count. For each bookmark in the queue you can:

• Re-classify — run classification again on the already-extracted content.
• Re-extract — re-fetch the page, then classify again.
• Dismiss — keep the current category and clear the bookmark from review.

The category tree also collects problem bookmarks into automatic system groups: Dead links, Broken links, Bot protected (classified from title only), plus awaiting/failed, low-confidence, and fetch-failed filters.

Credits and Processing

Every automatic classification (fetch → summarize → categorize) consumes one classification credit. Storing, browsing, searching, and manually editing bookmarks never cost credits. Free-plan credits reset each calendar month; paid allowances refresh with your billing cycle; top-up credits never expire.

When you run out of credits, new bookmarks are still saved — they wait in the queue and classify automatically once your credits refresh, or immediately after a top-up.

The Processing page (/app/processing, opened from the status indicator in the sidebar) shows the pipeline at work: per-loop queue counts (Prefetch, Classify, Favicon, OG image, Control), loop states with average processing times, and the worker log. LLM response detail appears on failed classifications, and on every call when the operator has explicitly enabled bounded diagnostic payloads; prompts are never exposed through the API.

Account & Billing

• Top-up packs (paid plans): 500 / €2.99 · 2,000 / €8.99 · 10,000 / €44.99 — one-time credit purchases that never expire.
• Annual bonus: annual plans grant bonus classification credits each billing year — 2,000 on Basic Annual, 10,000 on Pro Annual.
• Summary languages: Free and Basic generate 1, Pro up to 3.
• Manage your plan, top-ups, and invoices from Settings → Subscription & Billing (powered by Stripe).

PWA Installation

1. Open markcat.app in Chrome, Edge, or Safari.
2. Click “Install” in the address bar (or “Add to Home Screen” on mobile).
3. The app installs as a PWA. Private API data is never stored in the service-worker cache, so bookmark data is unavailable offline.
4. On Android, installing also registers Markcat as a share target — it then shows up in the system Share sheet for adding links (see Saving Bookmarks above). Self-hosters get this too, provided the instance is served over HTTPS (a plain-HTTP LAN address is not a secure context, so neither install nor share target work).