Skip to content

SEO: rewrite page-1 zero-click snippets + overlay comparison article + FAQ schema#57

Open
philip638 wants to merge 1 commit into
pilot-protocol:mainfrom
philip638:seo/snippet-rewrites-and-overlay-comparison
Open

SEO: rewrite page-1 zero-click snippets + overlay comparison article + FAQ schema#57
philip638 wants to merge 1 commit into
pilot-protocol:mainfrom
philip638:seo/snippet-rewrites-and-overlay-comparison

Conversation

@philip638

Copy link
Copy Markdown

Why

From the latest GSC export (3-mo window): page-1 blog posts are pulling impressions but ~0 clicks — a snippet/CTR problem, not a ranking problem. Separately, VPN-comparison queries (nebula vs tailscale, tailscale vs nebula, headscale vs nebula, zerotier vs tailscale) rank page-1 with 0 clicks and no dedicated page (~120+ combined impressions).

This is the first "fix-the-leaks" batch: highest leverage, lowest risk.

What's in here

1. Snippet rewrites (8 posts, pos ~7–13, near-zero CTR) — outcome-led <title> + <meta description> that restate the query intent and promise a deliverable (code/guide). Page meta comes from each post's BlogLayout props; blogPosts.ts titles synced so listing/related cards match each article's H1 (kept the existing stat-driven card descriptions).

  • replace-webhooks-with-persistent-agent-tunnels
  • peer-to-peer-agent-communication-no-server
  • persistent-addresses-distributed-autonomous-systems
  • mcp-plus-pilot-tools-and-network
  • encrypted-data-exchange-for-decentralized-ai-systems
  • why-ai-agents-need-network-stack
  • move-beyond-rest-persistent-connections-for-agents
  • connect-agents-across-aws-gcp-azure-without-vpn

2. New articlepilot-vs-tailscale-nebula-zerotier-ai-agents. Fair, accurate architecture comparison + decision guide (comparison table, "which should you choose", honest "Pilot isn't a VPN" framing). Targets the comparison cluster above. SVG banner committed so the card/OG image resolve (swap for a real banner anytime).

3. FAQ schema capabilityBlogLayout gains an optional faqItems prop that renders a visible FAQ section and FAQPage JSON-LD (for AI Overviews). Posts that don't pass it are unchanged. Used by the new article; ready to roll out to the top-6 posts in a follow-up.

Verification

  • npm run build ✓ (191 pages) · npm run check:plain ✓ (no orphans)
  • New article's Article + BreadcrumbList + FAQPage JSON-LD all parse as valid JSON
  • New article present in generated sitemap

Note on the .html duplicates

The GSC report flagged .html vs clean-URL cannibalization. Those URLs already 308-redirect to the clean path at the edge (verified live), so I did not add redirect config — Google will consolidate on recrawl. Flagging in case you'd prefer an explicit _redirects rule anyway.

🤖 Generated with Claude Code

… schema

Targets the GSC finding that page-1 blog posts earn impressions but ~0
clicks (snippet problem, not ranking) and that VPN-comparison queries
(nebula vs tailscale, etc.) rank page-1 with no dedicated page.

Snippet rewrites (title/description) on 8 page-1 / near-page-1 posts that
were ranking pos 7-13 with near-zero CTR. Outcome-led titles + descriptions
that restate the query intent and promise a deliverable. blogPosts.ts titles
synced so listing/related cards match each article H1.

New article: pilot-vs-tailscale-nebula-zerotier-ai-agents — fair, accurate
architecture comparison + decision guide. Captures the nebula/tailscale/
zerotier comparison cluster (120+ impressions, page-1, 0 clicks today).
Includes a comparison table and an FAQ block answering the GEO-style queries.

BlogLayout: new optional `faqItems` prop renders a visible FAQ section plus
FAQPage JSON-LD (for AI Overviews). No change to posts that don't pass it.

Note for reviewer: the .html duplicate URLs flagged in the GSC report
already 308-redirect to clean URLs at the edge, so no redirect config was
added — Google will consolidate on recrawl.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants