得到 Skill
/install dedao-dl-skill
dedao-dl
This skill guides the agent in using the dedao-dl CLI tool to interact with the Dedao (得到) app content.
Initialization
MANDATORY FIRST STEP: Before using any dedao-dl commands for the first time, you MUST run the installation script and verify the CLI is available.
Run the script to download the latest binary for the current OS:
python scripts/install_dedao_dl.py
After installation, you should ALWAYS use the helper script scripts/run_dedao.py to execute commands instead of running the raw dedao-dl executable. The helper script cleans up the CLI's terminal formatting, making the output directly readable by you without needing to redirect it to text files.
Example: Use python scripts/run_dedao.py -h instead of ./dedao-dl -h.
Prerequisites & Login
Before downloading any content, ensure the user is logged in:
- Command:
python scripts/run_dedao.py login -q(QR code login) orpython scripts/run_dedao.py login -c "\x3Ccookie_string>" - Verify current user:
python scripts/run_dedao.py who - List logged-in users:
python scripts/run_dedao.py users - Switch user:
python scripts/run_dedao.py su
Dependencies for specific formats (inform the user if they are missing):
- PDF generation requires
wkhtmltopdf - Audio generation requires
ffmpeg - Markdown requires no additional dependencies
General Workflow
For any content download, the typical two-step workflow is:
- List the specific type of content to find its
ID. - Use the corresponding download command with the
IDand format flag (-t).
Key Workflows & Commands
1. Courses (专栏/课程) & Free Content (免费专区)
- List purchased courses:
python scripts/run_dedao.py course - List free courses:
python scripts/run_dedao.py free(ReturnsEnIDstrings instead of integerIDs) - List articles in a course:
- For purchased courses (using integer ID):
python scripts/run_dedao.py course -i \x3Ccourse_ID> - For free courses (using EnID):
python scripts/run_dedao.py article -c \x3Ccourse_EnID>
- For purchased courses (using integer ID):
- Download a single article (RECOMMENDED):
python scripts/run_dedao.py dl \x3Ccourse_ID_or_EnID> \x3Carticle_ID> -t \x3Cformat> - Download a full course:
python scripts/run_dedao.py dl \x3Ccourse_ID_or_EnID> -t \x3Cformat> [options]- WARNING: NEVER download a full course (only 1 parameter) without explicit user permission. Full downloads can take hours, consume massive disk space, and trigger anti-bot bans.
- Formats (
-t):1(MP3),2(PDF),3(Markdown, DEFAULT FOR THE AGENT) - Options for Markdown (
-t 3):-m(merge into one file),-c(include hot comments) - Prefix ordering:
-o(adds index prefix like00x.) Note: When downloading as PDF, be aware of rate limits ("496 NoCertificate"). Add sleep intervals if scripting.
2. E-Books (电子书)
- List e-books:
python scripts/run_dedao.py ebook - Download an e-book:
python scripts/run_dedao.py dle \x3Cebook_ID> -t \x3Cformat>- Formats (
-t):1(HTML, default),2(PDF),3(EPUB),4(Markdown Notes)
- Formats (
- View e-book notes:
python scripts/run_dedao.py ebook notes -i \x3Cebook_ID> - Export e-book notes:
python scripts/run_dedao.py dle \x3Cebook_ID> -t 4(Downloads notes as Markdown)
3. Audiobooks (每天听本书)
- List audiobooks:
python scripts/run_dedao.py odob - Download audiobook audio/text:
python scripts/run_dedao.py dlo \x3Caudiobook_ID> -t \x3Cformat>- Formats (
-t):1(MP3),2(PDF),3(Markdown, DEFAULT FOR THE AGENT)
- Formats (
4. Other Content
- List all categories & stats:
python scripts/run_dedao.py cat - List 'JinNang' (锦囊):
python scripts/run_dedao.py ace - List recommended topics (知识城邦):
python scripts/run_dedao.py topic
Execution Guidelines
- Always check
python scripts/run_dedao.py -horpython scripts/run_dedao.py \x3Ccommand> -hif unsure of the exact arguments. - Always retrieve the correct
IDfirst before executing a download command. Make sure you use the list command corresponding to the content type you want to download (e.g.,courseID fordl,ebookID fordle,odobID fordlo). Do not mix up IDs across categories. - NEVER download an entire course (e.g.
python scripts/run_dedao.py dl \x3Ccourse_ID_or_EnID>) unless the user explicitly asks you to. Many courses have hundreds of articles which can lead to account bans. - ALWAYS favor downloading a single article: First list the course articles using
course -i \x3Ccourse_ID>orarticle -c \x3Ccourse_EnID>, find the specific article ID, and usepython scripts/run_dedao.py dl \x3Ccourse_ID_or_EnID> \x3Carticle_ID>. - DEFAULT FORMAT: Whenever you download content using
dlordlo, default to using-t 3(Markdown) unless the user explicitly asks for MP3 or PDF. Markdown is safer, faster, and easier to read. - When generating markdown for a whole course (if permitted by the user), consider using
-mto consolidate files unless the user explicitly asks for individual files.
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install dedao-dl-skill - 安装完成后,直接呼叫该 Skill 的名称或使用
/dedao-dl-skill触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
得到 Skill 是什么?
Handles interactions with the dedao-dl CLI tool for downloading and managing content from the Dedao (得到) App. Use when the user wants to list bought courses,... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 329 次。
如何安装 得到 Skill?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install dedao-dl-skill」即可一键安装,无需额外配置。
得到 Skill 是免费的吗?
是的,得到 Skill 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
得到 Skill 支持哪些平台?
得到 Skill 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 得到 Skill?
由 ANGJustinl(@angjustinl)开发并维护,当前版本 v0.1.1。