icon-retrieval

Q: How do I install icon-retrieval?

Run npx skills add https://github.com/antvis/chart-visualization-skills --skill icon-retrieval in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/icon-retrieval/ (personal) or .claude/skills/icon-retrieval/ (project).

by antvisBackend & APIs

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

Installs: 1.6K
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

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

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads icon-retrieval automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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

Determine the icon concept keyword (for example: security, document, data).
Search icon URLs using the API endpoint.
Use curl to fetch the SVG content of selected URLs.
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.

FAQ

What does the icon-retrieval skill do?

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

How do I install icon-retrieval?

Run npx skills add https://github.com/antvis/chart-visualization-skills --skill icon-retrieval in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/icon-retrieval/ (personal) or .claude/skills/icon-retrieval/ (project).

Which AI agents can use icon-retrieval?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is icon-retrieval safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains icon-retrieval?

It is published by antvis in antvis/chart-visualization-skills. It has 1,611 recorded installs.