FaviconDL MCP Server

Extract and download usable website favicons and return direct icon URLs and metadata through an MCP server.

GitHub

Documentación

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）全站部署

🛠️ 技术栈

类别技术
前端HTML5 + CSS3 + JavaScript (ES6+)
样式Tailwind CSS (CDN)
动画Anime.js
图片处理Canvas API（纯前端）
ZIP 打包JSZip（按需加载）
图标发现/代理Cloudflare Worker 多级发现与安全图片代理
Agent 接入REST API + OpenAPI + llms.txt + CLI
MCP本地 stdio MCP Server（mcp/server.mjs）
i18n 构建Node.js + Cheerio
博客生成NVIDIA NIM（OpenAI 兼容 API）
CI/CDGitHub Actions
数据分析Google Analytics 4

💰 成本分析

项目方案成本
托管Vercel 静态部署$0
Favicon APIVercel Function + Cloudflare Worker$0
图片处理前端 Canvas$0
CDN/代理Cloudflare Worker 免费额度$0
AI 文章NVIDIA NIM（按当前账户额度）按用量
数据分析Google Analytics 4$0
总计$0/月

📁 项目结构

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={尺寸}

默认返回 302，跟随跳转即可下载图标；需要来源和候选地址时，增加 format=json。

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

Worker 会按优先级发现 HTML 图标、SVG、Apple Touch Icon、Web Manifest 和其他安全候选，并在需要时通过受保护的图片代理返回结果。项目提供 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 工具。

📝 更新日志

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 - 国旗表情图标