WhatsLink

主页：https://whatslink.info/

当用户想在打开或下载前了解公开链接的大致内容时使用本 skill。它调用 whatslink.info 的公开 API，返回识别到的内容类型、文件名、文件数量、总大小，以及可能存在的截图 URL。

English note: this skill inspects public links through the WhatsLink metadata API. It is not a downloader.

隐私与安全

• 只查询公开、非敏感链接。
• 不要提交私密链接、签名 URL、含 token/API key/session ID 的 URL、内网/本机地址、公司内部资源、用户未明确允许提交给第三方服务的文档或链接。
• WhatsLink 是第三方公共服务；把 URL 发给它等于把该链接透露给外部服务。
• 截图可能包含敏感信息。默认人类可读输出只列出截图 URL，不会自动下载、打开、转发图片。
• 除非用户明确要求且你确认安全，否则不要下载或打开目标内容，也不要转发截图。
• 结果仅作参考；如果 API 返回未知或空结果，不要臆测文件内容。
• 服务可能有免费额度/反滥用限制；调用保持最小化，对外展示时注明来源。

API 形态

• Endpoint：GET https://whatslink.info/api/v1/link?url=\x3Cencoded-url>
• 请求参数：
  • url（必填 string）：要检查的公开链接。
• 常见响应字段：
  • error（string）：非空表示查询失败。
  • type（string）：链接内容类型。
  • file_type（string）：例如 unknown、folder、video、text、image、audio、archive、font、document。
  • name（string）：内容/资源名称。
  • size（number）：总字节数。
  • count（number）：包含文件数。
  • screenshots（array 或 null）：截图对象，常见字段为 time 和 screenshot URL。

CLI 辅助脚本

脚本使用 Python 3 标准库，无需额外依赖。

cd /root/.openclaw/workspace/skills/whatslink
python3 scripts/whatslink_query.py 'https://example.com/file.torrent'
python3 scripts/whatslink_query.py --json 'https://example.com/file.torrent'
python3 scripts/whatslink_query.py --no-screenshots 'https://example.com/file.torrent'
python3 scripts/whatslink_query.py --max-screenshots 3 'https://example.com/file.torrent'
python3 scripts/whatslink_query.py --timeout 10 --user-agent 'OpenClaw/whatslink' 'https://example.com/file.torrent'

参数：

• url：必填，要查询的公开 URL。
• --json：输出 WhatsLink 原始 JSON 响应；保持原始结构，不做摘要格式化。
• --no-screenshots：在人类可读摘要中隐藏截图 URL。
• --max-screenshots N：限制摘要中展示的截图 URL 数量；默认展示全部；0 表示不列出 URL。
• --timeout：请求超时时间，默认 20 秒。
• --endpoint：API endpoint，默认 https://whatslink.info/api/v1/link；主要用于测试或替代服务。
• --user-agent：可选自定义 User-Agent。默认 UA 版本为 OpenClaw-whatslink-skill/0.1.1。

推荐工作流

1. 先判断链接是否适合提交给第三方公共元数据服务：必须是公开、非敏感、无 token、非内网。
2. 使用 scripts/whatslink_query.py 获取稳定输出。
3. 默认向用户报告人类可读摘要；如果响应含截图，默认列出截图 URL，但不下载、不打开。
4. 用户只需要机器可读结果时使用 --json。
5. API 返回空/未知时，直接说明“未识别出有用元数据”，不要补脑。

示例

cd /root/.openclaw/workspace/skills/whatslink
python3 scripts/whatslink_query.py 'https://releases.ubuntu.com/24.04/ubuntu-24.04.2-desktop-amd64.iso.torrent'

摘要通常包含：

• 名称
• 类型
• 文件类型
• 大小（含原始 bytes）
• 文件数
• 截图数
• 截图 URL（如 WhatsLink 返回）

版本

• 0.1.1：默认人类可读摘要列出截图 URL；新增 --no-screenshots 和 --max-screenshots；中文文档与隐私说明增强；UA 更新到 0.1.1。