| name | iconfont-helper |
| description | Search iconfont.cn for public SVG icon candidates, save multiple results, and choose the best-looking asset for articles, slides, videos, demos, or HTML compositions. Use when the user needs Iconfont SVGs, visual symbols, lightweight illustration assets, or design-led icon selection. |
Iconfont Helper
Core Goal
Find useful SVG candidates from Iconfont without turning icon selection into a
random first-result pick. Start from the scene or design need, search broadly,
save several candidates, preview them, and choose the icon that looks best in the
final layout.
This skill is for public SVG asset discovery only. It does not manage Iconfont
projects, upload icons, sync account assets, or preserve any login state.
Workflow
- Translate the visual need into 2-4 search keywords. Use concrete nouns,
actions, objects, or metaphors instead of only the article title.
- Search Iconfont with the bundled helper and save multiple SVG candidates.
- Review the saved SVG files and
search-response.json.
- Choose by clarity, beauty, line weight, fill style, recognizability, and
whether it matches the surrounding design.
- Keep icon style consistent inside one deliverable. Avoid mixing thin line
icons, heavy filled icons, flat cute icons, and complex illustrations unless
the contrast is intentional.
- If Iconfont search fails or the candidates look poor, use another open icon
source, draw a simple SVG, or build the shape in HTML/CSS instead of forcing a
bad icon into the work.
Helper Command
python "skills/iconfont-helper/scripts/search_iconfont_svg.py" "keyword" --out "<PROJECT_FOLDER>/assets/iconfont" --limit 12 --all
Optional style filters:
python "skills/iconfont-helper/scripts/search_iconfont_svg.py" "keyword" --type line --out "<PROJECT_FOLDER>/assets/iconfont" --all
python "skills/iconfont-helper/scripts/search_iconfont_svg.py" "keyword" --type fill --out "<PROJECT_FOLDER>/assets/iconfont" --all
The helper calls:
https://www.iconfont.cn/api/icon/search.json
It reads each result's show_svg field and writes the SVG candidates locally.
By default it saves up to three SVGs; pass --all to save every returned SVG
candidate within the requested limit.
Login And Token Boundary
Some Iconfont requests may work without a token; some environments may require
a local ctoken. If needed, provide it only at runtime:
$env:ICONFONT_CTOKEN = "<LOCAL_TOKEN>"
python "skills/iconfont-helper/scripts/search_iconfont_svg.py" "keyword" --out "<PROJECT_FOLDER>/assets/iconfont" --all
Never commit ctoken, cookies, browser profiles, cache files, logs, sessions,
private project folders, or account-specific Iconfont data.
Validation Checklist
- Multiple SVG candidates were saved when the design needs selection.
search-response.json exists for traceability.- The selected SVG looks good in the actual layout, not just in isolation.
- No token, cookie, account data, local private path, cache, log, or session file
was committed.
- If the icon will be published, the usage fits the target project's licensing
and attribution requirements.
