Menu
Comprehensive SEO analysis and reporting tool with interactive HTML, Markdown, and JSON reports
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Create presentations, PowerPoints, PDFs, and websites using Gamma AI. Convert markdown or text files into professional presentations with themes, export to PPTX/PDF, and manage projects. Use when asked to create presentations with Gamma or convert content to slides.
Manage AI Kit catalogs with installation, configuration, updates, and evolution workflows. Install kits from GitHub, track files with surgical removal, apply pattern-based mapping, and contribute changes back to source repositories.
Manage .project/PLAN.json with schema evolution, CRUD operations, and jq-style queries. Use when creating, reading, updating, or deleting plan items, validating against schemas, migrating between schema versions, or querying plan data with complex filters. Supports ID and name-based searches.
Guide for creating agent plugins compatible with both VS Code Copilot and Anthropic Claude Code. Use when users want to create a new plugin, bundle skills/agents/hooks/MCP servers into a distributable plugin, set up a plugin marketplace, or need guidance on plugin structure and cross-platform compatibility.
Guide for creating effective VS Code Copilot skills following ai-ley kit standards. Use when users want to create a new skill, update an existing skill, or need guidance on skill structure, TypeScript scripts, MCP servers, or skill best practices.
Comprehensive index management for AI-ley kit resources - reindex resources to .github/aicc/indexes/*.index.json with ID-based keying and .my/ override support, plus search/query capabilities with multiple output formats. Use for rebuilding indexes, searching resources by name/keywords/content, or exporting index data in various formats (JSON, YAML, XML, CSV, Markdown, HTML).
| id | null |
| name | ailey-tools-seo-report |
| description | Comprehensive SEO analysis and reporting tool with interactive HTML, Markdown, and JSON reports |
| keywords | ["seo-audit","web-crawler","performance-analysis","content-analysis","technical-seo","core-web-vitals"] |
| version | 1.0.0 |
| category | Analysis & Reporting |
| tags | ["seo","analysis","web-crawling","reporting","performance","content-optimization"] |
| author | AI-ley |
| created | Fri Jan 19 2024 18:00:00 GMT-0600 (Central Standard Time) |
| updated | Fri Jan 19 2024 18:00:00 GMT-0600 (Central Standard Time) |
| status | active |
| dependencies | ["cheerio","lighthouse","puppeteer","axios","commander","chalk"] |
Comprehensive SEO analysis and reporting tool that crawls websites, analyzes technical SEO, content quality, performance metrics, and generates actionable recommendations in multiple formats.
The SEO Report skill provides enterprise-grade SEO auditing capabilities through a TypeScript-based toolkit. It crawls websites, collects technical data, analyzes content quality and performance metrics, calculates SEO scores, and generates detailed reports with prioritized recommendations.
cd .github/skills/ailey-tools-seo-report
npm install
Skill Resources:
AI-ley Ecosystem:
.github/ai-ley/personas/marketing/seo-expert.md - SEO strategy and optimization expertise.github/ai-ley/personas/analyst/technical-analyst.md - Performance analysis expertise.github/agents/ailey-marketing.agent.md - Recommended agent for SEO workflowsRelated Skills:
ailey-tools-data-converter - Convert report formats (JSON to CSV, etc.)ailey-tools-image - Optimize images identified in reportsRelated Prompts:
ailey-report-seo.prompt.md - Generate SEO reports (delegates to this skill)# Basic SEO audit
npm run seo-report -- --url https://example.com
# Full audit with competitors and custom depth
npm run seo-report -- \
--url https://example.com \
--competitors https://competitor1.com,https://competitor2.com \
--keywords "primary keyword,secondary keyword" \
--depth 3 \
--max-pages 50 \
--output ./reports/example-audit
# Quick audit with minimal pages
npm run seo-report -- -u https://example.com -m 10 -o ./quick-audit
| Option | Alias | Description | Default |
|---|---|---|---|
--url | -u | Website URL to analyze (required) | - |
--output | -o | Output directory for reports | ./seo-reports |
--max-pages | -m | Maximum pages to crawl | 25 |
--depth | -d | Maximum crawl depth | 2 |
--keywords | -k | Comma-separated keywords to track | [] |
--competitors | -c | Comma-separated competitor URLs | [] |
--focus | -f | Focus areas (technical/content/performance/all) | all |
import { analyzeSite } from './.github/skills/ailey-tools-seo-report/scripts/seo-report.js';
const report = await analyzeSite({
url: 'https://example.com',
maxPages: 25,
crawlDepth: 2,
keywords: ['seo', 'optimization'],
competitors: ['https://competitor.com'],
userAgent: 'SEO-Analyzer/1.0',
timeout: 30000,
respectRobots: true
});
console.log(`Overall SEO Score: ${report.scores.overall}/100`);
console.log(`Health Grade: ${report.executiveSummary.healthGrade}`);
seo-audit-report.html)Interactive HTML report with:
seo-audit-summary.md)Clean, readable Markdown summary with:
technical-analysis.json)Complete analysis data in JSON format:
recommendations.csv)Spreadsheet-compatible recommendation export:
lib/collectors/)WebCrawler (crawler.ts):
lib/analyzers/)SEOScorer (scorer.ts):
lib/reporters/)HTMLReportGenerator (html-reporter.ts):
MarkdownReportGenerator (markdown-reporter.ts):
Overall Score = (Technical × 0.25) + (Content × 0.30) +
(Performance × 0.25) + (UX × 0.10) + (Authority × 0.10)
Components:
Components:
Components:
Components:
Components:
Note: Authority metrics require integration with external SEO APIs (Moz, Ahrefs, SEMrush). Currently returns placeholder data.
30-Day Quick Wins:
90-Day Strategic Improvements:
6-Month Goals:
Ongoing Optimization:
npm test
15 comprehensive tests covering:
Mock data in tests/fixtures/mock-data.ts:
createMockReport(): Standard test reportcreateComplexMockReport(): Complex scenarios with edge cases// lib/collectors/custom-collector.ts
import type { SEOConfig } from '../types.js';
export class CustomCollector {
async collect(config: SEOConfig): Promise<any> {
// Your collection logic
return data;
}
}
// lib/analyzers/custom-analyzer.ts
export class CustomAnalyzer {
analyze(data: any): number {
// Your analysis logic
return score;
}
}
// lib/reporters/custom-reporter.ts
import { promises as fs } from 'fs';
import type { SEOReport } from '../types.js';
export class CustomReporter {
async generate(report: SEOReport, outputPath: string): Promise<void> {
const content = this.format(report);
await fs.writeFile(outputPath, content);
}
private format(report: SEOReport): string {
// Your formatting logic
return formattedContent;
}
}
Issue: Crawl blocked by robots.txt
Solution: Use --respect-robots false (only for sites you own)
npm run seo-report -- -u https://mysite.com --respect-robots false
Issue: Timeout errors on slow sites
Solution: Increase timeout value
await analyzeSite({
url: 'https://example.com',
timeout: 60000 // 60 seconds
});
Issue: Memory issues with large sites
Solution: Reduce max pages and depth
npm run seo-report -- -u https://example.com -m 10 -d 1
--max-pages)--focus flag to analyze specific aspectsMIT - Part of the AI-ley toolkit
For issues, feature requests, or contributions:
.github/skills/ailey-tools-seo-reportVersion: 1.0.0
Last Updated: 2024-01-20
Status: Active
Maintained By: AI-ley Team