OpenParable
Skip to content
← Back to skills

Icon Retrieval

Design
icon-retrieval

Icon Retrieval is an Agent Skill for design published in the antvis/chart-visualization-skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Search icons through HTTP API and retrieve SVG strings with curl.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/antvis/chart-visualization-skills/blob/HEAD/skills/icon-retrieval/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/icon-retrieval, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Icon Search

Use the icon HTTP API directly with curl.

API

Search Endpoint

  • Method: GET
  • URL: https://lab.weavefox.cn/api/v1/infographic/icon
  • Query params:
    • text (required): search keyword, e.g. "data analysis"
    • topK (optional): number of icons to fetch (1-20), default 5

Example:

curl -sS -L --max-time 20 "https://lab.weavefox.cn/api/v1/infographic/icon?text=document&topK=5"

Typical response:

{
  "success": true,
  "data": [
    "https://example.com/icon1.svg",
    "https://example.com/icon2.svg"
  ]
}

Retrieve SVG Content

curl -sS -L --max-time 20 "https://example.com/icon1.svg"

Workflow

  1. Determine the icon concept keyword (for example: security, document, data).
  2. Search icon URLs using the API endpoint.
  3. Use curl to fetch the SVG content of selected URLs.
  4. Use SVG directly in pages, diagrams, or infographic materials.

Notes

  • Use URL encoding for special characters in text.
  • topK range is 1–20; if omitted, the service returns up to 5 results.
  • For network issues, retry with a smaller topK or verify endpoint accessibility.