Extract Assets

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install extract-assets
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 extract-assets。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Extract Assets 通过调用 MiroMiro 的资源提取 API，帮助 AI 代理和开发者查找网站上的媒体。选择用于图片、内嵌和外部 SVG、视频、音频或 Lottie JSON 的端点；结果会包含已解析的 URL，并标注每项资源的发现位置。内嵌 SVG 标记会经过清理，可直接粘贴到项目中。
作为 Openclaw Skills 的一部分，此技能适用于设计研究、页面分析以及重建自己的界面。默认情况下，它会读取静态 HTML；也可选择在浏览器中渲染后重试，以查找由 JavaScript 添加的资源。提取资源并不意味着获得重新发布他人媒体的许可。

应用场景

在实时网站上查找照片、Open Graph 图片、网站图标、图标或矢量 Logo。
检查页面中的视频文件、音频源、播客附件或播放器嵌入内容。
获取 Lottie 动画 JSON，用于分析或在项目中使用。
收集资源，用于设计研究、参考或重建自己的界面。
当媒体可能由 JavaScript 注入时，针对结果较少的情况重试。
提高结果上限，或从资源丰富的页面中获取完整的内嵌 SVG 标记。

工作原理

确定用户需要的资源类型：图片、SVG、视频、音频或 Lottie。
调用匹配的 MiroMiro 工具，或使用对应的 REST 端点（/v1/images、/v1/svg、/v1/videos、/v1/audio 或 /v1/lottie），并提供目标页面 URL。
查看返回的已解析 URL 及其来源标签；对于视频和音频，请检查响应备注中的覆盖范围说明。
如果视频、音频或 Lottie 结果为空或异常简短，请使用 render: true 重试，让页面的 JavaScript 在真实浏览器中运行。这会额外消耗 5 个 credits。
使用 limit 请求更多结果，最多 200 项；或使用 full_output: true 获取内嵌 SVG 标记等完整长字符串。
将播放器页面作为嵌入内容展示，而不是可下载媒体；如果用户打算重新发布资源，请提示其考虑许可问题。

配置指南

在 Claude、ChatGPT、Cursor 或 Codex 等受支持的客户端中连接 MiroMiro 工具，或者通过 OpenClaw 等代理直接调用 REST API。将 API key 设置为 MIROMIRO_API_KEY；用户可在 https://miromiro.app/api/onboarding 免费获取密钥，每月包含 300 个 credits，且无需提供银行卡。若尚未配置，请向用户索取密钥，切勿编造密钥。
REST 请求示例：
curl -s "https://miromiro.app/api/v1/svg?url=github.com"
-H "Authorization: Bearer $MIROMIRO_API_KEY" 图片、SVG、视频和音频每次请求消耗 1 个 credit；Lottie 消耗 3 个 credits。浏览器渲染额外消耗 5 个 credits。

数据架构

API 接受页面 url，并返回已解析的资源 URL，同时标注资源的发现位置。请使用与所需媒体类型匹配的端点或已连接的工具：
Asset type Tool REST endpoint Notes
Images, photos, og:image, favicons extract_assets /v1/images 提取页面上发现的图片资源。
Inline SVGs and external SVG files extract_svgs /v1/svg 返回经过清理、可直接粘贴的内嵌标记，以及外部 .svg 引用。
Video files and player embeds extract_videos /v1/videos source: "embed" 表示这是播放器页面，而不是可下载文件。
Audio files and podcast enclosures extract_audio /v1/audio 查看响应中的 note，了解覆盖范围说明。
Lottie animation JSON extract_lottie /v1/lottie 运行时注入的动画可能需要浏览器渲染。
结果可能会被截短，以保护上下文窗口；响应会说明哪些内容已被删减。可选参数 limit 可将条目上限提高至 200，而 full_output: true 会返回完整的长字符串。此技能会说明返回结果和可用选项，但未指定本地文件或元数据的存储格式。

高级特性

感知 JavaScript 的提取：
当静态 HTML 中缺少动态媒体时，设置
render: true
，在真实浏览器中运行页面；这会额外消耗 5 个 credits。
提高结果上限：
用户需要从资源丰富的页面获取更完整的清单时，可将
limit
设为最高 200。
完整 SVG 输出：
内嵌标记被截短而无法使用时，设置
full_output: true
。
针对资源类型的工具：
为每种媒体类型选择专用工具或 REST 端点。
识别嵌入内容的视频报告：
区分播放器嵌入内容与可下载的视频文件。
透明说明 credits 用量：
按照已说明的费用计算：图片、SVG、视频或音频需 1 个 credit；Lottie 需 3 个 credits。
负责任地处理资源：
用户计划重新发布其他网站上的媒体时，请提醒其注意许可问题。

name: extract-assets description: Pull media off a live page - images, inline SVG icons and logos, videos, audio, or Lottie animation JSON. Use when the user asks to grab, download, recover, list, or find assets on a website. homepage: https://miromiro.app/api/docs