← Back to Skills Marketplace
jingyuan9527

Wallhaven Downloader

by jingyuan · GitHub ↗ · v0.1.3
cross-platform ✓ Security Clean
367
Downloads
1
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install wallhaven-downloader
Description
Download wallpapers in batch from wallhaven.cc via API v1 with flexible query parameters (q, categories, purity, sorting, order, topRange, atleast, resolutio...
Usage Guidance
This skill appears to do exactly what it claims. Before installing, confirm you trust the publisher and accept that the script will: (1) make network requests to wallhaven.cc and w.wallhaven.cc, (2) spawn curl processes, and (3) write image files and manifest.json to the output directory you provide. Do not pass secrets other than your Wallhaven API key, and avoid using a key if you do not want to retrieve NSFW/private content. Because the script runs locally and is included in the package, you can inspect the provided scripts (they are included) before running. If you want extra assurance, run the script in an isolated environment or review the subprocess usage (it calls curl via a safe list-style invocation, not shell execution).
Capability Analysis
Type: OpenClaw Skill Name: wallhaven-downloader Version: 0.1.3 The skill is designed to download wallpapers from Wallhaven.cc and demonstrates strong security awareness. The `scripts/wallhaven_download.py` file includes robust validation functions (`validate_base_url`, `validate_image_url`, `_is_private_or_local_host`) to prevent Server-Side Request Forgery (SSRF) by strictly enforcing HTTPS and restricting all network requests to `wallhaven.cc` or `w.wallhaven.cc` hosts, explicitly rejecting private/local IP addresses. It uses `subprocess.run` with a list of arguments for `curl`, mitigating shell injection risks. There is no evidence of data exfiltration, persistence, or malicious prompt injection in `SKILL.md`.
Capability Assessment
Purpose & Capability
Name/description match required env var and behavior: the script downloads wallpapers from wallhaven.cc using the Wallhaven API and optionally an API key for NSFW/private results. No unrelated credentials, binaries, or config paths are requested.
Instruction Scope
SKILL.md and the script stay within the stated purpose: they build API queries, paginate, validate image URLs, download images, and write a manifest. The instructions do not tell the agent to read other files or exfiltrate unrelated data. The script validates hosts and blocks non-HTTPS and private/local addresses.
Install Mechanism
There is no install spec (instruction-only skill) and the included Python script is self-contained. The script uses subprocess calls to curl to perform HTTP requests rather than embedding an HTTP library; this is normal and proportionate for the task.
Credentials
Only WALLHAVEN_API_KEY is declared/used, which is appropriate because the API key is required for NSFW/private queries. The SKILL.md warns against hardcoding keys and the script reads the key only from the --apikey parameter or WALLHAVEN_API_KEY.
Persistence & Privilege
always is false and the skill does not request persistent system privileges or modify other skills. It writes output only to the user-specified output directory and a manifest there.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install wallhaven-downloader
  3. After installation, invoke the skill by name or use /wallhaven-downloader
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.3
Security hardening: enforce host allowlist (wallhaven API + image CDN), require HTTPS, block local/private address targets, keep API key redacted in manifest.
v0.1.2
Metadata alignment fix: declare WALLHAVEN_API_KEY under clawdbot.requires.env to match scanner expectations.
v0.1.1
Security/metadata fix: redact apikey in manifest, declare curl/python3 command dependency and WALLHAVEN_API_KEY env usage.
v0.1.0
Initial release: batch wallhaven downloads with pagination, flexible API params, and --search-url parsing.
Metadata
Slug wallhaven-downloader
Version 0.1.3
License
All-time Installs 0
Active Installs 0
Total Versions 4
Frequently Asked Questions

What is Wallhaven Downloader?

Download wallpapers in batch from wallhaven.cc via API v1 with flexible query parameters (q, categories, purity, sorting, order, topRange, atleast, resolutio... It is an AI Agent Skill for Claude Code / OpenClaw, with 367 downloads so far.

How do I install Wallhaven Downloader?

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

Is Wallhaven Downloader free?

Yes, Wallhaven Downloader is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Wallhaven Downloader support?

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

Who created Wallhaven Downloader?

It is built and maintained by jingyuan (@jingyuan9527); the current version is v0.1.3.

💬 Comments