hyperseo
v0.1.0
Published
Drop-in SEO enhancer: meta/title/description fixes, JSON-LD (Organization/WebSite/Breadcrumb/Product when possible), alt text generator, SPA route support.
Maintainers
putiawebReadme
hyperseo
HyperSEO is a drop-in SEO helper (instant.page-style) for any website/ecommerce.
What it does (safe defaults)
- Sets
<title>only if missing/empty - Sets
meta[name="description"]only if missing/empty - Adds/updates JSON-LD in
<head>:Organization(if configured)WebSiteBreadcrumbList(if breadcrumbs are detected)Product(best-effort; requires basic info)
- Fills missing
altattributes for images (best-effort) - SPA support (route changes + DOM changes)
Install & build (dev)
npm install
npm run buildCDN usage (unpkg)
<script>
window.HyperSEO = {
debug: false,
schema: {
organizationName: "Your Brand",
organizationUrl: "https://example.com",
logoUrl: "https://example.com/logo.png",
sameAs: ["https://instagram.com/yourbrand"]
},
// Optional: product extraction selectors
// schema: { product: { priceSelector: ".price", currency: "EUR" } }
};
</script>
<script src="https://unpkg.com/[email protected]/dist/hyperseo.min.js" defer></script>Notes
- HyperSEO is conservative: it will not override existing meta/title/description.
- For best Product schema, provide
schema.product.priceSelector+schema.product.currencyand (optionally)imageSelector.