miyatti777/nsync

Notion-Synchronisationstool – Klone, synchronisiere und übertrage Notion-Seiten als lokales Markdown. Keine Abhängigkeiten. Kompatibel mit Claude Skill.

Was ist nsync?

Dieses Skill ermöglicht es dir, Notion-Seiten als lokale Markdown-Dateien zu klonen, zu synchronisieren und zu pushen. Es ist besonders nützlich für Entwickler und Power-User, die Notion-Inhalte in git-basierten Workflows oder KI-Agenten wie Claude Code nutzen möchten. Das Tool hat keine externen Abhängigkeiten und ist vollständig selbstständig nutzbar. Es unterstützt den bidirektionalen Datenaustausch: Du kannst Notion-Seiten lokal als Markdown speichern, Änderungen vornehmen und diese zurück nach Notion pushen. Die Integration mit Claude Skill ermöglicht es, Notion-Daten direkt in KI-gestützte Arbeitsabläufe einzubinden. Der Skill ist plattformunabhängig und funktioniert mit allen gängigen Systemen, die Node.js oder Python unterstützen. Durch die einfache CLI-Schnittstelle kannst du Aktionen wie 'klonen', 'synchronisieren' und 'pushen' schnell ausführen – ideal für die Automatisierung von Dokumentations- und Wissensmanagement-Prozessen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add miyatti777/nsync

Installed? Explore more Produktivität & Zusammenarbeit skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht nsync?

Notion-Synchronisationstool – Klone, synchronisiere und übertrage Notion-Seiten als lokales Markdown. Keine Abhängigkeiten. Kompatibel mit Claude Skill.

Übersicht

Dieses Tool ermöglicht es dir, Notion-Seiten als Markdown-Dateien lokal zu klonen, Änderungen zu synchronisieren und lokale Änderungen zurück nach Notion zu pushen. Es ist ideal für Entwickler, die Notion für Dokumentation oder Wissensmanagement nutzen und Inhalte in git-basierten Workflows oder KI-Agenten wie Claude Code bearbeiten möchten.

Voraussetzungen

  • Node.js (v14 oder höher) oder Python 3.6+
  • Ein Notion-Integrationstoken
  • Die ID der zu synchronisierenden Notion-Seite oder -Datenbank

Installation

npm install -g @miyatti777/nsync

Oder mit Python:

pip install nsync

Verwendung

Klonen einer Notion-Seite

nsync clone <page-id> --output ./notion-pages

Synchronisieren lokaler Änderungen

nsync push <page-id> --input ./notion-pages

Hilfe anzeigen

nsync --help

Konfiguration

Erstelle eine .env-Datei im Stammverzeichnis:

NOTION_TOKEN=dein_notion_integrationstoken
NOTION_PAGE_ID=deine_notion_seiten_id
OUTPUT_DIR=./notion-pages

Funktionsweise

  1. Klonen: Lädt eine Notion-Seite oder Datenbank herunter und konvertiert sie in Markdown-Dateien (mit YAML-Frontmatter für Metadaten wie Titel, Erstellungsdatum, Tags).
  2. Synchronisieren: Vergleicht lokale Markdown-Dateien mit Notion-Inhalten und überträgt Änderungen.
  3. Pushen: Sendet lokale Markdown-Änderungen zurück an Notion unter Beibehaltung der Struktur.

Unterstützte Notion-Blöcke

  • Überschriften (H1, H2, H3)
  • Absätze
  • Aufzählungen (geordnet/ungeordnet)
  • Codeblöcke
  • Tabellen
  • Aufrufe (Callouts)
  • Bilder (als Links)

Kompatibilität mit Claude Skill

Dieses Tool ist als Claude Skill konfigurierbar. Füge es als benutzerdefiniertes Tool in deiner Claude-Konfiguration hinzu, um Notion-Daten direkt in KI-gestützten Workflows zu nutzen.

Beispiel für die Claude-Konfiguration:

{
  "name": "nsync",
  "description": "Klont, synchronisiert oder pusht Notion-Seiten als lokales Markdown.",
  "command": "nsync"
}

Lizenz

MIT

Verwandte Skills