run_best_practices_audit

Audit web pages for best practices to identify performance, accessibility, and SEO issues. Use this tool to evaluate page quality and compliance with web standards.

Instructions

Run a best practices audit on the current page

Input Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Implementation Reference

index.js:948-986 (handler)

Main handler function implementing the 'run_best_practices_audit' tool. Ensures Chromium is running, evaluates JavaScript in the page context to perform checks (HTTPS, mixed content, deprecated tags, viewport meta), parses results, and returns formatted text output.

async runBestPracticesAudit() {
  await this.ensureChromium();
  
  const result = await this.sendCDPCommand('Runtime.evaluate', {
    expression: `
      const results = [];
      if (location.protocol !== 'https:') {
        results.push('Page is not served over HTTPS');
      }
      
      const httpResources = Array.from(document.querySelectorAll('[src], [href]'))
        .filter(el => (el.src || el.href)?.startsWith('http:'))
        .length;
      
      if (httpResources > 0) {
        results.push(\`Found \${httpResources} HTTP resources on HTTPS page\`);
      }
      
      const deprecatedTags = Array.from(document.querySelectorAll('font, center, big, small, tt')).length;
      if (deprecatedTags > 0) {
        results.push(\`Found \${deprecatedTags} deprecated HTML tags\`);
      }
      
      const viewport = document.querySelector('meta[name="viewport"]');
      if (!viewport) {
        results.push('Missing viewport meta tag for mobile optimization');
      }
      
      JSON.stringify(results.length > 0 ? results : ['Best practices checks passed']);
    `,
    returnByValue: true
  });
  
  const bestPracticesResults = JSON.parse(result.result?.value || '[]');
  
  return {
    content: [{ type: 'text', text: `Best Practices Audit Results:\\n${bestPracticesResults.join('\\n')}` }],
  };
}

index.js:303-310 (registration)

MCP tool registration entry defining the tool name, description, and empty input schema (no parameters required).

{
  name: 'run_best_practices_audit',
  description: 'Run a best practices audit on the current page',
  inputSchema: {
    type: 'object',
    properties: {},
  },
},

index.js:306-309 (schema)
Input schema for the tool: empty object, indicating no input parameters are required.
```
inputSchema: {
  type: 'object',
  properties: {},
},
```
index.js:385-386 (registration)
Dispatch case in the main tool request handler switch statement that routes calls to the runBestPracticesAudit method.
```
case 'run_best_practices_audit':
  return await this.runBestPracticesAudit();
```
index.js:1067-1067 (helper)
Usage of the method within the comprehensive 'run_audit_mode' tool.
```
results.bestPractices = await this.runBestPracticesAudit();
```

chromium-arm64