FaviconDL MCP Server

Trích xuất và tải xuống favicon trang web có thể sử dụng, đồng thời trả về URL biểu tượng trực tiếp và siêu dữ liệu thông qua máy chủ MCP.

GitHub

Tài liệu

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