{
  "schema_version": "1.0",
  "name": "Ferraoferrao SEO Tools",
  "description": "Three free SEO tools by Thiago Ferrão: technical SEO audit, web benchmark comparison, and Generative Engine Optimization (GEO) readiness check. Available as public HTTP APIs callable by AI agents.",
  "url": "https://ferraoferrao.com.br/",
  "provider": {
    "name": "Thiago Ferrão",
    "url": "https://ferraoferrao.com.br/sobre",
    "contact": "mailto:eu@ferraoferrao.com.br"
  },
  "documentation_url": "https://ferraoferrao.com.br/",
  "terms_of_service_url": "https://ferraoferrao.com.br/",
  "license": "free-public-use",
  "capabilities": {
    "streaming": false,
    "authentication_required": false,
    "rate_limiting": "5 requests per 10 seconds per IP (enforced by Cloudflare)"
  },
  "tools": [
    {
      "name": "seo_check",
      "description": "Auditoria técnica de SEO de uma URL: HTTPS, certificado, status HTTP, redirects, compressão, HTTP/2-3, TTFB, cache, security headers, robots.txt, sitemap, canonical, title, meta description, hierarquia de headings, hreflang, links internos/externos, imagens (alt, dimensões, lazy loading, formatos modernos), Open Graph, Schema.org, performance e acessibilidade. Inclui Lighthouse via Google PageSpeed Insights e Core Web Vitals.",
      "endpoint": "https://ferraoferrao.com.br/seo-checker/analisar.php",
      "method": "POST",
      "input_schema": {
        "type": "object",
        "required": ["url"],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "URL pública (http/https) a auditar."
          },
          "strategy": {
            "type": "string",
            "enum": ["mobile", "desktop"],
            "default": "mobile",
            "description": "Estratégia de análise (mobile ou desktop)."
          }
        }
      },
      "output_schema": {
        "type": "object",
        "description": "Relatório completo com pontuação Lighthouse, Core Web Vitals e ~60 critérios técnicos agrupados em 11 categorias."
      },
      "ui_url": "https://ferraoferrao.com.br/seo-check"
    },
    {
      "name": "seo_benchmark",
      "description": "Compara o desempenho técnico de uma URL contra a mediana global da web e contra o top 1000 sites do CrUX rank. Usa dados do HTTP Archive e Web Almanac. Métricas comparadas: TTFB, Core Web Vitals (LCP, CLS, INP), scores Lighthouse, contagem de palavras, número de requisições, tamanho do HTML servido, adoção de HTTPS, compressão, canonical, viewport, schema, alt em imagens, lazy loading e formatos modernos.",
      "endpoint": "https://ferraoferrao.com.br/seo-bench/seo-benchmark-api.php",
      "method": "POST",
      "input_schema": {
        "type": "object",
        "required": ["url"],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "URL pública (http/https) a comparar."
          },
          "strategy": {
            "type": "string",
            "enum": ["mobile", "desktop"],
            "default": "mobile"
          }
        }
      },
      "output_schema": {
        "type": "object",
        "description": "Relatório com cada métrica posicionada em quartis (p25/p50/p75) ou em percentual de adoção, mais HA Score consolidado de 0 a 100."
      },
      "ui_url": "https://ferraoferrao.com.br/seo-benchmark"
    },
    {
      "name": "geo_check",
      "description": "Auditoria de Generative Engine Optimization (GEO) e Answer Engine Optimization (AEO) para os principais motores generativos: Google AI Overviews, ChatGPT, Perplexity, Microsoft Copilot e Claude. Verifica 31 critérios em 9 categorias: acesso de crawlers de IA (GPTBot, PerplexityBot, Googlebot/Google-Extended, CCBot, Bingbot), descoberta para agentes (Link headers RFC 8288, /llms.txt, negociação Markdown), Schema.org, E-E-A-T, estrutura de conteúdo, frescor, presença multiplataforma, citabilidade e tamanho do HTML.",
      "endpoint": "https://ferraoferrao.com.br/geo-checker/geo-check-api.php",
      "method": "POST",
      "input_schema": {
        "type": "object",
        "required": ["url"],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "URL pública (http/https) a auditar."
          }
        }
      },
      "output_schema": {
        "type": "object",
        "description": "Relatório com status (aprovado/atenção/não aplicável) por critério, prioridade técnica e motores impactados."
      },
      "ui_url": "https://ferraoferrao.com.br/geo-check"
    }
  ],
  "input_modes": ["text/plain", "application/x-www-form-urlencoded"],
  "output_modes": ["application/json"]
}