seo-optimizer

Analyze HTML files for SEO issues and generate XML sitemaps with Python scripts.

1|Updated May 6, 2026
One-click install
npx skills add https://github.com/surfingalien/FinSurfing --skill seo-optimizer-surfingalien
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: seo-optimizer
Source: https://github.com/surfingalien/FinSurfing/tree/main/.claude/skills/seo-optimizer
Command: npx skills add https://github.com/surfingalien/FinSurfing --skill seo-optimizer-surfingalien

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Websites often ship with missing title tags, meta descriptions, alt text, and structured data, causing poor search engine visibility. This Skill audits HTML pages for SEO issues, prioritizes fixes, and generates sitemaps so pages can be properly crawled and ranked. ## Core Features & Use Cases - Automated SEO Audits: Scan single HTML files or entire directories to detect missing titles, meta descriptions, H1 problems, missing alt attributes, absent Open Graph/Twitter Card tags, and missing schema markup, with text or JSON reports. - Sitemap Generation: Crawl a directory of HTML files and produce a standards-compliant XML sitemap with lastmod dates, estimated priorities, and change frequencies. - Guided Fixes & References: Apply prioritized fix patterns for meta tags, headings, and schema markup using the included SEO checklist, schema markup guide, and robots.txt template. - Use Case: Before launching a static marketing site, run the analyzer on the public folder, fix all critical issues it flags, generate sitemap.xml, customize robots.txt, and submit both to Google Search Console. ## Quick Start Ask the AI to run an SEO audit on your website's HTML directory, fix the critical issues it finds, and generate a sitemap for your domain.

Frequently Asked Questions about seo-optimizer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run an SEO audit on my HTML website?

Run the seo_analyzer.py script against a single HTML file or an entire directory of pages. It produces a report grouping findings into critical issues, warnings, and good practices, with an optional --json flag for machine-readable output.

How to generate an XML sitemap for a static website?

Run generate_sitemap.py with your site directory and base URL, optionally specifying an output file. It finds all HTML files, builds URLs, adds lastmod dates, and estimates priority and changefreq values automatically.

What SEO issues does the HTML analyzer check for?

The analyzer checks title tags, meta descriptions, H1 count and heading hierarchy, image alt attributes, HTML lang attribute, viewport and charset tags, Open Graph and Twitter Card tags, canonical URLs, and schema.org structured data.

Does the SEO analyzer work on React or JavaScript-rendered sites?

The analyzer parses static HTML files using Python's html.parser, so it works on pre-rendered or built HTML output. For client-rendered apps, run it against the production build output rather than source templates.

What schema markup types can I add to my pages?

The included schema markup guide covers JSON-LD implementations for Organization, LocalBusiness, Article, BlogPosting, Breadcrumb, FAQ, WebSite, Product, Review, and Person types, with required properties and validation steps.