← Back to Skills Marketplace
zykqyer

issuu_downloader

by zykqyer · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
121
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install issuu-downloader
Description
Download any public Issuu document as a high-quality PDF with automatic proxy detection and anti-blocking features for reliable access.
README (SKILL.md)

Issuu PDF Downloader (Professional Edition)

A robust and reliable tool to download any publicly available document from Issuu.com and convert it into a high-quality PDF. This version includes anti-blocking measures and auto-proxy detection. Please use VPN if you located in a restricted region.

Key Features

  • Anti-503 Logic: Enhanced retry mechanism to bypass temporary service blocks.
  • Auto-Proxy Detection: Automatically detects local proxies (Clash/V2Ray) on common ports (7890, 1080, 1087).
  • Smart Probing: Uses a refined page detection algorithm to ensure all pages are captured.
  • High-Fidelity PDF: Direct JPG-to-PDF conversion to maintain original resolution.

How to Use

Simply provide the Issuu URL to the AI:

"Download this Issuu link for me: https://issuu.com/example/docs/manual"

Troubleshooting for Restricted Regions

If you encounter "Access Denied" or "503 Error":

  1. Enable Proxy: Ensure your VPN/Proxy is active.
  2. Switch Node: Try a different server location (US or UK recommended).
  3. Manual Proxy: You can explicitly provide a proxy:

    "Use proxy http://127.0.0.1:7890 to download this Issuu link..."

Disclaimer

For educational purposes only. Users are responsible for complying with Issuu's Terms of Service and copyright laws.

Usage Guidance
This skill appears to do what it says, but check these before installing: - Dependency install: it needs Python packages (requests, img2pdf, urllib3). Ensure the agent environment can install and run these safely (use a sandbox or virtualenv). - Network activity: the skill will probe localhost proxy ports (127.0.0.1:7890, 1080, 1087) and make quick requests to https://www.google.com to detect proxies, then fetch images from image.isu.pub. If you want to avoid external network calls, do not run it. - Output mismatch: skill.yaml declares a structured JSON output but the Python entrypoint returns only a file path string — callers/integrations may need adaptation. - Files written: it creates a 'downloads' directory and writes the PDF there. Make sure you are comfortable with that location and have space. - Legal/ToS: using tools to bypass geographic blocks or download copyrighted content may violate Issuu's terms or copyright law. Only use on public content you have rights to access. - If uncertain, run the code in an isolated environment on a non-sensitive test URL first, and review/modify the code if you want different behavior (e.g., change proxy probing, output format, or output path).
Capability Analysis
Type: OpenClaw Skill Name: issuu-downloader Version: 1.0.0 The skill performs automated local network probing in main.py by scanning specific ports (7890, 1080, 1087) on the localhost to detect proxies, and validates them by making an external request to google.com. While these features are aligned with the stated purpose of bypassing regional restrictions in SKILL.md, automated environment discovery and local port scanning are risky behaviors often associated with system fingerprinting and unauthorized network mapping.
Capability Assessment
Purpose & Capability
The name, SKILL.md and code all align: the code fetches JPEG pages from Issuu and converts them to a PDF and implements proxy detection and retry logic. One minor incoherence: skill.yaml declares a structured output object (status, file_path, message) but the entrypoint run_skill returns just a file path (string). Also registry metadata/version (1.0.0) and skill.yaml (1.1.0) differ, which is likely a packaging oversight but not malicious.
Instruction Scope
SKILL.md instructs only to provide an Issuu URL (and optionally a proxy). The runtime instructions and code limit actions to probing local proxies on 127.0.0.1, testing a public host (https://www.google.com) to detect proxies, and fetching image pages from image.isu.pub. These network calls are coherent with auto-proxy detection and downloading pages. The skill writes files to a local downloads directory. No instructions to read unrelated user files or access environment secrets are present.
Install Mechanism
There is no explicit install spec, but a requirements.txt lists PyPI packages (requests, img2pdf, urllib3). That is a common installation approach but means dependencies will need to be installed in the agent environment (moderate-risk compared to instruction-only). No remote archives or obscure URLs are used.
Credentials
The skill requests no environment variables, no external credentials, and no config paths. The code does make outbound network requests (to google.com for proxy tests and image.isu.pub for images), which is proportional to its stated proxy-detection and download purpose.
Persistence & Privilege
The skill does not request always: true and does not modify other skills or global agent settings. It writes outputs to a local 'downloads' directory only. It can be invoked autonomously by the agent (default), which is normal and expected for skills.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install issuu-downloader
  3. After installation, invoke the skill by name or use /issuu-downloader
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release: High-reliability Issuu PDF downloader (Professional Edition). - Implements anti-503 logic for bypassing temporary site blocks. - Features auto-proxy detection for common local proxy software (Clash/V2Ray). - Converts all pages to high-fidelity PDFs, preserving original quality. - Includes troubleshooting steps and proxy support for users in restricted regions.
Metadata
Slug issuu-downloader
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is issuu_downloader?

Download any public Issuu document as a high-quality PDF with automatic proxy detection and anti-blocking features for reliable access. It is an AI Agent Skill for Claude Code / OpenClaw, with 121 downloads so far.

How do I install issuu_downloader?

Run "/install issuu-downloader" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is issuu_downloader free?

Yes, issuu_downloader is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does issuu_downloader support?

issuu_downloader is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created issuu_downloader?

It is built and maintained by zykqyer (@zykqyer); the current version is v1.0.0.

💬 Comments