为什么选择 GetFavicon?

轻量、快速、可靠的 Favicon 获取方案,为开发者而生。

极速响应

智能缓存机制 + 多重获取策略,毫秒级返回结果,保证API响应速度。

全平台兼容

支持所有主流网站。智能解析HTML Link标签、自动尝试根目录favicon.ico、处理302/301重定向。

多种调用方式

支持伪静态美化URL和传统Query String两种调用方式,适配各类场景,CDN缓存友好。

30天智能缓存

高效的文件级缓存策略,相同域名只请求一次。支持通过 refresh 参数强制刷新缓存。

完全免费

无需注册、无需API Key、无调用次数限制。开源项目,MIT许可证,自由使用。

开发者友好

返回标准 icon 格式,正确设置 Content-Type 和缓存头。可直接用于 img 标签、meta 标签等场景。

API 调用文档

两种调用方式,简单灵活,即刻集成到你的项目中。

推荐

方式一:伪静态(推荐)

CDN 友好的美化 URL 调用方式:

URL 格式
https://favicon.hubopenai.com/favicon/{域名}.png

示例:

/favicon/www.baidu.com.png
/favicon/github.com.png

方式二:Query String

传统 GET 参数方式,适合动态拼凑URL的场景:

URL 格式
https://favicon.hubopenai.com/favicon/get.php?url={完整URL}

示例:

/favicon/get.php?url=https://www.baidu.com

可用参数

参数 类型 必填 说明
url string 目标网站URL,需包含 http(s):// 前缀(伪静态方式不需要)
refresh string 设为 true 强制刷新缓存
AI 原生集成

MCP 接入指南

通过 Model Context Protocol 将 GetFavicon 集成到 Cursor、Claude 等 AI 工具中。

1 什么是 MCP?

MCP(Model Context Protocol) 是 AI 模型与外部工具之间的标准通信协议。 通过 MCP,你可以在 Cursor IDEClaude Desktop 等 AI 应用中, 让 AI 助手直接调用 GetFavicon API 获取网站图标,无需手动复制粘贴 URL。

2 快速接入(3步)

创建 MCP 配置文件

在 Cursor 项目根目录创建 .cursor/mcp.json

粘贴下方配置

复制下面的 JSON 配置到 mcp.json 文件中

重启 AI 工具并开始使用

重启 Cursor/Claude,即可在对话中让 AI 调用 get_favicon 工具

复制即用

MCP 配置 (mcp.json)

放置于项目根目录的 .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}}"]
    }
  }
}

3 MCP Tool 描述符(完整版)

如果你要部署一个独立的 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"
  }
}

4 使用示例

配置完成后,在 Cursor/Claude 中直接对 AI 说:

获取 GitHub 的 favicon

帮我获取 github.com 的网站图标

批量获取多个网站

帮我获取百度、谷歌、知乎这三个网站的 favicon

强制刷新缓存

刷新 www.bilibili.com 的 favicon 缓存

MCP 配置生成器

填写下方表单,自动生成你的 MCP 配置文件内容。

自动化工作流

Skills 技能集成

创建自定义 AI 技能,让 Cursor 在特定场景下自动调用 GetFavicon API。

Cursor

创建 Cursor Skill

在项目 .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

Claude Desktop 集成

在 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。

Dashboard 面板

构建网站监控面板,可视化展示各站点的 favicon 和状态。

开发者接入

开发接入文档

多语言代码示例,快速集成到你的项目中。

JS JavaScript (Fetch API)

// 方式一:伪静态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 属性。浏览器会自动处理缓存,不需要额外代码。

<img src="https://favicon.hubopenai.com/favicon/github.com.png" alt="GitHub">

合理利用缓存

API 默认缓存 30 天。频繁请求同一域名不会产生额外开销。仅在需要强制刷新时使用 refresh=true 参数,避免滥用导致源站频繁请求。

CDN 友好

伪静态 URL 格式(/favicon/{域名}.png)天然支持 CDN 缓存。如果你使用 CloudFlare、阿里云 CDN 等,直接配置即可获得全球加速。建议 CDN 缓存时间设为 7 天。

错误处理

如果目标网站无法访问或没有 favicon,API 会返回默认图标(favicon.png)。建议在你的项目中设置 onerror 回退方案:

<img src="..." onerror="this.src='/default-icon.svg'">

使用限制

目前 API 没有硬性的调用频率限制,但请合理使用。建议在客户端做本地二次缓存(LocalStorage / Service Worker / 文件缓存),减少不必要的重复请求。

在线演示

输入任意网站URL,即时查看Favicon获取效果。

快速尝试:

常见问题

关于 GetFavicon API 的常见疑问解答。

是否需要注册或获取API Key?
完全不需要。GetFavicon API 是一个完全免费的开源服务,无需注册账号,无需申请 API Key,无调用次数限制。直接按照文档中的URL格式调用即可。
缓存多久?如何刷新?
默认缓存时间为 30天(2592000秒)。如果返回的是默认图标,缓存时间自动缩短为 12小时

如需强制刷新缓存,可以在URL末尾添加 ?refresh=true 参数,或者直接删除 favicon/cache/ 目录下的缓存文件。
支持哪些网站?有没有不支持的?
GetFavicon 使用多重策略获取图标:
  1. 先从内置静态映射表中查找
  2. 解析HTML中 <link rel="icon"> 标签
  3. 尝试网站根目录的 /favicon.ico
  4. 处理301/302重定向
绝大多数主流网站都支持。如果某网站获取失败,可以尝试稍后再试或查看是否被对方服务器屏蔽。
两种URL格式有什么区别?该用哪种?
伪静态格式(推荐):/favicon/{域名}.png — 更简洁、CDN缓存更友好,适合前端直接使用。域名不要带 http(s)://。

Query String格式/favicon/get.php?url={完整URL} — 更灵活,适合后端动态拼接URL的场景。URL需要包含协议前缀。
返回的图标格式是什么?
API 会直接返回图标的二进制数据,Content-Type 根据源图标格式自动设置(image/x-iconimage/pngimage/svg+xml 等)。可以直接作为 <img src> 的值使用。

准备好开始了吗?

无需注册,无需API Key,现在就试试获取你第一个网站的Favicon图标。

立即体验
开发者工具推荐

Cursor AI 编码,效率翻倍

Cursor 是深度集成 AI 的新一代编程编辑器,基于 VS Code 内核,内置 GPT-5Claude 等顶级模型。支持 Tab 智能补全、多文件批量编辑、一键 Bug 修复,让开发者从重复劳动中解放出来。

全能代码补全

Tab 一键接受整段代码,上下文感知,语义级精准补全。

跨文件联动编辑

一次对话同时修改多个文件,重构、迁移一步完成。

智能调试修复

自动检测 Bug、生成修复方案,告别长时间逐行排错。

MCP 原生集成

Cursor 原生支持 MCP 协议,轻松接入本 API 实现 AI 自动获取图标。

这也是我们日常使用的开发工具

让你的开发工作流焕然一新

无论你是在使用 GetFavicon API 构建前端应用,还是在开发后端服务、编写自动化脚本,Cursor 都能帮你用自然语言描述需求,自动生成高质量代码。就像有个高级工程师坐在你身边。

告别重复编码
AI 自动处理 CRUD、接口对接
零学习曲线
VS Code 界面,插件生态完全兼容
免费版可体验
无需信用卡即可试用,重度开发建议 Pro
首月 5 折
Pro / Pro+ / Ultra 套餐均享半价优惠
通过本站专属链接注册 Cursor,结账时自动应用折扣,仅限新用户
免费试用 Cursor

免费下载 · VS Code 扩展全兼容 · 支持 Mac / Windows / Linux