mcpField
I
icon-retrieval

icon-retrieval

github.com/antvisDesign & UI5161.6k installsUpdated 5w ago
Repository

About icon-retrieval

icon-retrieval is a skill for finding icons through an HTTP search API and retrieving their SVG files with curl. It describes a short workflow from keyword selection to using the chosen SVG in visual materials.

Key features

  1. 01Search icons by keyword
  2. 02Set the result count with topK
  3. 03Fetch SVG content with curl
  4. 04Use SVGs in pages and diagrams

Use cases

  1. 01Find a document icon for a page
  2. 02Retrieve an icon for a diagram
  3. 03Collect SVGs for infographic materials

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/antvis/chart-visualization-skills --skill icon-retrieval

After installing, type/icon-retrievalin Claude Code to confirm it loaded.

Details

From the project README

Icon Search

Use the icon HTTP API directly with curl.

API

Search Endpoint
  • Method: GET
  • URL: https://www.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://www.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.

Comments

Markdown supported