FaviconDL

Mzu favicondl - 即时网站图标获取器

**https://favicondl.com** — 免费、快速、零成本的网站图标工具

输入网址/域名 → 抓取并下载 favicon，也可当作网站 logo 图标使用。附带图片转 favicon 工具、SEO 博客自动发布系统，支持 5 种语言。

🌟 功能特点

主页 - Favicon Extractor / Downloader

• ✅ 输入任意域名/网址，即时预览网站图标
• ✅ 支持 16 到 512 像素的尺寸偏好
• ✅ 一键复制 Direct URL 与 HTML 代码片段
• ✅ 支持图片下载、JSON 元数据和 302 重定向模式
• ✅ 对强保护站点支持安全的候选图标与代理兜底
• ✅ 默认启用 Cloudflare Worker：HTML、SVG、manifest、Apple Touch Icon 多级发现

工具页面 - 图片转 Favicon

• ✅ 拖拽上传图片（支持 PNG、JPG、SVG、GIF、WebP）
• ✅ 自动生成多种标准尺寸（16×16 ~ 512×512）
• ✅ ZIP 打包下载（包含所有尺寸 + manifest.json + HTML 代码）
• ✅ 单个尺寸独立下载
• ✅ 批量获取多网站 Favicon（最多 100 个域名）
• ✅ PNG / JPG / ICO 格式互转 + 自定义尺寸

🌐 多语言支持（i18n）

• ✅ 5 种语言：English、中文、日本語、한국어、Español
• ✅ URL 路径路由（/zh/、/ja/、/ko/、/es/）
• ✅ 语言切换下拉菜单 + Twemoji 国旗图标
• ✅ hreflang SEO 标签（所有页面自动生成）
• ✅ i18n/build.js 一键构建所有语言版本

📝 博客自动发布系统

• ✅ AI 生成文章：NVIDIA NIM（OpenAI 兼容接口）生成 5 语言元数据（标题/描述/CTA）+ 五国语言正文
• ✅ GitHub Actions 自动化：每天 UTC 00:00 自动生成 + i18n 构建 + commit & push
• ✅ 关键词队列：blog/queue.json 管理待发布关键词
• ✅ 8 维度质量评分：词数/代码示例/FAQ/内链/AI套话/标题/列表/多语言平衡 → A/B/C 自动评级
• ✅ 多模型降级：Qwen 3.5 122B → DeepSeek V4 Flash（NVIDIA NIM）
• ✅ 飞书通知：每日发布结果 + 质量评级推送到飞书群
• ✅ IndexNow 推送：自动通知 Google/Bing 抓取新页面

📊 数据分析

• ✅ Google Analytics（G-7QLC8QV609）全站部署

🛠️ 技术栈

💰 成本分析

📁 项目结构

favicon/
├── index.html                  # 主页 - Favicon 获取器
├── tools.html                  # 工具页面（图片转换/批量处理）
├── documentation.html          # API 文档页面
├── privacy.html                # 隐私政策
├── 404.html                    # 404 错误页面
├── main.js                     # 主页 JavaScript
├── tools.js                    # 工具页 JavaScript
├── cloudflare-worker.js        # Cloudflare Worker 源码（单独部署）
├── sitemap.xml                 # 站点地图
├── robots.txt                  # 爬虫指引
│
├── i18n/                       # 多语言构建系统
│   ├── build.js                # i18n 构建脚本（生成 zh/ja/ko/es 页面）
│   ├── translations.js         # 翻译字典（5 语言）
│   └── package.json
│
├── blog/                       # 博客系统
│   ├── index.html              # 博客首页
│   ├── blog.css                # 博客样式
│   ├── blog.js                 # 博客 JS（语言切换/下拉菜单）
│   ├── *.html                  # 各篇博客文章（英文源文件）
│   ├── articles.json           # 文章索引（标题/描述/日期，5 语言）
│   ├── queue.json              # 关键词发布队列
│   └── scripts/
│       ├── generate-article.js # AI 文章生成脚本（NVIDIA NIM API）
│       └── package.json
│
├── zh/                         # 中文页面（i18n build 自动生成）
├── ja/                         # 日本語页面
├── ko/                         # 한국어页面
├── es/                         # Español 页面
│
├── .github/workflows/
│   └── daily-blog.yml          # GitHub Actions：每日自动生成博客
├── favicondl.ps1               # Windows PowerShell CLI 下载器
├── favicondl.sh                # Linux/macOS Bash CLI 下载器
├── SKILL.md                    # Agent/OpenClaw skill canonical source
├── mcp/                        # 本地 MCP Server（extract_favicon）
│   ├── server.mjs
│   ├── package.json
│   └── README.md
│
└── favicons/                   # 网站自身的 favicon 资源

🚀 部署方式

方式 1: Vercel（当前部署方式）

1. 将项目连接到 GitHub
2. 在 Vercel 导入仓库
3. 之后每次 push 到 main 自动部署

Cloudflare Worker 需要在 Cloudflare 控制台单独发布 cloudflare-worker.js。

方式 2: 本地运行

npx serve .
# 或
python -m http.server 8080

📖 使用说明

获取网站 Favicon

1. 在主页输入框输入域名（如 google.com）
2. 系统自动获取并显示图标预览
3. 点击"复制"获取 URL 或 HTML 代码
4. 点击"下载图标"保存到本地

图片转 Favicon

1. 进入"工具"页面 → "图片转 Favicon"
2. 拖拽或选择图片上传
3. 选择需要的尺寸
4. 点击"下载 ZIP 包"获取所有文件

i18n 多语言构建

cd i18n
npm install
node build.js

会读取英文源文件 + translations.js 字典，自动生成 /zh/、/ja/、/ko/、/es/ 下的所有页面（含博客）。

博客文章生成

cd blog/scripts
npm install
NVIDIA_API_KEY=your_key node generate-article.js

从 queue.json 取下一个关键词，调用 NVIDIA NIM 生成 5 语言文章，输出 HTML + 更新 articles.json + sitemap.xml。需要设置 NVIDIA_API_KEY 环境变量。

GitHub Actions 每天 UTC 00:00 自动执行上述流程 + i18n 构建 + commit & push。

🔧 API 说明

Agent 统一接口（推荐）

GET https://favicondl.com/api/extract?url={域名或网址}&size={尺寸}

size 可选，范围 16–512（例如 16、32、64、128、256、512），超出范围会夹到这个区间。传入之后，跟随 302 得到的图片是恰好该边长的正方形 PNG。省略 size 则返回网站上的原始文件，已有调用不会被改成缩放图。

比原图更大的位图会用高质量重采样放大，可能发虚；SVG 会按请求尺寸栅格化。响应头 X-Favicon-Native-Size、X-Favicon-Upscaled，以及 JSON 里的 nativeWidth、nativeHeight、upscaled，用来说明原图尺寸。放大结果不会被说成清晰原图。

需要来源和候选地址时，增加 format=json。iconUrl 仍是网站上的原始文件；设置了 size 时，proxyUrl 才是那个精确尺寸的 PNG。

GET https://favicondl.com/api/extract?url=github.com&size=32&format=json
GET https://favicondl.com/api/extract?url=wikipedia.org&format=json

接口会按优先级发现 HTML 图标、SVG、Apple Touch Icon、Web Manifest 和其他安全候选，选出最大的可用源图，再按需缩放，并通过受保护的图片代理返回。部署在 Vercel Node Functions 上（sharp 做重采样）。项目提供 REST API、OpenAPI、llms.txt、CLI，以及一个调用该 API 的本地 stdio MCP Server。它不是需要单独部署的远程 MCP 服务。

CLI 下载

.\\favicondl.ps1 -Domain "github.com" -Size 128

./favicondl.sh github.com 128

完整 Agent 说明见 SKILL.md、llms.txt 和 openapi.yaml。支持 MCP 的客户端可参考 mcp/README.md 配置本地 extract_favicon 工具。CLI 默认会带上 size=128，因此得到的是 128×128 PNG；要 32 像素就传入 32。

📝 更新日志

v1.5.0 (2026-10-20)

• ✅ size 按请求返回精确尺寸：16–512（含 32）得到恰好 N×N 的 PNG。缩小用 Lanczos，放大用高质量重采样，非正方形用透明边补齐，SVG 按目标尺寸栅格化。省略 size 仍返回原始文件。
• ✅ 标明原图尺寸：JSON 增加 nativeWidth、nativeHeight、upscaled、outputWidth、outputHeight；图片响应带 X-Favicon-Native-Size 与 X-Favicon-Upscaled。放大后的位图不会被描述成清晰原图。
• ✅ 首页预览：显示原始尺寸；当导出尺寸大于原图时给出简短提示。

v1.4.1 (2026-06-14)

• ✅ 补充博客关键词库存：blog/queue.json 新增 30 个 pending 关键词，恢复每日自动发布。
• ✅ 排查飞书 0 库存通知：飞书通知读取的是 GitHub 远端仓库状态；远端队列已全部 done 时会持续提示“剩余 0 篇”。本地如果未及时 git pull，可能看到旧的 pending 状态，造成误判。
• ✅ 后续维护建议：收到“关键词已耗尽”通知后，先同步远端最新代码，再检查 blog/queue.json 的 pending 数量；补充关键词后需要提交并推送到 GitHub，自动任务才会恢复。
• ✅ 数据支撑关键词扩展：基于 RealFaviconGenerator、Favicon.io、Next.js 官方文档、Wix/Squarespace 帮助文档、Shopify/Squarespace 用户社区和 SEOptimer 故障排查内容，额外补充 50 个高相关 pending 关键词；调研记录见 blog/keyword-research.md。

v1.4.0 (2026-03-10)

• ✅ 8 维度质量评分器：自动评估文章质量（A/B/C 评级），评分记录到 articles.json
• ✅ 模型升级：主力模型升级为 Gemini 3.1 Flash Lite（速度快 64%，质量持平）
• ✅ 飞书通知升级：每日通知包含文章质量评级和分数
• ✅ IndexNow 自动推送：发布后主动通知 Google/Bing 抓取
• ✅ 多语言深度本地化：AI Prompt 从直译升级为文化适配改写
• ✅ 反 AI 八股文：20+ 条套话黑名单 + 中英文双语检测

v1.3.0 (2026-02-12)

• ✅ 5 语言支持：新增日本語、한국어、Español（URL 路径路由）
• ✅ i18n 构建系统：i18n/build.js 一键生成 80+ 多语言页面
• ✅ 博客 AI 生成扩展：单次 Gemini API 调用输出 5 语言元数据
• ✅ GitHub Actions 优化：生成文章后自动运行 i18n build
• ✅ Google Analytics 全站部署（G-7QLC8QV609）
• ✅ 博客语言切换器修复（CSS/JS + 缓存版本号 v=20260211）
• ✅ hreflang 标签去重（build 幂等性）
• ✅ 图标加载 Bug 修复（未定义变量 toTry/fallbackSources）

v1.2.0 (2026-02)

• ✅ 语言切换 UI 产品化：下拉菜单 + Twemoji 国旗图片
• ✅ 修复语言跨页面持久化（全局 click 拦截器 + localStorage/URL 双通道）
• ✅ 缓存破除机制（JS 文件加版本参数）
• ✅ 新增 SEO：OG 标签、Twitter Card、canonical URL、robots.txt、sitemap.xml
• ✅ 新增网站 favicon（SVG）
• ✅ 新增隐私政策页 + 404 错误页

v1.1.0 (2026-01)

• ✅ Cloudflare Worker 图标发现优化（候选上限 + 提前停止策略）
• ✅ 修复批量 ZIP 下载 CORS 问题（通过 Worker 代理）
• ✅ 图标卡片垂直居中优化
• ✅ 批量处理命名模式（域名 / 索引）

v1.0.0 (2024-12)

• ✅ 完成主页 Favicon 获取功能
• ✅ 完成图片转 Favicon 工具
• ✅ 完成批量处理 + ZIP 打包
• ✅ 完成 manifest.json / HTML 代码生成

📄 许可证

MIT License

🙏 致谢

• Cloudflare Worker - Favicon discovery and protected image proxy
• NVIDIA NIM - AI article generation
• Tailwind CSS - CSS 框架
• Anime.js - 动画库
• JSZip - ZIP 生成库
• Cheerio - HTML 解析（i18n 构建）
• Twemoji - 国旗表情图标