searchOnlineAssets

English · 中文

Online asset search tool: queries public stock libraries (Pixabay) for high-quality photos, illustrations, vectors and videos, and returns result metadata + URLs for use in the current workflow.

Trigger Keywords

• searchOnlineAssets
• pixabay
• online asset search

Authentication

All requests require a dLazy API key, configured through the CLI:

dlazy auth set YOUR_API_KEY

The CLI saves the key in your user config directory (~/.dlazy/config.json on macOS/Linux, %USERPROFILE%\.dlazy\config.json on Windows), with file permissions restricted to your OS user account. You can also supply the key per-invocation via the DLAZY_API_KEY environment variable.

Getting Your API Key

1. Sign in or create an account at dlazy.com
2. Go to dlazy.com/dashboard/organization/api-key
3. Copy the key shown in the API Key section

Each key is scoped to your dLazy organization and can be rotated or revoked at any time from the same dashboard.

About & Provenance

• CLI source code: github.com/dlazyai/cli
• Maintainer: dlazyai
• npm package: @dlazy/cli (pinned to 1.0.8 in this skill's install spec)
• Homepage: dlazy.com

You can install on demand without persisting a global binary by running:

npx @dlazy/cli@1.0.9 <command>

Or, if you prefer a global install, the skill's metadata.clawdbot.install field declares the exact pinned version (npm install -g @dlazy/cli@1.0.9). Review the GitHub source before installing.

How It Works

This skill is a thin wrapper around the public Pixabay search API, exposed through the dLazy tool runtime. When you invoke it:

• The query and filter parameters you provide are forwarded to the Pixabay API.
• Pixabay returns a list of hits; the tool projects each entry to a stable shape (id, tags, preview / web-format / large URLs, dimensions).
• The skill itself does not access network or filesystem resources beyond the Pixabay HTTP request handled inside the dLazy tool runtime.

This is the standard SaaS pattern; the asset URLs returned are hosted by Pixabay (pixabay.com), not by dLazy. See dlazy.com for the full service terms.

Usage

CRITICAL INSTRUCTION FOR AGENT: Invoke the searchOnlineAssets tool with a structured input object. This is an internal AI tool, not a CLI command — it runs inside the model's tool-call channel.

Input schema:

{
  query: string;                                            // required search keyword(s); prefer English for better recall
  imageType?: "all" | "photo" | "illustration" | "vector";  // default: "all"
  orientation?: "all" | "horizontal" | "vertical";          // default: "all"
  page?: number;                                            // default: 1
  perPage?: number;                                         // default: 10 (max 200 per Pixabay)
  lang?: string;                                            // default: "zh"; pass "en" for English-tagged matches
}

Behaviour notes:

• safesearch is forced to true server-side; explicit content is filtered out.
• Pixabay performs best with English keywords. Translate user-provided Chinese terms (e.g., "咖啡 → coffee") before issuing the request when accuracy matters.
• Pick the most relevant largeImageURL (or matching video preview URL) and surface the URL plus tags to the user; do not dump the entire hits array.
• If total === 0, tell the user no matching asset was found and suggest a broader keyword.

Output Format

{
  "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
    }
  ]
}

Examples

// Find horizontal photos of cityscapes
searchOnlineAssets({
  query: 'cityscape skyline',
  imageType: 'photo',
  orientation: 'horizontal',
  perPage: 6,
})

// Find vector icons for nature
searchOnlineAssets({
  query: 'leaf nature icon',
  imageType: 'vector',
  perPage: 12,
})

Error Handling

Code	Error Type	Example Message
401	Unauthorized (No API Key)	Pixabay API key is not configured
502	Upstream API failed	Pixabay API error: <statusText>
503	Network / fetch failed	Failed to search images from Pixabay

AGENT CRITICAL INSTRUCTION:

1. If the tool throws Pixabay API key is not configured, the workspace is missing its Pixabay credentials — inform the user and stop; do not retry.
2. If Pixabay API error is returned, retry once with a simpler / shorter query before falling back to telling the user no result was found.

Tips

Visit https://dlazy.com for more information.