Baby Favicon Tool

工具说明

Baby Favicon Tool 是一个轻量级的网站图标（favicon）抓取与代理服务。输入域名或完整 URL，即可自动解析页面中的 favicon 链接，并按需返回 JSON 数据、图片二进制或 302 跳转。

适用于书签管理、导航站、RSS 阅读器等需要在列表中展示站点图标的场景；/api/get 可直接作为 <img src="..."> 的图片地址使用，无需客户端再处理重定向。

↑ 通过 /api/get 直出

累计查询次数：—

接口说明

1. 获取 favicon 列表（JSON）

GET /api/get_favicon?url={domain_or_url}

返回该站点解析到的全部 favicon 条目，包含 url、width、height、format。列表按尺寸/优先级排序，第一项通常为最佳图标。

[
  {
    "format": "png",
    "height": 300,
    "url": "https://oba.by/wp-content/uploads/2020/09/icon-500-300x300.png",
    "width": 300
  },
  {
    "format": "ico",
    "height": 0,
    "url": "https://oba.by/favicon.ico",
    "width": 0
  }
]

2. 图片直出（推荐）

GET /api/get?url={domain_or_url}

直接返回 favicon 图片二进制（如 image/png），行为类似 https://ico.n3v.cn/get.php?url=...。命中本地缓存时无需再次下载源站图片。

若站点无 favicon 或下载失败，返回默认图标。

3. 302 重定向到 favicon URL

GET /api/redirect_favicon?url={domain_or_url}

302 跳转到解析到的第一个 favicon 地址；无结果时跳转到默认图标 URL。

参数说明

• url：必填。可传域名（如 oba.by）或完整 URL（如 https://h4ck.org.cn）；不带协议时默认补全为 http://。
• 无效 URL（不含 .）返回 invalid url。

缓存机制

Redis 元数据缓存：favicon 解析结果（URL 列表）缓存 24 小时（86400 秒），减少重复解析 HTML。

本地图片缓存：/api/get 下载的图片按域名 MD5 保存在项目 cache/ 目录，30 天有效。

服务依赖 Redis，启动前请确保 Redis 已运行（默认 localhost:6379，db=1）。

安装与启动

pip install -r requitement.pip
apt install redis-server   # 或 macOS: brew install redis
./start.sh                 # gunicorn 监听 0.0.0.0:19999

开发模式可直接运行 python app.py，默认同样监听 0.0.0.0:19999。