supernote-cloud_skill

Overview

This skill lets you connect to a self-hosted Supernote Private Cloud to browse folders, upload PDFs/EPUBs and notes, convert web articles to EPUB or PDF, and send them directly to your Supernote e-ink device. It uses the device's reverse-engineered REST API to list directories, inspect storage capacity, and navigate the directory tree. The article conversion pipeline extracts readable content and packages it into clean EPUB or PDF files for optimal rendering on e-ink.

How this skill works

The skill authenticates to your Supernote Private Cloud instance and exposes operations to list directories, find folder IDs, and upload files to a specified path or numeric dir ID. For article delivery, it fetches the URL, extracts the main article content and images, converts that into an EPUB or PDF using standard libraries, then uploads the resulting file into the chosen folder. It can also report storage usage and render a directory tree to help you choose upload targets.

When to use it

• You want to send a web article to your Supernote in EPUB or PDF format for comfortable reading.
• You need to upload PDFs, EPUBs, or .note files to specific folders on your self-hosted Supernote cloud.
• You want to browse or inspect the directory tree and find numeric folder IDs for automation.
• You need to check remaining storage before large uploads or backups.
• You manage content for an e-ink workflow and want programmatic control over file placement.

Best practices

• Prefer EPUB for article conversions — reflowable text renders best on e-ink devices.
• Use folder paths like 'Document/Books' or numeric directory IDs for precise placement.
• Run a quick capacity check before bulk uploads to avoid failed transfers.
• If article fetch fails, try a different URL or save the page and upload the saved HTML.
• Keep authentication credentials secure in environment variables and avoid exposing them in scripts.

Example use cases

• Convert a long-form article to EPUB and send it to Document/Articles for offline reading.
• Bulk upload a set of PDFs into Document/Books and verify directory structure with a tree command.
• Locate a folder's numeric ID using path lookup, then upload a renamed file directly to that ID.
• Check remaining storage before syncing a large collection of textbooks to the device.
• Export handwritten notes from the cloud into a local backup folder using the directory listing.