Icon Retrieval
Fetch SVG icon URLs and raw markup via HTTP when building dashboards, infographics, or UI mockups without hand-picking assets.
Overview
Icon retrieval is an agent skill for the Build phase that searches an HTTP icon API by keyword and retrieves SVG content with curl for use in pages and diagrams.
Install
npx skills add https://github.com/antvis/chart-visualization-skills --skill icon-retrievalWhat is this skill?
- GET search on Weavefox lab icon API with text and optional topK (1–20, default 5)
- Returns success flag plus array of direct SVG URLs for each keyword
- Two-step workflow: search URLs then curl each SVG for inline use
- Documents URL encoding, 20s curl timeouts, and retry guidance on network failures
- topK range 1–20 with default 5
- 20 second curl max-time on search and SVG fetch
Adoption & trust: 934 installs on skills.sh; 337 GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You need matching SVG icons for a chart or page but do not have a local asset library or want the agent to resolve keywords programmatically.
Who is it for?
Solo builders adding icons to dashboards, slide-style infographics, or marketing UI during active frontend work.
Skip if: Teams that require licensed icon packs, raster-only assets, or offline-only design workflows without outbound HTTP.
When should I use this skill?
You need icon concepts resolved to SVG via the documented GET search endpoint and curl fetches.
What do I get? / Deliverables
You get a short list of icon URLs and fetched SVG strings ready to embed in UI, infographics, or documentation.
- List of icon URLs from API JSON
- Raw SVG strings from selected URLs
Recommended Skills
Journey fit
How it compares
Use instead of hard-coding icon font class names when you need one-off SVG fetches from a search API.
Common Questions / FAQ
Who is icon retrieval for?
Indie and solo builders wiring Claude Code, Cursor, or Codex into visual build tasks who want API-driven SVG icons rather than manual asset hunting.
When should I use icon retrieval?
During Build—especially frontend and diagram work—when you need keywords like security or document turned into fetchable SVG markup before shipping a page or chart.
Is icon retrieval safe to install?
Review the Security Audits panel on this Prism page before enabling network and shell access; the skill calls an external HTTP API and uses curl against returned URLs.
SKILL.md
READMESKILL.md - Icon Retrieval
# 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: ```bash curl -sS -L --max-time 20 "https://lab.weavefox.cn/api/v1/infographic/icon?text=document&topK=5" ``` Typical response: ```json { "success": true, "data": [ "https://example.com/icon1.svg", "https://example.com/icon2.svg" ] } ``` ### Retrieve SVG Content ```bash 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.