seo-report
npx machina-cli add skill jezweb/claude-skills/seo-report --openclawSEO Report
Generate a professional, client-facing SEO report from Whispering Wombat crawl data. Outputs an HTML file suitable for sharing via PageDrop or email.
Required MCP Tools
- Whispering Wombat:
whispering_crawls,whispering_issues,whispering_links,whispering_content - Brain (optional):
brain_site_get,brain_client_get - PageDrop (optional): For publishing shareable URL
Input
$ARGUMENTS should be a domain name (e.g., abpsychology.au).
Workflow
Step 1: Get Latest Crawl
whispering_crawls list — find the most recent completed crawl for this domain.
If no crawl exists, inform the user and suggest running /seo-audit {domain} first.
Step 2: Get Client Context
If Brain is available:
brain_site_get { domain }— client name, contact, business type- Use client name in the report header
Step 3: Gather Report Data
Collect all data needed for the report:
whispering_issues overview— scores, status codes, response timeswhispering_issues summary— issue counts by typewhispering_links stats— link healthwhispering_content sitemaps— sitemap statuswhispering_content structure— site depth- If previous crawl exists:
whispering_crawls compare— changes
Step 4: Generate HTML Report
Create a self-contained HTML file with inline CSS. Save to .claude/artifacts/seo-report-{domain}-{date}.html.
Report structure:
<!DOCTYPE html>
<html lang="en-AU">
<head>
<meta charset="UTF-8">
<title>SEO Report: {domain}</title>
<style>/* Inline professional styling */</style>
</head>
<body>
<!-- Header with Jezweb branding -->
<!-- Executive Summary (1 paragraph) -->
<!-- Key Metrics Grid (4 cards: pages, issues, score, speed) -->
<!-- Top 5 Issues with fix instructions -->
<!-- Comparison with previous crawl (if available) -->
<!-- Detailed Findings by Category -->
<!-- Footer with date and disclaimer -->
</body>
</html>
Design guidelines:
- Professional, clean layout — no playful colours or emojis
- Monochrome/slate colour scheme matching Jezweb brand
- Tables for data, simple bar charts via CSS (no JS libraries)
- Print-friendly (reasonable page breaks, no fixed widths)
- Jezweb logo in header:
https://www.jezweb.com.au/wp-content/uploads/2021/11/Jezweb-Logo-White-Transparent.svg
Step 5: Offer to Share
After generating the HTML:
- Show the file path to the user
- Offer to publish via PageDrop for a shareable URL
- If PageDrop:
pages { action: "create", content: htmlContent, slug: "seo-{domain}" }
Executive Summary Template
Write the executive summary as one short paragraph covering:
- Overall site health assessment (good/needs attention/critical)
- Number of pages analysed
- Most impactful finding
- Comparison trend (improving/declining/stable) if previous data exists
Example:
"{Domain} is in good technical health with {X} pages analysed. The site scores well on core SEO fundamentals but has {N} critical issues that should be addressed — most notably {top issue}. Compared to the previous audit, the site has {improved/declined} with {N} new issues and {N} resolved."
Notes
- Australian English throughout
- Keep language accessible — the client may not be technical
- Focus on "what to fix and why" not "what's wrong"
- Avoid jargon: "search engines can't find this page" not "noindex directive present"
- Include estimated impact: "fixing this could improve your visibility for local searches"
Source
git clone https://github.com/jezweb/claude-skills/blob/main/plugins/seo/skills/seo-report/SKILL.mdView on GitHub Overview
Generates a professional, client-facing SEO report from Whispering Wombat crawl data. Outputs a self-contained HTML document with an executive summary, key metrics, top issues, and comparison charts, ready to share via PageDrop or email.
How This Skill Works
It starts by locating the most recent completed crawl for the domain using whispering_crawls list. If available, it pulls optional client context via Brain and aggregates data from whispering_issues, whispering_links, and whispering_content, including a prior crawl comparison if present. It then builds a self-contained HTML report with inline CSS and saves it to the Claude artifacts folder for easy sharing or publishing via PageDrop.
When to Use It
- After running a crawl for a domain to deliver a client-facing report
- During onboarding of a new client to summarise initial findings
- For monthly or quarterly SEO performance reviews with stakeholders
- When you need a print-friendly, executive summary for sharing
- When there is a previous crawl to compare changes against
Quick Start
- Step 1: Run the report for your domain (e.g., seo report example.com)
- Step 2: If Brain is available, pull client context and choose sharing method (PageDrop) as needed
- Step 3: Retrieve the saved HTML at .claude/artifacts/seo-report-{domain}-{date}.html and share or publish
Best Practices
- Always run the latest completed crawl for the domain before generating the report
- Fetch client details via Brain (if available) to personalise the header
- Keep the executive summary concise and client-friendly
- Explain top issues with recommended fixes and their estimated impact
- Include a previous crawl comparison to illustrate trends when available
Example Use Cases
- Agency delivers a monthly client SEO report with executive summary and charts
- Onboarding for a new client with initial audit and quick-win fixes
- Quarterly health check for an e-commerce site highlighting issues and fixes
- Shareable report for internal or client meetings, print-friendly
- Comparison-focused report showing changes versus the previous crawl
