by 运行时依赖
安装命令
点击复制技能文档
search-online-assets 中文说明 在线素材搜索工具：向公共图库 Pixabay 查询高质量照片、插画、矢量图与视频，返回结果元数据 + URL 供当前工作流使用。
触发关键词 search-online-assets pixabay online asset search
认证 所有请求需 dLazy API key，通过 CLI 配置： dlazy auth set YOUR_API_KEY CLI 将密钥保存在用户配置目录（macOS/Linux：~/.dlazy/config.json，Windows：%USERPROFILE%\.dlazy\config.json），权限仅限当前用户。 也可通过环境变量 DLAZY_API_KEY 单次传入。
获取 API Key
- 在 dlazy.com 注册或登录
- 访问 dlazy.com/dashboard/organization/api-key
- 复制“API Key”字段
来源与维护 CLI 源码：github.com/dlazyai/cli 维护者：dlazyai npm 包：@dlazy/cli（本技能安装规范锁定 1.0.8） 主页：dlazy.com
安装方式 不持久化全局二进制： npx @dlazy/cli@1.0.9 或全局安装（技能 metadata.clawdbot.install 已锁定版本）： npm install -g @dlazy/cli@1.0.9 安装前请浏览 GitHub 源码。
工作原理 本技能是对 Pixabay 公开搜索 API 的轻量封装，运行在 dLazy 工具运行时内：
- 将用户提供的查询与过滤参数转发至 Pixabay API
- Pixabay 返回命中列表；工具将每条结果映射为统一结构（id、tags、preview/web-format/large URLs、尺寸）
- 技能本身不额外访问网络或文件系统，仅通过 dLazy 运行时完成 Pixabay HTTP 请求
用法（关键指令） AI 内部调用 search-online-assets 工具，需传入结构化对象： { query: string; // 必填，搜索关键词；英文召回更佳 imageType?: "all"|"photo"|"illustration"|"vector"; // 默认 all orientation?: "all"|"horizontal"|"vertical"; // 默认 all page?: number; // 默认 1 perPage?: number; // 默认 10（Pixabay 上限 200） lang?: string; // 默认 "zh"；需英文匹配可设 "en" }
行为说明
- 服务端强制 safesearch=true，已过滤敏感内容
- Pixabay 对英文关键词支持最佳；若用户输入中文（如“咖啡”），请先翻译为“coffee”再请求
- 仅向用户展示最相关 largeImageURL（或匹配的视频预览 URL）及 tags，勿输出完整 hits 数组
- 若 total === 0，告知用户未找到匹配素材，并建议放宽关键词
输出示例 { "total": 1234, "hits": [{ "id": 5179107, "tags": "coffee, cup, latte art", "previewURL": "https://cdn.pixabay.com/.../preview.jpg", "webformatURL": "https://pixabay.com/.../webformat.jpg", "largeImageURL": "https://pixabay.com/.../large.jpg", "imageWidth": 6000, "imageHeight": 4000 }] }
示例调用 // 搜索横向城市风光照片 search-online-assets({ query: 'cityscape skyline', imageType: 'photo', orientation: 'horizontal', perPage: 6, })
// 搜索自然主题矢量图标 search-online-assets({ query: 'leaf nature icon', imageType: 'vector', perPage: 12, })
错误处理 401 Unauthorized（无 API Key）→ 提示“Pixabay API key 未配置” 502 Upstream API failed → 提示“Pixabay API 错误：” 503 Network / fetch failed → 提示“无法从 Pixabay 搜索图片”
AI 关键指令
- 若返回“Pixabay API key 未配置”，停止并告知用户配置密钥，勿重试
- 若返回 Pixabay API 错误，先简化/缩短查询重试一次，仍失败则告知无结果
更多信息请访问 https://dlazy.com