/install favicondl
FaviconDL
通过命令行下载任意网站 favicon / Download favicon for any domain via CLI
简介 / Overview
FaviconDL 是一款基于 favicondl.com API 的命令行工具,可一键下载任意网站的高质量 favicon 图标。支持自定义尺寸、多种格式,并提供 PowerShell 与 Bash 双版本,零依赖即可使用。
FaviconDL is a lightweight CLI tool powered by favicondl.com API. Download high-quality favicon images for any domain in any supported size — no API key required.
功能 / Features
| 功能 Feature | 说明 Description |
|---|---|
| 多尺寸支持 Multi-size | 支持 16 / 32 / 48 / 64 / 128 / 256 / 512 px |
| 302 重定向 redirect | 自动跟随重定向,直接下载 PNG 文件 |
| 无依赖 Zero dependency | 仅需 curl(PowerShell 内置或系统自带) |
| 双端支持 Cross-platform | PowerShell (Windows) + Bash (Linux/macOS) |
| 批量下载 Batch | 支持多域名连续下载 |
安装 / Installation
Windows(PowerShell)
# 下载脚本到本地
curl -L -o "$env:USERPROFILE\favicondl.ps1" "https://raw.githubusercontent.com/sweesama/favicondl.com/main/favicondl.ps1"
# 添加到 PATH(可选)
# 将 $env:USERPROFILE 加入系统 PATH 环境变量
Linux / macOS(Bash)
curl -L -o ~/favicondl.sh "https://raw.githubusercontent.com/sweesama/favicondl.com/main/favicondl.sh"
chmod +x ~/favicondl.sh
sudo ln -s ~/favicondl.sh /usr/local/bin/favicondl
使用方法 / Usage
基本语法 / Syntax
# PowerShell
.\favicondl.ps1 -Domain \x3C域名> [-Size \x3C尺寸>] [-Output \x3C保存路径>]
# Bash
./favicondl.sh \x3C域名> [尺寸] [保存路径]
参数说明 / Parameters
| 参数 Parameter | 必填 Required | 默认值 Default | 说明 Description |
|---|---|---|---|
-Domain / \x3C域名> |
✅ | — | 目标网站域名,如 github.com |
-Size / [尺寸] |
❌ | 128 |
图片尺寸,可选 16/32/48/64/128/256/512 |
-Output / [路径] |
❌ | ./favicon.png |
保存文件路径 |
示例 / Examples
# 下载 GitHub 128px favicon(默认尺寸)
.\favicondl.ps1 -Domain "github.com"
# 下载 256px 大图
.\favicondl.ps1 -Domain "github.com" -Size 256
# 保存到指定路径
.\favicondl.ps1 -Domain "github.com" -Size 128 -Output "C:\icons\gh.png"
# 批量下载多个域名
.\favicondl.ps1 -Domain "github.com"
.\favicondl.ps1 -Domain "openai.com"
.\favicondl.ps1 -Domain "anthropic.com"
# 下载 GitHub favicon
./favicondl.sh github.com
# 下载 256px 版本
./favicondl.sh github.com 256
# 保存到指定路径
./favicondl.sh github.com 128 ./icons/gh.png
输出示例 / Output Example
Fetching favicon for github.com at 128px...
Saved: ./github_favicon.png (6518 bytes) ✅
API 详情 / API Details
本工具调用 favicondl.com 提供的免费 API,无需注册、无需 API Key。
Under the hood, this tool calls the free favicondl.com API — no registration, no API key required.
端点 / Endpoint
GET https://favicondl.com/api/favicon?domain={domain}&size={size}&format=redirect
参数 / Parameters
| 参数 | 类型 | 说明 |
|---|---|---|
domain |
string | 目标域名,如 github.com |
size |
integer | 图片像素尺寸,可选 16/32/48/64/128/256/512 |
format=redirect |
string | 返回 302 重定向到实际 PNG 文件 |
响应 / Response
- 状态码 Status:
302 Found - Location: 目标网站 favicon URL
- 最终内容: PNG 图片文件
适用场景 / Use Cases
| 场景 Scenario | 说明 Description |
|---|---|
| 🌍 GEO 外链提交 | 为目录站提交准备网站 logo |
| 🎨 设计素材采集 | 快速获取竞品或参考网站的图标资源 |
| 🔍 SEO / 书签 | 为书签页面、导航页批量获取网站图标 |
| 📱 App Icon 备选 | 快速预览主流网站的品牌图标设计 |
| 🤖 AI Agent 工作流 | 集成进自动化脚本,定向抓取网站图标 |
错误处理 / Error Handling
| 错误类型 Error | 原因 Cause | 解决方案 Solution |
|---|---|---|
HTTP 404 |
目标网站无 favicon | 换用 Google Favicon 备选方案 |
HTTP 5xx |
API 服务端异常 | 稍后重试或检查网络连接 |
| 文件写入失败 | 路径无权限或磁盘满 | 更换输出路径或以管理员运行 |
相关项目 / Related Projects
| 项目 Project | 地址 Link |
|---|---|
| 🌐 FaviconDL 官网 | https://favicondl.com |
| 📦 NPM 版本 | https://www.npmjs.com/package/favicondl |
| 💻 源码仓库 | https://github.com/sweesama/favicondl.com |
| 🐟 水产市场发布 | https://openclawmp.cc/asset/s-5a9fb4e7ff343062 |
更新日志 / Changelog
v1.0.0
- 首发版本 / Initial release
- 支持 PowerShell + Bash 双端
- 支持 7 种尺寸(16-512px)
- 302 重定向自动下载 PNG
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install favicondl - 安装完成后,直接呼叫该 Skill 的名称或使用
/favicondl触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Favicondl · 任意网站 Favicon 下载工具 是什么?
通过命令行下载任意网站 favicon,支持多种尺寸与格式,无依赖。Using favicondl.com API to download favicon for any domain via CLI. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 144 次。
如何安装 Favicondl · 任意网站 Favicon 下载工具?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install favicondl」即可一键安装,无需额外配置。
Favicondl · 任意网站 Favicon 下载工具 是免费的吗?
是的,Favicondl · 任意网站 Favicon 下载工具 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Favicondl · 任意网站 Favicon 下载工具 支持哪些平台?
Favicondl · 任意网站 Favicon 下载工具 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Favicondl · 任意网站 Favicon 下载工具?
由 sweesama(@sweesama)开发并维护,当前版本 v1.0.4。