Safari-Lesezeichen-Sortierer

Python-Skript, das Safari-Lesezeichen mit Claude Haiku in Ordner sortiert und das Ergebnis als Importdatei an Safari gibt, damit iCloud es überträgt.

Ein Python-Skript, das die Safari-Lesezeichen liest, Claude Haiku für jedes einen Ordner wählen lässt und das Ergebnis als Lesezeichen-HTML-Datei schreibt, die ich in Safari importiere.

Stand

Funktioniert. Die ganze Sammlung (296 verschiedene Lesezeichen) wurde mit --all neu geordnet und importiert. Ein erster Inbox-Lauf hat 50 von 76 Lesezeichen einsortiert, der Rest bleibt zum Sortieren von Hand in der Inbox.

So funktioniert es

  1. ~/Library/Safari/Bookmarks.plist lesen, nur lesend. Das Terminal braucht dafür Festplattenvollzugriff.
  2. Die Meta-Beschreibung jeder Seite laden, parallel.
  3. Claude Haiku über die Claude API je Lesezeichen nach einem Ordner fragen, mit Konfidenzwert. Umgesetzt werden nur Antworten ab 0,7.
  4. Mit --apply eine Importdatei mit allen Lesezeichen in neuer Ordnung schreiben, dazu eine zweite Datei mit dem alten Stand als Sicherung.

Ohne --apply ist jeder Lauf ein Testlauf. Den API-Schlüssel liest das Skript aus dem macOS-Schlüsselbund.

Modi

  • Standard: sortiert den Ordner „Inbox“ in vorhandene oder neue, spezifische Ordner wie „AI / Claude Code“. Formate wie Videos oder Podcasts sind als Ordner erlaubt, Plattformen wie YouTube oder GitHub sind kein Thema.
  • --folder PFAD: teilt einen Ordner in Unterordner auf.
  • --all: baut die ganze Sammlung in zwei Stufen neu auf. Erst entwirft das Modell aus allen Titeln, Domains und alten Ordnern eine Ordnerstruktur (8 bis 20 Hauptordner, höchstens vier Ebenen), ein zweiter Aufruf prüft nur die Hierarchie. Dann wird jedes Lesezeichen in diese Struktur einsortiert. Der Plan wird gespeichert, und --all --apply setzt genau ihn um, ohne neue API-Aufrufe.

Ablauf

Ich habe mich gegen das Tauschen einzelner Ordner entschieden. Jedes --apply erzeugt eine komplette Importdatei, und der Ablauf ist immer gleich:

  1. Skript mit --apply starten. Das muss vor dem Löschen passieren, weil das Skript die Lesezeichen aus Safari liest.
  2. In Safari alle Lesezeichen löschen, außer der Leseliste.
  3. Warten, bis Mac und iPhone beide leer sind.
  4. Die Datei importieren und die Ordner an ihren Platz ziehen.

Vor dem Schreiben zählt das Skript die Lesezeichen und bricht ab, wenn welche fehlen.

Safari-Lesezeichen und iCloud

Was das Projekt über Safari-Lesezeichen und iCloud herausgefunden hat.

Änderungen an der plist synchronisieren nicht

Safari speichert seine Lesezeichen in ~/Library/Safari/Bookmarks.plist. Ein Skript kann die Datei direkt ändern, während Safari geschlossen ist. Safari auf dem Mac zeigt die Änderung dann an, auch nach einem Neustart. iCloud überträgt sie aber nie aufs iPhone. Im selben Test kam ein von Hand in Safari angelegtes Lesezeichen sehr wohl an. iCloud selbst funktionierte also: Safari lädt nur Änderungen hoch, die es selbst verfolgt hat.

Eine plist-Kopie per cp zurückzuspielen hat dasselbe Problem: Mac und iCloud laufen auseinander.

Was funktioniert: der HTML-Import

Eine Lesezeichen-Datei im Netscape-HTML-Format, importiert über Ablage → Importieren aus → Lesezeichen-HTML-Datei, zählt als Änderung durch Safari und kommt auf dem iPhone an. Getestet erst mit einem kleinen Testordner, dann mit der ganzen Sammlung.

  • Safari führt einen Import nie mit vorhandenen Ordnern zusammen. Es legt einen neuen Import-Ordner an, in dem alles steht.
  • Favoriten und Lesezeichenmenü kommen als normale Ordner an. Ihren Inhalt zieht man von Hand an den richtigen Platz.

Aufbau der plist

  • BookmarksBar ist die Favoritenleiste, BookmarksMenu das Lesezeichenmenü.
  • Ordner auf oberster Ebene der Seitenleiste liegen direkt unter der Wurzel.
  • com.apple.ReadingList ist die Leseliste. Sie gehört nicht zur erzeugten Importdatei und darf deshalb nie mit den Lesezeichen gelöscht werden.

Wiederherstellung

Ältere Stände der Lesezeichen lassen sich auf iCloud.com unter Datenwiederherstellung, Lesezeichen wiederherstellen, zurückholen. iCloud spielt sie dann auf alle Geräte.

Erkenntnisse aus dem Bau

  • Schreiben in die plist synchronisiert nicht. Siehe Safari-Lesezeichen und iCloud weiter oben.
  • Seitenbeschreibungen: Kaggle liefert ohne echten Safari-User-Agent einen 404. Bei YouTube steht die Beschreibung erst rund 800 KB tief in der Seite, deshalb liest das Skript stückweise bis 3 MB. Trotzdem hatten 30 von 76 Inbox-Lesezeichen keine Beschreibung.
  • Hierarchie: Die erste Struktur legte Bangkok, Thailand, Singapur und Südostasien nebeneinander. Behoben durch eine ausdrückliche Teil-von-Regel (Stadt im Land, Land in der Region), einen zweiten Durchgang, der nur die Hierarchie prüft, und vier statt drei Ebenen.
  • Verkürzte Pfade: Das Modell lässt manchmal eine Ebene eines Pfads weg. Das Skript akzeptiert einen verkürzten Pfad, wenn genau ein Ordner dazu passt.
  • Schwache Treffer: Solange neue Ordner nur erlaubt waren, wenn gar kein Ordner passt, nahm das Modell einen ungefähr passenden vorhandenen Ordner mit niedriger Konfidenz, und das Lesezeichen blieb in der Inbox. Die Regel „ein ungefähr passender vorhandener Ordner ist schlechter als ein neuer, der genau passt“ hob den Anteil von 27 auf 50 von 76.
  • Schwelle: Eine Senkung von 0,7 auf 0,6 ließe auch Fehlgriffe durch, deshalb sortiere ich den unklaren Rest von Hand.
  • Doppelte: Lesezeichen mit derselben URL werden nur einmal übernommen.

Mehr dazu

Thema
  • KI / Sprachmodelle Wofür ich Sprachmodelle einsetze: Agenten, lokale Modelle, RAG und kleine Programme, in denen ein Modell eine Aufgabe übernimmt.
Nutzt
  • Claude API Die Programmierschnittstelle von Anthropic zu den Claude-Modellen. Wird getrennt von einem claude.ai-Abo abgerechnet, mit Schlüsseln aus der Claude Console.
  • macOS-Schlüsselbund In macOS eingebauter Passwortspeicher. Skripte legen API-Schlüssel dort statt in Dateien oder im Shell-Profil ab und lesen sie mit dem Befehl security.

In der Graph-Ansicht zeigen →