Skip to content

SEO: harden ArSonKuPik site-name signals for Google #41

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
masarray merged 2 commits into from
Sep 12, 2026
Merged

SEO: harden ArSonKuPik site-name signals for Google #41

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
aaad67c
seo: harden Google site name signals
masarray Sep 12, 2026
e04b6a7
test: lock ArSonKuPik site name contract
masarray Sep 12, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion site/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,8 @@
"inLanguage": "en",
"alternateName": [
"ArSonKuPik VST",
"Mas Ari Audio Enhancer"
"ArSonKuPik Audio Enhancer",
"arsonkupik.pages.dev"
]
},
{
Expand Down
18 changes: 16 additions & 2 deletions tools/validate-seo.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,8 @@
ROOT = "https://arsonkupik.pages.dev/"
SOCIAL = ROOT + "assets/arsonkupik-guide-social-1200x630.png"
WEBSITE_ID = ROOT + "#website"
SITE_NAME = "ArSonKuPik"
SITE_NAME_ALTERNATES = ["ArSonKuPik VST", "ArSonKuPik Audio Enhancer", "arsonkupik.pages.dev"]
NS = "http://www.sitemaps.org/schemas/sitemap/0.9"

PAGES = [
Expand Down Expand Up @@ -180,8 +182,9 @@ def validate_page(root: Path, spec, global_types: Counter[str]) -> None:
}
for key, expected in expected_props.items():
require(one(parser.props.get(key, []), key, url) == expected, f"{key} mismatch: {url}")
for key in ("og:title", "og:description", "og:image:alt", "og:site_name", "og:locale"):
for key in ("og:title", "og:description", "og:image:alt", "og:locale"):
require(bool(one(parser.props.get(key, []), key, url)), f"empty {key}: {url}")
require(one(parser.props.get("og:site_name", []), "og:site_name", url) == SITE_NAME, f"og:site_name mismatch: {url}")

expected_meta = {
"twitter:card": "summary_large_image",
Expand All @@ -196,6 +199,17 @@ def validate_page(root: Path, spec, global_types: Counter[str]) -> None:
global_types.update(types)
require(required_types.issubset(types), f"schema {sorted(required_types)} missing at {url}; got {sorted(types)}")

website_nodes = nodes_of_type(parser.json_ld, "WebSite")
if url == ROOT:
require(len(website_nodes) == 1, f"expected one WebSite node on homepage, got {len(website_nodes)}")
website = website_nodes[0]
require(website.get("@id") == WEBSITE_ID, "WebSite @id mismatch")
require(website.get("url") == ROOT, "WebSite url mismatch")
require(website.get("name") == SITE_NAME, "WebSite name mismatch")
require(website.get("alternateName") == SITE_NAME_ALTERNATES, "WebSite alternateName preference mismatch")
else:
require(not website_nodes, f"WebSite entity must only exist on the domain root: {url}")

for node in nodes_of_type(parser.json_ld, "WebPage"):
is_part_of = node.get("isPartOf")
require(
Expand Down Expand Up @@ -301,7 +315,7 @@ def main() -> int:

print(
"[PASS] 14 canonical pages satisfy P0 indexing/runtime guards and P1/P2 "
"metadata, schema, social-image, sitemap and release contracts."
"metadata, schema, site-name, social-image, sitemap and release contracts."
)
return 0

Expand Down