convez.ai
MCP ServerDesenvolvimento WebIntermediário
pdugan20

Favicon Inspector

pdugan20/favicon-inspector

Inspecione e valide favicons com Google Favicon Services

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP Server que inspeciona e valida favicons servidos pelo Google Favicon Services para seus domínios. Gera relatórios HTML e JSON com comparação entre snapshots, detectando ícones com problemas e sugerindo correções automáticas.

Instalação

$npx convez-ai pdugan20/favicon-inspector

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 1 dia
Versão
—
Issues abertas
7
Contribuidores
2

Casos de uso

  • Monitorar qualidade de favicons em múltiplos domínios
  • Detectar ícones corrompidos ou mal formatados
  • Comparar alterações de favicons entre períodos
  • Automatizar validação de favicons em pipelines CI/CD
  • Gerar favicons corrigidos e otimizados para diferentes plataformas

Veredito

Ferramenta especializada para validação e correção de favicons em escala, com suporte a integração CI/CD. Ideal para equipes mantendo múltiplos domínios que precisam garantir consistência visual e conformidade com padrões do Google.

README

A tradução para o português deste README ainda está na fila.

favicon-inspector

CI TypeScript Node.js License: MIT

Inspect what Google's favicon services serve and cache for a set of domains, and flag the icons that come back wrong.

Install

npm install        # run from the repo via npm start
npm install -g .   # expose the favicon-inspector bin

Usage

npm start                            # capture a snapshot
npm start -- --compare latest        # capture, then diff against the previous run
npm start -- --fail-on alert         # exit 2 if any icon alerts (for CI/cron)

Each run writes a timestamped HTML report and JSON sibling to the output directory, updates the latest.html / latest.json pointers, and grades every icon OK / WARN / ALERT. Compare mode reports only the cells whose verdict changed.

Usage: favicon-inspector [options]

Captures what Google's favicon services serve for the configured domains and
writes an HTML + JSON report. With --compare, diffs snapshots instead.

Options:
  --compare <file> [<file>]  Diff snapshot JSONs. With one path, captures a
                             fresh snapshot first. 'latest' is shorthand for
                             the latest.json pointer in the output dir.
  --domains <list>           Comma-separated domains to inspect instead of the
                             config file, e.g. a.com,b.com.
  --fail-on <level>          'warn' or 'alert'. Exit 2 if any cell is at or
                             above this verdict. For CI and cron monitoring.
  --out <dir>                Output directory (default: reports).
  -h, --help                 Show this help.
  -v, --version              Show version.

Configuration:
  Without --domains, domains come from favicon-inspector.config.json in the
  working directory:
    {"domains": ["a.com", {"domain": "b.com", "expected": "opaque"}]}
  Set expected to 'opaque' for domains whose icon is legitimately a solid
  tile; it suppresses black-background alerts.

Exit codes:
  0  success
  1  fatal error (bad flags, missing domains, unreadable snapshot, crash)
  2  --fail-on threshold met

Generating corrected favicons

When the inspector flags a domain, npm run favicons:generate builds a Google-correct favicon set for each configured domain. Tab icons come from a transparent master (non-square sources letterboxed, never stretched). The apple-touch-icon and maskable icon come from an opaque, full-bleed tile you drop in scripts/masters/<domain>.tile.png (see scripts/masters/README.md for the format) so they render edge-to-edge and can never be flattened to a black square; domains without a tile skip those two slots. Output lands in generated/<domain>/ with a head.html link snippet to deploy. npm run favicons:preview then builds a self-contained gallery at generated/preview.html to eyeball every icon on transparent and white backgrounds. The rationale and citations are in docs/favicon-findings.md, and per-platform deploy steps (Mintlify, Next.js, static) are in docs/favicon-deploy.md.

Monitoring

.github/workflows/favicon-monitor.yml captures a snapshot with --fail-on alert when dispatched from the Actions tab, so a degraded icon shows up as a failed run. Reports from each run are kept as workflow artifacts for 30 days.

Configuration

The domain list lives in favicon-inspector.config.json (shape shown in the help text above). Sizes, endpoints, and fetch limits live in src/config.ts.

Ver o original no GitHub

Bom para

Relacionados