Skip to Content
Slloy Docs
SEO, i18n & Redirect Governance

SEO Metadata Rules, Sitemap & GSC Operations

Page Title and H1 formulas, fitPageTitle 75-char enforcement, honest Free-to-Try copy rules, sitemap architecture, and Google Search Console operations.

Slloy enforces SEO metadata quality, multilingual hreflang / og:locale completeness, and sitemap integrity via automated build gates (npm run check:meta, npm run check:sitemap, npm run check:sitemap:xml, and npm run check:ld).

1. Title, H1 & Copywriting Rules

Title Formula & 75-Character Hard Cap (fitPageTitle)

  • Structure: `{Primary Query} — {Differentiator}` (target <= 60 characters, hard ceiling TITLE_MAX = 75 characters).
  • Why <= 75 characters is strictly enforced (LONG_TITLE_BUDGET = 0 in tools/check-meta.ts):
    • Search engines truncate overlong <title> tags from the right, cutting off brand suffixes or leaving broken parentheses in SERPs.
  • Deterministic Truncation (frontend/site/content/page-title.ts):
    1. If title.length <= 75, returns unchanged.
    2. Otherwise, scans clause separators (":", ":", " — ", " – ", " · ", " | ", ";", ";", "?", "?", "!", "!", ",", ",") from right to left and returns the longest complete prefix <= 75 chars (naturally dropping trailing | Slloy AI Blog or secondary subtitle clauses without an ellipsis).
    3. Only if no clause boundary fits does hardCut() drop any unclosed bracket (dropOpenBracket for (, (, [, 【, «, “), cut at a word boundary (or character boundary for CJK), and append "…".

H1 & Honest "Free to Try" Copy Rule

  • H1 Structure: `{Query} {Category}` — directly states what the tool or preset produces (e.g., "Seedream 5.0 AI Image Generator", "Amazon White-Background Product Photo Prompts").
  • Honest "Free to Try" Rule:
    • Slloy grants 100 free credits on signup and 10 credits on daily check-in, which allows users to try any image model and low-cost video models (wan-fast, wan-i2v-flash, wan-i2v, mini) for free.
    • Copy and meta descriptions must state "Free to try with 100 signup credits" (or direct action verbs like "Generate Image"), never deceptive clickbait like "100% Free Unlimited No Login".

2. Build-Time Metadata Gate (tools/check-meta.ts)

Running npm run check:meta inspects all 1,094+ pre-rendered HTML files in dist/ (decoding HTML entities via decodeEntities before measuring lengths) and fails CI on any of the following 11 issues:

Rule IDCondition CheckedPurpose
missing-title / missing-descriptionEvery indexed page (!SKIP.has(file)) must have non-empty <title> and <meta name="description">.Prevents blank SERP snippets.
placeholderNeither title nor description may contain { or }.Catches uninterpolated i18n template variables.
duplicate-titleNo two pages within the same locale may share the exact same <title>.Catches template variable bugs that collapse multiple pages into one title.
long-titletitle.length <= 75 (TITLE_MAX = 75, LONG_TITLE_BUDGET = 0).Zero tolerance for SERP title truncation.
copy-of-englishOn non-English pages (locale !== "en"), title and description cannot both be character-for-character identical to the English page at the same path.Catches untranslated pages across both Latin and non-Latin scripts.
unlocalizedOn non-Latin script locales (zh, tw, ja, ko, ru, ar, he), Latin script letters (\p{Script=Latin}) in description (> 20 chars) must be < 70% (LATIN_MAX = 70).Catches English descriptions leaked into CJK/Cyrillic/Arabic/Hebrew pages while allowing model names (Seedream, Qwen-Image).
missing-og-locale / bad-og-localeEvery indexed page (!noindex) must have <meta property="og:locale"> matching /^[a-z]{2,3}_[A-Z]{2}$/ (e.g., zh_CN, en_US, never BCP 47 zh-CN or bare en).Valid OpenGraph locale format.
missing-hreflang / missing-x-defaultEvery indexed page must include <link rel="alternate" hreflang="..."> tags (matched case-insensitively on hrefLang/hreflang) including hreflang="x-default".Prevents Google from treating 14 locale versions as duplicate content.

3. Sitemap Architecture & Indexing Posture

Split Sitemap Index & Real lastmod Dates

/sitemap.xml serves a Sitemap Index referencing 3 sub-sitemaps (core pages, blog articles, and prompt presets):

  • Canonical URLs Only: Zero .html extensions and zero index.html suffixes (prettyIndex() normalizes directory indexes, verified across all canonical, hreflang, and <loc> tags).
  • Authentic lastmod Timestamps (check:sitemap:xml):
    • Static core pages read real modification dates from seo/pages-lastmod.json (only populated when a page's content meaningfully changes).
    • Blog articles use the article's updated or date field.
    • Prompt pages use the database record's updated_at timestamp.
    • CI guard npm run check:sitemap:xml fails the build if all URLs share the same lastmod date (preventing the "all-pages-today" anti-pattern that causes Google to ignore lastmod) or if any date is in the future.

Parameter Page Indexing Posture & robots.txt

  • Allowed & Canonical-Converged: ?style= and ?mode= are allowed in robots.txt and converge via <link rel="canonical"> to the clean base URL.
  • Invalid Filter Values Return 404: Requests to /prompts with unknown values for known filter keys (?family=invalid, ?use=invalid, ?platform=invalid, ?season=invalid) return HTTP 404 (hasUnknownPromptFilter), and empty filter combinations output <meta name="robots" content="noindex,follow">.
  • Blocked for Crawl Budget: ?model= query parameters on the generator remain disallowed in robots.txt because each model already has its own dedicated static landing page.

4. Google Search Console (GSC) Verification & Operations

Domain Property & Verification

  • Property Type: Domain Property (slloy.com) in Google Search Console, covering https://slloy.com and all locale subpaths.
  • Verification Method: DNS TXT record (google-site-verification=...) configured in the Cloudflare slloy.com DNS zone.
  • Sitemap Submission: Submit https://slloy.com/sitemap.xml in GSC -> Sitemaps (and import into Bing Webmaster Tools via GSC One-Click Import).
  • Initial Launch Baseline & Full Multilingual Expansion:
    • During the initial 2026-09-30 GSC onboarding, sitemap scope started with the full English site plus the 14 locale homepages (~191 core URLs) to establish clean indexing without index.html redirect noise, and subsequently expanded to the full 1,904-URL multilingual baseline tracked in seo/sitemap-baseline.txt.

Automated Daily SEO Health Alert (seo-daily-alert.mts)

GitHub Actions workflow .github/workflows/seo-alert.yml runs daily at 09:30 Beijing Time (npm run seo:alert):

  1. Checks that total sitemap URL count has not drifted by > 10%.
  2. Samples 60 live sitemap URLs and alerts if 404 rate exceeds 5%.
  3. Samples 60 legacy .html URLs from seo/legacy-redirects.csv and verifies that 301 redirects remain alive.
  4. Supports offline GSC Performance CSV ingestion (npm run seo:alert -- --gsc "<report.csv>") to detect day-over-day impression drops.

On this page