GetFavicon API 让你轻松获取任何网站的 Favicon 图标。 支持多种调用方式,自动缓存30天,稳定可靠的开发者工具。
支持所有主流网站 · 自动缓存 · 响应式格式
轻量、快速、可靠的 Favicon 获取方案,为开发者而生。
智能缓存机制 + 多重获取策略,毫秒级返回结果,保证API响应速度。
支持所有主流网站。智能解析HTML Link标签、自动尝试根目录favicon.ico、处理302/301重定向。
支持伪静态美化URL和传统Query String两种调用方式,适配各类场景,CDN缓存友好。
高效的文件级缓存策略,相同域名只请求一次。支持通过 refresh 参数强制刷新缓存。
无需注册、无需API Key、无调用次数限制。开源项目,MIT许可证,自由使用。
返回标准 icon 格式,正确设置 Content-Type 和缓存头。可直接用于 img 标签、meta 标签等场景。
两种调用方式,简单灵活,即刻集成到你的项目中。
CDN 友好的美化 URL 调用方式:
https://favicon.hubopenai.com/favicon/{域名}.png
示例:
传统 GET 参数方式,适合动态拼凑URL的场景:
https://favicon.hubopenai.com/favicon/get.php?url={完整URL}
示例:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| url | string | 是 | 目标网站URL,需包含 http(s):// 前缀(伪静态方式不需要) |
| refresh | string | 否 | 设为 true 强制刷新缓存 |
通过 Model Context Protocol 将 GetFavicon 集成到 Cursor、Claude 等 AI 工具中。
MCP(Model Context Protocol) 是 AI 模型与外部工具之间的标准通信协议。 通过 MCP,你可以在 Cursor IDE、Claude Desktop 等 AI 应用中, 让 AI 助手直接调用 GetFavicon API 获取网站图标,无需手动复制粘贴 URL。
创建 MCP 配置文件
在 Cursor 项目根目录创建 .cursor/mcp.json
粘贴下方配置
复制下面的 JSON 配置到 mcp.json 文件中
重启 AI 工具并开始使用
重启 Cursor/Claude,即可在对话中让 AI 调用 get_favicon 工具
放置于项目根目录的 .cursor/mcp.json
{
"mcpServers": {
"getfavicon": {
// 方式一:使用 fetch 直接调用 (推荐,零依赖)
"url": "https://favicon.hubopenai.com/favicon/get.php?url={{url}}",
// 方式二:使用本地 HTTP 工具包装
"command": "curl",
"args": ["-s", "-L", "https://favicon.hubopenai.com/favicon/get.php?url={{url}}"]
}
}
}
如果你要部署一个独立的 MCP 服务器,使用以下标准 Tool Descriptor:
{
"name": "get_favicon",
"description": "获取任意网站的Favicon图标。返回图标的URL及元数据。",
"inputSchema": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "目标网站URL,如 https://github.com"
},
"refresh": {
"type": "boolean",
"description": "设为true强制刷新缓存,默认false",
"default": false
}
},
"required": ["url"]
},
"endpoint": "https://favicon.hubopenai.com/favicon/get.php",
"method": "GET",
"returns": {
"type": "image",
"contentType": "image/x-icon | image/png | image/svg+xml"
}
}
配置完成后,在 Cursor/Claude 中直接对 AI 说:
获取 GitHub 的 favicon
帮我获取 github.com 的网站图标
批量获取多个网站
帮我获取百度、谷歌、知乎这三个网站的 favicon
强制刷新缓存
刷新 www.bilibili.com 的 favicon 缓存
填写下方表单,自动生成你的 MCP 配置文件内容。
创建自定义 AI 技能,让 Cursor 在特定场景下自动调用 GetFavicon API。
在项目 .cursor/skills/ 目录下创建 Skill 文件:
推荐目录结构:
.cursor/
└── skills/
└── get-favicon/
├── SKILL.md # 技能说明
└── skill.js # 技能执行脚本(可选)
SKILL.md 示例内容:
# GetFavicon Skill
## 触发条件
当用户请求获取网站图标、favicon、网站 logo 时触发。
## 使用方式
直接调用 GetFavicon API 获取图标:
GET https://favicon.hubopenai.com/favicon/{域名}.png
## 示例
- 用户: "获取百度图标" → 调用 /favicon/www.baidu.com.png
- 用户: "显示 GitHub 的 logo" → 调用 /favicon/github.com.png
## 缓存说明
默认缓存30天。如需刷新加 ?refresh=true 参数。
## 输出格式
返回图标二进制数据,可直接嵌入 HTML: <img src="API地址">
或者添加到 Cursor Rules(更简洁):
# .cursor/rules/favicon.md
当用户需要获取或显示网站图标/favicon时,
始终使用 GetFavicon API:
https://favicon.hubopenai.com/favicon/{域名}.png
例如 github.com 的图标:
https://favicon.hubopenai.com/favicon/github.com.png
在 Claude Desktop 的配置文件中添加 MCP Server:
// ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"getfavicon": {
"command": "npx",
"args": [
"-y",
"@anthropic/create-mcp-server",
"--name", "getfavicon",
"--endpoint", "https://favicon.hubopenai.com/favicon/get.php"
]
}
}
}
生成技术文档时,AI 自动拉取目标网站的 favicon 作为链接图标。
整理书签/导航站时,AI 批量生成带图标的链接卡片。
构建友情链接页时,自动获取所有友链网站的 favicon。
构建网站监控面板,可视化展示各站点的 favicon 和状态。
多语言代码示例,快速集成到你的项目中。
// 方式一:伪静态URL(推荐)
const domain = 'github.com';
const faviconUrl = `https://favicon.hubopenai.com/favicon/${domain}.png`;
// 直接用于 img 标签
const img = document.createElement('img');
img.src = faviconUrl;
img.alt = `${domain} favicon`;
document.body.appendChild(img);
// 方式二:Query String URL
const queryUrl = 'https://favicon.hubopenai.com/favicon/get.php?url=https://github.com';
// async/await 获取
async function getFavicon(url) {
const apiUrl = `https://favicon.hubopenai.com/favicon/${url}.png`;
const response = await fetch(apiUrl);
if (response.ok) {
const blob = await response.blob();
return URL.createObjectURL(blob);
}
throw new Error('获取失败');
}
充分运用 GetFavicon API 的一些实用建议。
在 HTML 中直接使用伪静态 URL 作为 <img> 的 src 属性。浏览器会自动处理缓存,不需要额外代码。
API 默认缓存 30 天。频繁请求同一域名不会产生额外开销。仅在需要强制刷新时使用 refresh=true 参数,避免滥用导致源站频繁请求。
伪静态 URL 格式(/favicon/{域名}.png)天然支持 CDN 缓存。如果你使用 CloudFlare、阿里云 CDN 等,直接配置即可获得全球加速。建议 CDN 缓存时间设为 7 天。
如果目标网站无法访问或没有 favicon,API 会返回默认图标(favicon.png)。建议在你的项目中设置 onerror 回退方案:
目前 API 没有硬性的调用频率限制,但请合理使用。建议在客户端做本地二次缓存(LocalStorage / Service Worker / 文件缓存),减少不必要的重复请求。
输入任意网站URL,即时查看Favicon获取效果。
快速尝试:
网站
HTTP状态
--
文件大小
--
内容类型
--
获取失败
关于 GetFavicon API 的常见疑问解答。
?refresh=true 参数,或者直接删除 favicon/cache/ 目录下的缓存文件。
<link rel="icon"> 标签/favicon.ico/favicon/{域名}.png — 更简洁、CDN缓存更友好,适合前端直接使用。域名不要带 http(s)://。/favicon/get.php?url={完整URL} — 更灵活,适合后端动态拼接URL的场景。URL需要包含协议前缀。
image/x-icon、image/png、image/svg+xml 等)。可以直接作为 <img src> 的值使用。
Cursor 是深度集成 AI 的新一代编程编辑器,基于 VS Code 内核,内置 GPT-5 和 Claude 等顶级模型。支持 Tab 智能补全、多文件批量编辑、一键 Bug 修复,让开发者从重复劳动中解放出来。
Tab 一键接受整段代码,上下文感知,语义级精准补全。
一次对话同时修改多个文件,重构、迁移一步完成。
自动检测 Bug、生成修复方案,告别长时间逐行排错。
Cursor 原生支持 MCP 协议,轻松接入本 API 实现 AI 自动获取图标。
无论你是在使用 GetFavicon API 构建前端应用,还是在开发后端服务、编写自动化脚本,Cursor 都能帮你用自然语言描述需求,自动生成高质量代码。就像有个高级工程师坐在你身边。
免费下载 · VS Code 扩展全兼容 · 支持 Mac / Windows / Linux