supernote
Access a self-hosted Supernote Private Cloud instance to browse files and folders, upload documents (PDF, EPUB) and notes, convert web articles to EPUB/PDF and send them to the device, check storage capacity, and navigate the directory tree. Use when the user mentions Supernote, e-ink device files, wants to upload/browse documents on their Supernote cloud, or wants to send an article/URL to their e-reader.
ソース情報
- リポジトリ
- Kernel8901/ai-agent-skills-classification
- ソースの最終更新活動
- 2026年4月4日 15:26
- 検出された SKILL.md の言語
- 英語
- スター
- 6
- フォーク
- 1
インストール方法
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
ソースファイルを確認
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
ファイルエクスプローラー
4 ファイルSKILL.md を表示中
SKILL.md
ソースの指示 · 読み取り専用プレビュー- name
- supernote
- description
- Access a self-hosted Supernote Private Cloud instance to browse files and folders, upload documents (PDF, EPUB) and notes, convert web articles to EPUB/PDF and send them to the device, check storage capacity, and navigate the directory tree. Use when the user mentions Supernote, e-ink device files, wants to upload/browse documents on their Supernote cloud, or wants to send an article/URL to their e-reader.
# Supernote Private Cloud
Browse, upload, and manage files on a self-hosted Supernote Private Cloud via its reverse-engineered REST API. Includes article-to-ebook conversion for sending web content to the device.
## Setup
```bash
export SUPERNOTE_URL="http://192.168.50.168:8080"
export SUPERNOTE_USER="your@email.com"
export SUPERNOTE_PASSWORD="your_password"
```
Python dependencies (for article conversion): `readability-lxml`, `ebooklib`, `requests`, `beautifulsoup4`, `lxml`.
## Commands
### Send a web article to the device
```bash
{baseDir}/scripts/supernote.sh send-article --url "https://example.com/article" --format epub --dir-path Document
{baseDir}/scripts/supernote.sh send-article --url "https://example.com/article" --format pdf --dir-path "Document/Articles"
{baseDir}/scripts/supernote.sh send-article --url "https://example.com/article" --title "Custom Title" --dir-path Document
```
Fetches article content, extracts readable text with images, converts to clean EPUB or PDF, then uploads to the specified folder. Default format: epub. Default folder: Document.
### List directory contents
```bash
{baseDir}/scripts/supernote.sh ls
{baseDir}/scripts/supernote.sh ls --path Document
{baseDir}/scripts/supernote.sh ls --path "Note/Journal"
{baseDir}/scripts/supernote.sh ls --dir 778507258886619136
```
### Directory tree
```bash
{baseDir}/scripts/supernote.sh tree --depth 2
```
### Find directory ID by path
```bash
{baseDir}/scripts/supernote.sh find-dir --path "Document/Books"
```
### Upload a file
```bash
{baseDir}/scripts/supernote.sh upload --file /path/to/file.pdf --dir-path Document
{baseDir}/scripts/supernote.sh upload --file /path/to/book.epub --dir-path "Document/Books"
{baseDir}/scripts/supernote.sh upload --file /path/to/file.pdf --dir 778507258773372928 --name "Renamed.pdf"
```
### Check storage capacity
```bash
{baseDir}/scripts/supernote.sh capacity
```
### Login (manual)
```bash
{baseDir}/scripts/supernote.sh login
```
## Default Folders
| Folder | Purpose |
|--------|---------|
| Note | Handwritten notes (.note files) |
| Document | PDFs, EPUBs, documents |
| Inbox | Incoming files |
| Export | Exported content |
| Screenshot | Screenshots |
| Mystyle | Custom styles/templates |
## Notes
- EPUB is recommended for articles — renders cleanly on e-ink with reflowable text
- The API is reverse-engineered and unofficial — endpoints may change with firmware updates
- Directory args accept paths (e.g., "Document/Books") or numeric IDs
- Some sites block scraping — if fetch fails, try a different URL or use a cached/saved page
GitHubで見る