seo-reportlisted
Install: claude install-skill YogeshKu7877/claude-seo-skills
# SEO Report Generator — File-Persisted Reports
Generates complete, AI-analyzed SEO reports and saves them to disk as markdown files.
Supports four report types: monthly, weekly, audit, and competitor. This is the first
sub-skill in the project that uses the Write tool for file persistence.
## References
@skills/seo/references/mcp-degradation.md
@skills/seo/references/ahrefs-api-reference.md
@skills/seo/references/gsc-api-reference.md
## Inputs
- `type`: Report type — one of: `monthly`, `weekly`, `audit`, `competitor` (required)
- `domain`: The domain to report on, bare domain e.g. `example.com` (required).
Strip `https://`, `http://`, and trailing slashes.
- `site` (optional): GSC property URL for including Google Search Console data.
Format: `https://example.com/` or `sc-domain:example.com`
- `competitor` (optional, required for `competitor` type): Competitor domain to
compare against, e.g. `competitor.com`
- `output_dir` (optional): Directory path to save the report file.
Default: current working directory (pwd).
## MCP Check
Before proceeding, check MCP availability:
1. **Ahrefs (required for all report types):**
Use ToolSearch with query `+ahrefs`
- If tools returned → Ahrefs available, proceed
- If no tools returned → display Ahrefs error template from mcp-degradation.md and stop
2. **GSC (optional — only if `site` parameter is provided):**
Use ToolSearch with query `+google-search-console`
- If tools returned → GSC available, include GSC