--- title: "GHWD Audit Pro: documentação" description: "Autenticação, consulta e interpretação da auditoria completa pela API. A análise básica e o CLI local continuam gratuitos." canonical: https://ghwd.com.br/developers/audit-pro/ last-updated: 2026-10-14 --- # GHWD Audit Pro: documentação Autenticação, consulta e interpretação da auditoria completa pela API. A análise básica e o CLI local continuam gratuitos. ## Integrar ou executar com um agente de IA Escolha o caminho conforme os recursos do seu agente. O site apenas fornece as instruções; ele não instala o CLI, conecta um MCP ou altera seu projeto ao copiar o texto. 1. Informe o endereço do site e os acessos disponíveis. 2. Peça um diagnóstico e um plano de correções. 3. Aprove as mudanças e peça uma nova auditoria para conferir o resultado. ### Instruções para seu agente > Quero auditar [URL_DO_SITE] com o GHWD Audit. Confirme o endereço e os recursos disponíveis. Use o CLI local gratuito ou a conexão API/MCP Pro já configurada, conforme o meu acesso. Se for necessário instalar ferramentas ou conectar serviços, explique o que será usado e peça minha autorização antes. Não solicite nem exponha chaves na conversa; use somente a configuração privada disponível. Analise checks, evidências e fixPrompt do relatório. Priorize problemas reais e apresente um plano antes de alterar o código. Aguarde minha aprovação para as mudanças. Preserve a identidade visual e o que eu pedir para manter. Depois das alterações autorizadas, execute uma nova auditoria e compare os resultados. Informe medições indisponíveis sem inventar notas ou prometer posições nas buscas. A chave Pro deve ser configurada em um campo privado ou cofre de segredos. Não cole a chave nesta página nem na conversa com o agente. ### CLI local gratuito 1. Use um agente com terminal e Node.js 18 ou superior. Autorize o uso ou a instalação do pacote ghwd-cli antes da primeira execução. 2. Troque https://example.com pela URL pública do site. Execute o comando e entregue o JSON ao agente. 3. Peça que ele leia checks, evidence e fixPrompt, proponha um plano e aguarde sua aprovação. A camada local completa é gratuita; medições do Google dependem da disponibilidade e das cotas do PageSpeed. ``` npx ghwd-cli audit https://example.com --deep --json ``` ### API Pro no agente 1. Tenha uma chave Pro válida. Configure-a no cofre de segredos ou no campo privado de autenticação da ferramenta HTTP do agente. Não a inclua nas instruções copiadas. 2. Configure GET https://ghwd.com.br/api/v1/audit com url do site, deep=1 e locale=pt. A autenticação é Authorization: Bearer, obtida da configuração privada. Use o exemplo HTTP desta documentação como referência, substituindo o placeholder por meio do mecanismo de segredos. 3. Peça ao agente para interpretar o JSON e solicitar aprovação antes de editar arquivos. Se receber 402, confira acesso e vencimento; não tente pagar ou emitir outra chave automaticamente. ### MCP Pro no agente 1. Seu cliente precisa aceitar MCP remoto por Streamable HTTP e um cabeçalho de autenticação privado. A tela e o formato de configuração variam por cliente. Se não houver suporte, use API ou CLI. 2. Após autorizar a conexão, adicione https://ghwd.com.br/mcp e configure Authorization: Bearer com sua chave no campo privado do cliente. Confirme a disponibilidade da ferramenta audit_site. Não exponha a chave em um arquivo público. 3. Peça ao agente para chamar audit_site com os argumentos abaixo. O Bearer pertence à conexão HTTP, não aos argumentos. Solicite o plano antes das alterações e uma nova auditoria depois. ``` { "url": "https://example.com", "deep": true, "locale": "pt" } ``` ## 1. Receba e guarde sua chave O acesso é emitido manualmente após a confirmação do PIX de R$ 97. A chave tem validade de 30 dias. Guarde-a no servidor ou no cofre de segredos da sua equipe. Não a coloque no código público, em URLs, no Git ou no navegador. ## 2. Consulte a auditoria Use GET /api/v1/audit com url e deep=1. Envie sua chave no cabeçalho Authorization: Bearer. locale=pt|en|es altera fixPrompt e promptMeta. Para MCP, use audit_site com deep=true e o mesmo Bearer na conexão HTTP. ```bash curl --get 'https://ghwd.com.br/api/v1/audit' \ --data-urlencode 'url=https://example.com' \ --data-urlencode 'deep=1' \ --data-urlencode 'locale=pt' \ -H 'Authorization: Bearer SUA_CHAVE_PRO' ``` ## 3. Leia o resultado A resposta JSON inclui deep: true, payment.method: bearer_pro, checks, categorias e fixPrompt. Cada check apresenta status, evidências e orientações. O Pro acrescenta compressão, cabeçalhos de segurança e medições móveis PageSpeed. Status na significa que não houve dados para avaliar aquela verificação; não é uma nota de desempenho. ## 4. Cache e limites Resultados PSI válidos da mesma origem podem ser reutilizados por até 900 segundos. Veja measured_at, measurement_source e cache_max_age_seconds nas evidências dos checks PSI. As outras verificações consultam o site a cada auditoria. Erros não são guardados. O limite HTTP é de 60 requisições/minuto por chave Pro e 10/minuto por IP sem Pro. Esses limites não eliminam as cotas do Google. ## 5. Trate indisponibilidade HTTP 400 indica URL ou parâmetros inválidos; 402 indica ausência de acesso Pro válido; 429 indica limite de uso e inclui Retry-After; 503 pode indicar indisponibilidade do armazenamento de limites. PSI indisponível aparece dentro de uma auditoria HTTP 200 com status na e psi_error_code. Códigos: quota_limited, timeout, measurement_in_progress, access_denied, provider_unavailable, request_rejected, connection_failed e invalid_response. ## 6. Renovação e recursos disponíveis A renovação via PIX e emissão de uma nova chave são manuais. Sem dashboard, histórico ou PDF. x402 está desativado em produção e não é uma forma de contratação disponível. A auditoria completa local pelo CLI continua gratuita e sem o cache PSI do servidor. ## Alternativa local gratuita `npx ghwd-cli audit example.com --deep` --- # GHWD Audit Pro documentation Authentication, requests and interpretation of the full audit over the API. The basic audit and local CLI remain free. ## Integrate or run with an AI agent Choose a path supported by your agent. Copying instructions does not install the CLI, connect MCP or change your project. 1. Provide the website URL and available access. 2. Ask for a diagnosis and a correction plan. 3. Approve changes, then request a fresh audit to check the result. ### Instructions for your agent > I want to audit [WEBSITE_URL] with GHWD Audit. Confirm the URL and available tools. Use the free local CLI or the Pro API/MCP connection already configured for my access. If tools must be installed or services connected, explain what is needed and ask for authorization first. Do not request or expose keys in chat; use the available private configuration only. Read checks, evidence and fixPrompt from the report. Prioritize real findings and present a plan before editing code. Wait for my approval. Preserve the visual identity and anything I ask to keep. After authorized changes, run a fresh audit and compare results. Report unavailable measurements without inventing scores or promising search rankings. Configure the Pro key in a private field or secret vault. Do not paste it on this page or in the agent conversation. ### Free local CLI 1. Use an agent with a terminal and Node.js 18 or later. Authorize use or installation of ghwd-cli before its first run. 2. Replace https://example.com with the public website URL. Run the command and give the JSON to the agent. 3. Ask it to read checks, evidence and fixPrompt, propose a plan and await approval. Full local audits are free; Google measurements depend on PageSpeed availability and quotas. ``` npx ghwd-cli audit https://example.com --deep --json ``` ### Pro API in your agent 1. Use a valid Pro key. Configure it in the agent HTTP tool’s private authentication field or secret vault. Do not add it to copied instructions. 2. Configure GET https://ghwd.com.br/api/v1/audit with the site url, deep=1 and locale=en. Use Authorization: Bearer from private configuration. The HTTP example below is a reference; supply the placeholder using your secret mechanism. 3. Ask the agent to interpret the JSON and request approval before file edits. On 402, check access and expiry; do not pay or issue a new key automatically. ### Pro MCP in your agent 1. Your client needs remote Streamable HTTP MCP and a private authentication header. Configuration screens and formats vary by client. Otherwise use API or CLI. 2. Authorize the connection, add https://ghwd.com.br/mcp and configure Authorization: Bearer in the client private field. Confirm audit_site is available. Keep the key out of public files. 3. Ask the agent to call audit_site with the arguments below. Bearer belongs to the HTTP connection, not tool arguments. Require a plan before edits and a fresh audit afterwards. ``` { "url": "https://example.com", "deep": true, "locale": "en" } ``` ## 1. Receive and store your key Keys are issued manually after confirmation of the R$ 97 PIX payment, with 30-day validity. Store the key on your server or in a secret vault. Never put it in public code, URLs, Git or browser storage. ## 2. Request an audit Use GET /api/v1/audit with url and deep=1. Send the key in Authorization: Bearer. locale=pt|en|es affects fixPrompt and promptMeta. For MCP, use audit_site with deep=true and the same Bearer on the HTTP connection. ```bash curl --get 'https://ghwd.com.br/api/v1/audit' \ --data-urlencode 'url=https://example.com' \ --data-urlencode 'deep=1' \ --data-urlencode 'locale=pt' \ -H 'Authorization: Bearer SUA_CHAVE_PRO' ``` ## 3. Read the result The JSON response includes deep: true, payment.method: bearer_pro, checks, categories and fixPrompt. Checks include status, evidence and guidance. Pro adds compression, security headers and mobile PageSpeed measurements. Status na means the check could not be assessed, not a performance score. ## 4. Cache and limits Valid PSI measurements for the same origin may be reused for 900 seconds. Check measured_at, measurement_source and cache_max_age_seconds in PSI evidence. Other checks query the website each time. Errors are not cached. HTTP limits are 60 requests/minute per Pro key and 10/minute per IP without Pro. Google quotas still apply. ## 5. Handle unavailable data HTTP 400 means invalid URL or parameters; 402 means no valid Pro access; 429 means rate limit, with Retry-After; 503 may indicate unavailable rate-limit storage. Unavailable PSI appears in HTTP 200 reports as status na and psi_error_code. Codes: quota_limited, timeout, measurement_in_progress, access_denied, provider_unavailable, request_rejected, connection_failed and invalid_response. ## 6. Renewal and availability PIX renewal and new key issuance are manual. No dashboard, history or PDF. x402 is disabled in production and is not an available purchase method. Full local CLI audits remain free and do not use the server PSI cache. ## Free local alternative `npx ghwd-cli audit example.com --deep` --- # GHWD Audit Pro: documentación Autenticación, consulta e interpretación de la auditoría completa por API. El análisis básico y el CLI local siguen gratis. ## Integrar o ejecutar con un agente de IA Elige un camino compatible con tu agente. Copiar las instrucciones no instala el CLI, conecta MCP ni cambia tu proyecto. 1. Indica la URL del sitio y los accesos disponibles. 2. Pide un diagnóstico y un plan de correcciones. 3. Aprueba los cambios y pide otra auditoría para comprobar el resultado. ### Instrucciones para tu agente > Quiero auditar [URL_DEL_SITIO] con GHWD Audit. Confirma la URL y las herramientas disponibles. Usa el CLI local gratuito o la conexión API/MCP Pro ya configurada según mi acceso. Antes de instalar herramientas o conectar servicios, explica qué necesitas y pide autorización. No solicites ni expongas claves en la conversación; usa solo la configuración privada disponible. Lee checks, evidencias y fixPrompt del informe. Prioriza problemas reales y presenta un plan antes de editar código. Espera mi aprobación. Conserva la identidad visual y lo que pida mantener. Después de los cambios autorizados, ejecuta otra auditoría y compara resultados. Informa mediciones no disponibles sin inventar notas ni prometer posiciones en buscadores. Configura la clave Pro en un campo privado o cofre de secretos. No la pegues en esta página ni en la conversación con el agente. ### CLI local gratuito 1. Usa un agente con terminal y Node.js 18 o superior. Autoriza el uso o instalación de ghwd-cli antes de la primera ejecución. 2. Sustituye https://example.com por la URL pública del sitio. Ejecuta el comando y entrega el JSON al agente. 3. Pide que lea checks, evidence y fixPrompt, proponga un plan y espere aprobación. La auditoría local completa es gratis; las mediciones de Google dependen de disponibilidad y cuotas de PageSpeed. ``` npx ghwd-cli audit https://example.com --deep --json ``` ### API Pro en el agente 1. Usa una clave Pro válida. Configúrala en el cofre de secretos o campo privado de autenticación HTTP del agente. No la incluyas en las instrucciones. 2. Configura GET https://ghwd.com.br/api/v1/audit con url del sitio, deep=1 y locale=es. Usa Authorization: Bearer desde la configuración privada. El ejemplo HTTP sirve de referencia; completa el placeholder mediante el mecanismo de secretos. 3. Pide interpretar el JSON y solicitar aprobación antes de editar archivos. Ante un 402, revisa acceso y vencimiento; no pagues ni emitas otra clave automáticamente. ### MCP Pro en el agente 1. El cliente debe aceptar MCP remoto Streamable HTTP y una cabecera privada. Las pantallas y formatos varían por cliente. Si no hay soporte, usa API o CLI. 2. Autoriza la conexión, añade https://ghwd.com.br/mcp y configura Authorization: Bearer en el campo privado. Confirma que audit_site está disponible. No publiques la clave. 3. Pide llamar audit_site con los argumentos siguientes. Bearer pertenece a la conexión HTTP, no a los argumentos. Solicita un plan antes de editar y una nueva auditoría después. ``` { "url": "https://example.com", "deep": true, "locale": "es" } ``` ## 1. Recibe y guarda tu clave La clave se emite manualmente tras confirmar el PIX de R$ 97, con validez de 30 días. Guárdala en el servidor o cofre de secretos del equipo. No la pongas en código público, URL, Git ni almacenamiento del navegador. ## 2. Consulta la auditoría Usa GET /api/v1/audit con url y deep=1. Envía la clave en Authorization: Bearer. locale=pt|en|es afecta fixPrompt y promptMeta. Para MCP, usa audit_site con deep=true y el mismo Bearer en la conexión HTTP. ```bash curl --get 'https://ghwd.com.br/api/v1/audit' \ --data-urlencode 'url=https://example.com' \ --data-urlencode 'deep=1' \ --data-urlencode 'locale=pt' \ -H 'Authorization: Bearer SUA_CHAVE_PRO' ``` ## 3. Lee el resultado El JSON incluye deep: true, payment.method: bearer_pro, checks, categorías y fixPrompt. Cada check incluye estado, evidencias y orientación. Pro añade compresión, cabeceras de seguridad y mediciones móviles PageSpeed. El estado na indica falta de datos para evaluar, no una nota de rendimiento. ## 4. Caché y límites Las mediciones PSI válidas del mismo origen pueden reutilizarse hasta 900 segundos. Revisa measured_at, measurement_source y cache_max_age_seconds en las evidencias PSI. Las demás verificaciones consultan el sitio cada vez. No se guardan errores. El límite es 60 solicitudes/minuto por clave Pro y 10/minuto por IP sin Pro. Las cuotas de Google siguen aplicando. ## 5. Trata la indisponibilidad HTTP 400 indica URL o parámetros inválidos; 402 indica falta de acceso Pro válido; 429 indica límite de uso e incluye Retry-After; 503 puede indicar almacenamiento de límites no disponible. PSI no disponible aparece en informes HTTP 200 con estado na y psi_error_code. Códigos: quota_limited, timeout, measurement_in_progress, access_denied, provider_unavailable, request_rejected, connection_failed e invalid_response. ## 6. Renovación y disponibilidad La renovación PIX y nueva clave son manuales. No hay panel, historial ni PDF. x402 está desactivado en producción y no es una forma de contratación disponible. La auditoría completa local con CLI sigue gratis y no usa la caché PSI del servidor. ## Alternativa local gratuita `npx ghwd-cli audit example.com --deep` - Sales: https://ghwd.com.br/products/audit-pro/ - Auth: https://ghwd.com.br/auth.md - OpenAPI: https://ghwd.com.br/openapi.json --- ## Agent navigation - Canonical HTML: https://ghwd.com.br/developers/audit-pro/ - Agent instructions: https://ghwd.com.br/agent-instructions.md - llms.txt: https://ghwd.com.br/llms.txt - AI index: https://ghwd.com.br/ai-index.md - Developers: https://ghwd.com.br/developers/ - Audit UI: https://ghwd.com.br/audit/ - Sitemap: https://ghwd.com.br/sitemap.xml Prefer `Accept: text/markdown` (or AI bot User-Agent) to receive this text variant.