# Icon Retrieval

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

- Skill: `antvis/icon-retrieval` (Agent Skill)
- Install (CLI): `npx skillmds@latest add antvis/icon-retrieval`
- Raw SKILL.md: https://api.skillmd.com/api/skills/antvis/icon-retrieval/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: antvis (https://skillmd.com/u/antvis)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/antvis/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.