Webseiten mit dem Web Clipper sammeln

Der Web Clipper schickt eine Webseite, einen markierten Text oder ein YouTube-Transkript an deine Engine. Der Eintrag wartet im Cockpit unter Eingang, bis du ihn prüfst. Durch das Sammeln allein wird nichts zu Wissen oder zu einem Skill.

Der Weg ist immer gleich: sammeln → im Chat prüfen → bestätigen → Wissen oder Skill.

Was du brauchst #

Google Chrome. Andere Browser sind nicht getestet.
Die sk-CLI, angemeldet an deiner Engine. Siehe „Die sk-CLI auf deinem Rechner verwenden“.
Eine Engine-Adresse mit HTTPS. Einfaches HTTP funktioniert nur mit localhost, 127.0.0.1 oder [::1]. In SubKit Cloud ist es https://subkit-cloud.mikebild.info, ohne /cockpit.
Ein Konto mit intake:read und intake:write. Fehlen sie, bitte eine Administratorin oder einen Administrator darum.

Den Web Clipper gibt es nicht im Chrome Web Store. Du installierst ihn über die CLI.

Die Erweiterung installieren #

Der Installer übernimmt die Engine-Adresse deines aktiven Profils. Später trägst du nur noch einen API-Schlüssel ein.

Führe sk clipper install aus. Der Befehl entpackt die Erweiterung nach ~/.sk/clipper und versucht, die Erweiterungsseite von Chrome zu öffnen. text sk: clipping extension installed to /Users/you/.sk/clipper sk: in Chrome, enable Developer mode, select Load unpacked, and choose the directory above. Reload the extension there after a future install. Die Ausgabe nennt den Installationsordner und die nächsten Schritte in Chrome.
Öffne in Chrome chrome://extensions.
Schalte oben rechts den Entwicklermodus ein.
Wähle Entpackte Erweiterung laden (in englischem Chrome: Load unpacked) und den Ordner, den der Befehl ausgegeben hat.
Hefte die Erweiterung „SubKit Clipper“ an die Symbolleiste.

Öffnet sich Chrome nicht, meldet der Befehl sk: could not open Chrome automatically. Öffne dann chrome://extensions selbst.

Die Erweiterung aktualisieren #

Installiere den Web Clipper nach einem Update der sk-CLI erneut. Deine Verbindungseinstellungen bleiben erhalten.

Führe sk clipper install aus.
Lade die Erweiterung „SubKit Clipper“ auf chrome://extensions neu.

Mit deiner Engine verbinden #

Der Web Clipper meldet sich mit einem eigenen API-Schlüssel an.

Öffne im Cockpit API-Zugang.
Wähle Schlüssel erstellen und die Vorlage Web Clipper. Die Vorlage gewährt genau intake:read und intake:write. (öffnet in einem neuen Tab)Screenshot aus Build 10.4.16
Kopiere den Schlüssel.
Wähle im Web Clipper das Zahnrad (⚙). Die Einstellungen öffnen sich in einem neuen Tab.
Prüfe die Engine-Adresse und füge den Schlüssel unter API-Schlüssel ein.
Wähle Verbindung speichern.
Erlaube den Zugriff, wenn Chrome danach fragt.

Der Web Clipper prüft die Verbindung, lädt deine Kategorien und bestätigt, dass der Schlüssel Clips speichern darf.

Ändert sich die Engine-Adresse, brauchst du auch den Schlüssel der neuen Engine. API-Schlüssel löschen entfernt den gespeicherten Schlüssel aus der Erweiterung.

Eine Seite sammeln #

Wähle in der Symbolleiste das Symbol des Web Clippers („SubKit Clipper“).
Prüfe den Titel.
Optional: Fülle Warum ist das interessant? aus.
Wähle eine Kategorie oder Neue Kategorie. Namen bestehen aus Kleinbuchstaben, Ziffern und Bindestrichen, höchstens 40 Zeichen.
Prüfe die Vorschau.
Optional: Öffne Details und Inhalt bearbeiten, um Autor und Datum zu sehen und das Markdown zu ändern.
Wähle Sammeln.

Alternativ: Rechtsklick > Seite in SubKit sichern oder Auswahl in SubKit sichern, oder Alt+Shift+K.

Bei Erfolg meldet das Popup zum Beispiel „Gesammelt: research. Noch nicht als Wissen oder Skill übernommen.“ Wähle Im Chat prüfen, um die Prüfung sofort zu starten.

Gut zu wissen:

Schlägt das Speichern fehl, bleibt dein Entwurf im Web Clipper.
Dieselbe Seite wird nie doppelt gesammelt.
Das Tastenkürzel änderst du unter chrome://extensions/shortcuts.

Wie es weitergeht #

Eingang: Öffne im Cockpit Eingang. Dort liest, bearbeitest, verschiebst oder verwirfst du den Eintrag.
Prüfen: Wähle Im Chat prüfen im Web Clipper oder beim Eintrag. Der Chat bereitet einen Vorschlag vor: genauer Inhalt, Quellen und Ziel (Wissen oder Skill).
Bestätigen: Nur eine Person, die im Browser am Cockpit angemeldet ist, bestätigt den Vorschlag als Wissen oder Skill.

Zum Bestätigen braucht diese Person intake:confirm und das Recht des Ziels:

Ziel	Nötige Rechte
Wissen	`knowledge:write`
Skill	`skill:write` und `skill:activate`
Skill, der andere ersetzt	zusätzlich `skill:archive` für jeden ersetzten Skill

API-Schlüssel, MCP-Clients und der Web Clipper können nicht bestätigen.

Solange niemand bestätigt, ist ein Clip kein Wissen, und die normale Wissenssuche findet ihn nicht. Auch Verschieben oder Bearbeiten übernimmt ihn nicht. Ändert sich der Vorschlag, prüfst du ihn erneut. Prüfen und Bestätigen beschreibt das Kapitel „Ideen sammeln und in Wissen oder Skills verwandeln“.

Was der Web Clipper erfasst #

Eine Seite: Haupttext des Artikels als Markdown, Links als vollständige Adressen, ohne Navigation und Empfehlungen.
Einen markierten Text: nur die Markierung. Über Symbolleiste oder Tastenkürzel nimmt der Web Clipper die Markierung, sonst den ganzen Artikel.
Ein YouTube-Video: Titel, Autor, Veröffentlichungsdatum, Beschreibung und Transkript in der Originalsprache. Beschreibung und Transkript schaltest du unter Details und Inhalt bearbeiten einzeln ein oder aus.

Dazu kommen Quelladresse, Autor und Veröffentlichungsdatum, sofern die Seite sie angibt. Bildlinks bleiben im Text. Bilddateien und Screenshots werden nicht hochgeladen.

Datenschutz #

Ziel: Clips gehen nur an die Engine, die du eingestellt hast. Für das Transkript lädt der Web Clipper eventuell Seite und Untertitel direkt von YouTube.
Originale bleiben: Die Engine bewahrt den ursprünglich erfassten Stand. Spätere Änderungen überschreiben ihn nicht, und der Clip bleibt mit dem daraus entstandenen Wissen oder Skill verknüpft.
Geheimnisse werden ersetzt: Vor dem Speichern ersetzt SubKit erkennbare Geheimnisse (API-Schlüssel, Tokens, private Schlüssel, Signaturen signierter Links) durch eine Markierung. Die Werte werden nie gespeichert. Personenbezogene Daten bleiben erhalten. Sammle keine Seiten, die Passwörter oder Schlüssel zeigen.
Dein API-Schlüssel liegt in der Erweiterung auf diesem Gerät. Widerrufe ihn im Cockpit, wenn du ihn nicht mehr brauchst.
Sichtbarkeit: Einträge folgen den Berechtigungen deines Arbeitsbereichs. Kategorien sind gemeinsam, nicht privat.

Installationsoptionen #

Option	Wirkung
`--dir <directory>`	Installiert in einen anderen Ordner.
`--engine-url <url>`	Nutzt diese Engine-Adresse statt der des aktiven Profils.
`--no-open`	Öffnet Chrome nicht.

Wenn etwas nicht klappt #

Der Web Clipper zeigt Meldungen in der eingestellten Sprache. Hilfe im Popup und in den Einstellungen öffnet dieses Kapitel auf deiner Engine. Schlägt eine Erfassung per Kontextmenü oder Tastenkürzel fehl, öffnet der Web Clipper sein Popup in einem Tab und zeigt den Fehler dort.

Verbindung und Schlüssel

Was du siehst	Was du tust
„Lege zuerst eine Engine-Adresse und einen API-Schlüssel fest.“ oder „Lege vor dem Erfassen eine Engine-Adresse fest.“	Trage beides in den Einstellungen (⚙) ein und speichere.
„Der API-Schlüssel ist ungültig oder abgelaufen. …“	Erstelle unter API-Zugang einen neuen Schlüssel mit der Vorlage Web Clipper und speichere ihn in den Einstellungen.
„Dem API-Schlüssel fehlt intake:read. …“ oder „… fehlt intake:write. …“	Erstelle unter API-Zugang einen Schlüssel mit der Vorlage Web Clipper. Dein Entwurf bleibt erhalten.
„Die SubKit-API ist nicht erreichbar. …“	Prüfe Engine-Adresse und Internetverbindung und ob Chrome auf die Adresse zugreifen darf.
„Nutze HTTPS oder HTTP auf localhost.“	Nutze `https://`, oder `http://` nur mit `localhost`, `127.0.0.1` oder `[::1]`. Die Adresse darf keinen Benutzernamen, kein Passwort, keine `?query` und kein `#fragment` enthalten.
„Erlaube den Zugriff auf diese Engine, um die Verbindung zu speichern.“	Speichere erneut und erlaube den Zugriff, wenn Chrome fragt.
„Gib einen API-Schlüssel für die neue Engine ein.“	Du hast die Engine-Adresse geändert. Füge den Schlüssel der neuen Engine ein.
„Kategorien gerade nicht verfügbar“	Wähle Verbindung prüfen.

Erfassen

Was du siehst	Was du tust
„Der Hauptinhalt konnte nicht zuverlässig erfasst werden. …“	Markiere den relevanten Text und wähle Neu erfassen.
„Der Inhalt wurde vereinfacht als Text erfasst. …“	Prüfe die Vorschau auf Vollständigkeit.
„Es wurde kein Text erfasst. …“	Wähle Neu erfassen. Für einen Ausschnitt markierst du vorher den Text.
„Kein Transkript verfügbar.“	Der Web Clipper konnte für dieses Video kein Transkript lesen.
„Öffne den Clipper über die Symbolleiste auf dieser Seite erneut.“	Chrome braucht Zugriff auf diese Seite. Wähle dort das Symbol in der Symbolleiste.
„Die Seite hat sich während der Erfassung geändert. Erfasse sie erneut.“	Erfasse erneut.
„Die Seite konnte nicht erfasst werden.“	Lade die Seite neu und versuche es erneut.

Sammeln

Was du siehst	Was du tust
„Die Speicherung ist noch nicht bestätigt. Versuche es erneut; dein Entwurf bleibt erhalten.“	Netzwerk oder Engine hatten einen Fehler. Wähle Erneut versuchen.
„SubKit hat den Clip abgelehnt. …“	Prüfe Kategorie und Inhalt und versuche es erneut.
„Dieser Clip existiert bereits.“	Er wurde schon gesammelt.
„Wähle eine gültige Kategorie, bevor du sammelst.“ oder „Gib eine gültige Kategorie ein.“	Nutze Kleinbuchstaben, Ziffern und Bindestriche, höchstens 40 Zeichen.
„Die gespeicherte Kategorie ist nicht verfügbar. Wähle eine andere Kategorie.“	Wähle eine andere Kategorie.
„Dieser Entwurf gehört zu einer anderen Engine.“	Wechsle zu der Engine zurück, für die er entstand, um ihn zu senden.