Supernote云管理

技能简介

通过逆向工程的REST API连接自托管Supernote私有云实例，实现文件浏览、文档上传、网页文章转电子书并推送至设备等功能。

能做什么

• 浏览云端目录结构与文件列表
• 上传PDF、EPUB等文档到指定文件夹
• 将网页文章转换为EPUB或PDF格式发送至设备
• 查询设备存储容量使用情况
• 按路径或ID定位特定目录

使用说明

环境配置（必需）

export SUPERNOTE_URL="http://192.168.50.168:8080"
export SUPERNOTE_USER="your@email.com"
export SUPERNOTE_PASSWORD="your_password"

Python依赖安装（文章转换功能需要）

pip install readability-lxml ebooklib requests beautifulsoup4 lxml

常用操作示例

发送网页文章到设备：

{baseDir}/scripts/supernote.sh send-article --url "https://example.com/article" --format epub --dir-path Document

列出根目录内容：

{baseDir}/scripts/supernote.sh ls

查看指定路径目录：

{baseDir}/scripts/supernote.sh ls --path "Document/Books"

上传本地文件：

{baseDir}/scripts/supernote.sh upload --file /path/to/file.pdf --dir-path Document

检查存储容量：

{baseDir}/scripts/supernote.sh capacity

显示目录树结构：

{baseDir}/scripts/supernote.sh tree --depth 2

输入与输出

见下方输入与输出表格。

项目	内容
输入	SUPERNOTE_URL实例地址、SUPERNOTE_USER邮箱、SUPERNOTE_PASSWORD密码；上传时需本地文件路径；文章转换时需目标网页URL；目录操作时可接受路径字符串或数字ID
输出	JSON格式的目录列表、文件上传状态、存储容量统计、转换后的EPUB/PDF文件
适用人群	拥有自托管Supernote私有云的设备用户、需要将网页内容推送至电子墨水屏阅读的技术人员、批量管理PDF/EPUB文档的进阶用户
不包含	Supernote官方公有云服务、Kindle/文石等其他品牌设备支持、.note手写笔记文件编辑、多设备实时同步机制

 

风险提示

• 该API为逆向工程实现，非官方接口，固件更新可能导致接口变动
• 部分网站会阻止内容抓取，若获取失败可尝试更换URL或使用本地缓存页面
• 需妥善保管SUPERNOTE_PASSWORD环境变量，避免密码泄露
• 自托管服务暴露于网络时建议配置访问控制

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/nickian/supernote-cloud/SKILL.md
来源类型：GitHub开源项目