How do I install the Zbook skill?

Run npx skillmds@latest add halanhuang2025-lgtm/zbook in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Zbook safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Zbook?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Zbook free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

halanhuang2025-lgtm (@halanhuang2025-lgtm) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Zbook by halanhuang2025-lgtm — Agent Skill

Name: Zbook
Author: halanhuang2025-lgtm

Zbook

Download ebooks from Z-Library with a single command or sentence. Use when user asks to download a book, search for ebooks, or get any title from Z-Library. Triggers on "下载《书名》", "download book", "get me the epub of", "zbook", "从 Z-Library 下载". No Telegram bot or API key required — uses direct Z-Library API + Playwright for Cloudflare bypass.

File contents

zbook

一句话从 Z-Library 下载任意电子书。

技术栈: Z-Library eapi 搜索 + Playwright headless 绕 Cloudflare 下载
无需 Telegram bot，无需额外 API key，只需 Z-Library 账号。

用法（对我说）

"帮我下载《Atomic Habits》"
"下载三体 epub"
"下载 Designing Data-Intensive Applications"

命令

python3 skills/zbook/scripts/zbook.py "书名或作者"
python3 skills/zbook/scripts/zbook.py --format epub --lang en "Atomic Habits"
python3 skills/zbook/scripts/zbook.py --lang zh "三体 刘慈欣"
python3 skills/zbook/scripts/zbook.py --index 1 "深度工作"   # 选第2个结果
python3 skills/zbook/scripts/zbook.py --json "Atomic Habits" # JSON 输出
python3 skills/zbook/scripts/zbook.py --setup                # 首次配置

配置

配置文件：~/.zbook/config.json

{
  "email": "your@email.com",
  "password": "your_password",
  "download_dir": "~/Downloads/ebooks"
}

运行 --setup 进入交互配置向导。

Cookie 缓存在 ~/.zbook/cookies.json（24h 有效），避免频繁登录触发限制。

依赖安装

pip3 install playwright aiohttp --break-system-packages
python3 -m playwright install chromium

工作原理

登录: POST z-library.sk/rpc.php 获取认证 cookies（缓存 24h）
搜索: POST /eapi/book/search，参数名 message，form-urlencoded（注意：不是 q，不是 JSON）
排序: 按语言+格式偏好打分排序
下载: Playwright 注入 cookies，导航到 /dl/xxx 触发文件下载（绕 Cloudflare）

注意事项

Z-Library 免费账号每日下载限额 10 本
搜索参数名是 message（不是 q），格式必须是 application/x-www-form-urlencoded
下载端点有 Cloudflare 保护，纯 HTTP 请求会被 503，必须用 Playwright
登录频繁会触发 "Too many logins" 限制，cookie 缓存机制解决此问题

---name: zbookdescription: Download ebooks from Z-Library with a single command or sentence. Use when user asks to download a book, search for ebooks, or get any title from Z-Library. Triggers on "下载《书名》", "download book", "get me the epub of", "zbook", "从 Z-Library 下载". No Telegram bot or API key required — uses direct Z-Library API + Playwright for Cloudflare bypass.---# zbook一句话从 Z-Library 下载任意电子书。技术栈: **Z-Library eapi 搜索** + **Playwright headless 绕 Cloudflare 下载** 无需 Telegram bot，无需额外 API key，只需 Z-Library 账号。## 用法（对我说）- "帮我下载《Atomic Habits》"- "下载三体 epub"- "下载 Designing Data-Intensive Applications"## 命令```bashpython3 skills/zbook/scripts/zbook.py "书名或作者"python3 skills/zbook/scripts/zbook.py --format epub --lang en "Atomic Habits"python3 skills/zbook/scripts/zbook.py --lang zh "三体刘慈欣"python3 skills/zbook/scripts/zbook.py --index 1 "深度工作" # 选第2个结果python3 skills/zbook/scripts/zbook.py --json "Atomic Habits" # JSON 输出python3 skills/zbook/scripts/zbook.py --setup # 首次配置```## 配置配置文件：`~/.zbook/config.json````json{ "email": "your@email.com", "password": "your_password", "download_dir": "~/Downloads/ebooks"}```运行 `--setup` 进入交互配置向导。Cookie 缓存在 `~/.zbook/cookies.json`（24h 有效），避免频繁登录触发限制。## 依赖安装```bashpip3 install playwright aiohttp --break-system-packagespython3 -m playwright install chromium```## 工作原理1. **登录**: POST `z-library.sk/rpc.php` 获取认证 cookies（缓存 24h）2. **搜索**: POST `/eapi/book/search`，参数名 `message`，form-urlencoded（注意：不是 `q`，不是 JSON）3. **排序**: 按语言+格式偏好打分排序4. **下载**: Playwright 注入 cookies，导航到 `/dl/xxx` 触发文件下载（绕 Cloudflare）## 注意事项- Z-Library 免费账号每日下载限额 10 本- 搜索参数名是 `message`（不是 `q`），格式必须是 `application/x-www-form-urlencoded`- 下载端点有 Cloudflare 保护，纯 HTTP 请求会被 503，必须用 Playwright- 登录频繁会触发 "Too many logins" 限制，cookie 缓存机制解决此问题

Frequently asked questions