WhatsLink URL Metadata Inspector for Openclaw

A utility skill to inspect and extract metadata from public download links, torrents, and magnets via the WhatsLink API.

violin321
v0.1.1
Jun 9, 2026
0
430
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install whatslink

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install whatslink using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is WhatsLink URL Metadata Inspector?

The whatslink skill is designed to inspect public links, torrents, and magnet links safely prior to downloading or opening them. By accessing the public WhatsLink metadata API, this tool extracts essential information such as content types, file counts, sizes, names, and even screenshot URLs. This enables users and agents to safely analyze external assets without risking malicious downloads or wasting bandwidth on massive files.

As an essential part of the Openclaw Skills repository, this skill provides a secure boundary for AI agents by emphasizing strict privacy protocols—only public, non-sensitive links are processed, and target files or screenshots are never automatically downloaded. This makes it an invaluable addition to any AI agent workflow focused on search, validation, or content moderation.

WhatsLink URL Metadata Inspector Use Cases

  • Safely inspecting the contents of public torrent or magnet links before downloading.
  • Verifying file types and sizes of shared URLs in developer or communication channels.
  • Automated link verification and metadata indexing within AI-driven curation pipelines.
  • Inspecting structural file trees of public folder links without initiating a browser session.

How WhatsLink URL Metadata Inspector Works

  1. The AI agent evaluates the URL to ensure it is public, non-sensitive, and free of authentication tokens.
  2. The agent executes the Python script wrapper scripts/whatslink_query.py with the targeted URL.
  3. The script sends an API request to the WhatsLink metadata endpoint https://whatslink.info/api/v1/link.
  4. The API returns a JSON response containing metadata (e.g., file count, size, type, screenshot URLs).
  5. The agent parses the response and presents a clean, human-readable summary to the user, omitting auto-downloads for maximum security.

WhatsLink URL Metadata Inspector Setup

Navigate to your local Openclaw workspace directory to locate the whatslink skill:

cd /root/.openclaw/workspace/skills/whatslink

The skill relies on Python 3 standard library modules, meaning no external dependencies or pip installations are required.

To run a test query on a public torrent file, use the script as follows:

python3 scripts/whatslink_query.py 'https://releases.ubuntu.com/24.04/ubuntu-24.04.2-desktop-amd64.iso.torrent'

To output raw JSON instead of human-readable text, append the --json flag:

python3 scripts/whatslink_query.py --json 'https://releases.ubuntu.com/24.04/ubuntu-24.04.2-desktop-amd64.iso.torrent'

WhatsLink URL Metadata Inspector Data Schema & Taxonomy

The skill formats responses extracted from the API endpoint. Below is the structural schema returned by the metadata service:

Field Type Description
error String Error message if the query fails; null otherwise.
type String Broad classification of the link content.
file_type String Specific format classification (e.g., folder, video, text, archive, document).
name String Name of the file, folder, or resource container.
size Number Total size of the resource in bytes.
count Number Total number of nested files inside the torrent or package.
screenshots Array List of available timestamps and screenshot URLs.

WhatsLink URL Metadata Inspector Advanced Features

  • Configurable Screenshot Limits: Hide or restrict the number of screenshots displayed in reports using --no-screenshots or --max-screenshots N to ensure strict content safety.
  • JSON Output Mode: Access raw structural payload directly with the --json flag, making it trivial to pipe metadata into subsequent automation pipelines.
  • Timeout and UA Customization: Fine-tune API request behavior with custom timeout rules and custom User-Agent headers to comply with API resource management policies.
  • Native Openclaw Skills Integration: Designed to support multi-agent orchestrations where trust boundaries dictate that link verification must happen offsite prior to downloading.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*