run_seo_audit
Analyze webpage SEO performance to identify optimization opportunities and improve search visibility.
Instructions
Run an SEO audit on the current page
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- index.js:906-946 (handler)The core handler function for the 'run_seo_audit' tool. It ensures Chromium is running, evaluates JavaScript in the page context to perform SEO checks (title, meta description, H1 tags, canonical), parses results, and returns formatted audit findings.
async runSEOAudit() { await this.ensureChromium(); const result = await this.sendCDPCommand('Runtime.evaluate', { expression: ` const results = []; const title = document.querySelector('title'); if (!title || title.textContent.trim().length === 0) { results.push('Missing or empty title tag'); } else if (title.textContent.length > 60) { results.push('Title tag is too long (>60 characters)'); } const metaDesc = document.querySelector('meta[name="description"]'); if (!metaDesc || metaDesc.getAttribute('content').trim().length === 0) { results.push('Missing or empty meta description'); } const h1Tags = document.querySelectorAll('h1'); if (h1Tags.length === 0) { results.push('No H1 tag found'); } else if (h1Tags.length > 1) { results.push('Multiple H1 tags found'); } const canonical = document.querySelector('link[rel="canonical"]'); if (!canonical) { results.push('Missing canonical link'); } JSON.stringify(results.length > 0 ? results : ['Basic SEO checks passed']); `, returnByValue: true }); const seoResults = JSON.parse(result.result?.value || '[]'); return { content: [{ type: 'text', text: `SEO Audit Results:\\n${seoResults.join('\\n')}` }], }; } - index.js:295-302 (registration)Tool registration in the ListToolsRequestSchema handler, defining the tool name, description, and input schema (empty object).
{ name: 'run_seo_audit', description: 'Run an SEO audit on the current page', inputSchema: { type: 'object', properties: {}, }, }, - index.js:383-384 (registration)Dispatch case in the CallToolRequestSchema switch statement that routes calls to the runSEOAudit handler method.
case 'run_seo_audit': return await this.runSEOAudit(); - index.js:298-301 (schema)Input schema definition for the tool (requires no parameters).
inputSchema: { type: 'object', properties: {}, }, - index.js:1066-1066 (helper)Usage of runSEOAudit within the comprehensive runAuditMode tool.
results.seo = await this.runSEOAudit();