From 2888a4ae992e013b2cdf0de18d31e0c729c8089b Mon Sep 17 00:00:00 2001 From: sonpiaz Date: Sun, 15 Nov 2026 20:14:06 -0800 Subject: [PATCH 1/2] feat: separate search snippet for blog posts Add an optional metaDescription (max 160) to the blog schema. The meta, Open Graph, Twitter and JSON-LD descriptions use it; the line under the H1, the /blog card and the .md twin keep description. Set it on 14 posts and assert both in the agent-surface check. Co-Authored-By: Claude Opus 5.5 --- content/blog/best-affiliate-software-saas.mdx | 1 + content/blog/dub-vs-partnerstack.mdx | 1 + content/blog/dub-vs-tolt.mdx | 1 + content/blog/firstpromoter-alternatives.mdx | 1 + content/blog/firstpromoter-vs-dub.mdx | 1 + .../how-to-start-saas-affiliate-program.mdx | 1 + content/blog/partnerstack-alternatives.mdx | 1 + content/blog/partnerstack-vs-rewardful.mdx | 1 + content/blog/rewardful-alternatives.mdx | 1 + content/blog/rewardful-vs-dub.mdx | 1 + content/blog/rewardful-vs-firstpromoter.mdx | 1 + content/blog/stripe-affiliate-program.mdx | 1 + content/blog/tolt-alternatives.mdx | 1 + content/blog/tolt-vs-rewardful.mdx | 1 + scripts/check-agent-surface.mjs | 22 +++++++++++++++++++ source.config.ts | 3 +++ src/app/blog/[slug]/page.tsx | 10 ++++----- 17 files changed, 44 insertions(+), 5 deletions(-) diff --git a/content/blog/best-affiliate-software-saas.mdx b/content/blog/best-affiliate-software-saas.mdx index c1171f4e..e00acc7f 100644 --- a/content/blog/best-affiliate-software-saas.mdx +++ b/content/blog/best-affiliate-software-saas.mdx @@ -1,6 +1,7 @@ --- title: "Best Affiliate Software for SaaS 2026: Pricing, Fees and 19 Tools Compared (Checked Oct 2026)" description: "Which affiliate software to choose for a SaaS, checked against each vendor's own pricing page in October 2026: what 19 tools cost before the first sale and after a program earns, which have no monthly fee and how their free plans are capped, what a second program costs, and who brings the affiliates." +metaDescription: "Best affiliate software for SaaS: what 19 tools cost before and after the first sale and who brings affiliates, including Affitor at $0 until $10K." date: "2026-07-05" updated: "2026-11-12" category: "Comparison" diff --git a/content/blog/dub-vs-partnerstack.mdx b/content/blog/dub-vs-partnerstack.mdx index a31e9ae1..d8858b6e 100644 --- a/content/blog/dub-vs-partnerstack.mdx +++ b/content/blog/dub-vs-partnerstack.mdx @@ -1,6 +1,7 @@ --- title: "Dub vs PartnerStack: Pricing, Contracts and Features Compared (Checked Oct 2026)" description: "Dub Partners publishes its prices, from $90 a month plus a 5% payout fee, and you can cancel any time. PartnerStack prices after a demo, on one-year renewing terms, and includes its partner marketplace on the entry plan. Checked on both vendors' pages on October 12, 2026." +metaDescription: "Dub vs PartnerStack: published prices from $90/month, or demo pricing on one-year terms with a partner marketplace, and where Affitor ($0 until $10K) fits." date: "2026-10-13" updated: "2026-10-17" category: "Comparison" diff --git a/content/blog/dub-vs-tolt.mdx b/content/blog/dub-vs-tolt.mdx index 3f5429d2..da390119 100644 --- a/content/blog/dub-vs-tolt.mdx +++ b/content/blog/dub-vs-tolt.mdx @@ -1,6 +1,7 @@ --- title: "Dub vs Tolt: Pricing, Payout Fees and Features Compared (Checked Oct 2026)" description: "Tolt starts at $99 a month for up to $20,000 a month in affiliate revenue, with unlimited affiliates and automatic payouts on every plan, plus a 2% fee. Dub Partners starts at $90 a month plus a 5% payout fee, and sends payouts and handles tax forms on that plan. Checked on both pricing pages on October 12, 2026; Tolt re-checked November 12, 2026." +metaDescription: "Dub vs Tolt: $90/month plus a 5% payout fee with tax forms handled, or $99/month plus a 2% fee with automatic payouts, and where Affitor ($0 until $10K) fits." date: "2026-10-13" updated: "2026-11-12" category: "Comparison" diff --git a/content/blog/firstpromoter-alternatives.mdx b/content/blog/firstpromoter-alternatives.mdx index 8168a216..d64f3407 100644 --- a/content/blog/firstpromoter-alternatives.mdx +++ b/content/blog/firstpromoter-alternatives.mdx @@ -1,6 +1,7 @@ --- title: "Best FirstPromoter Alternatives for SaaS in 2026 (5 Tools Compared)" description: "Five honest FirstPromoter alternatives for SaaS: Affitor, Rewardful, Tolt, Dub Partners, and PartnerStack. Pricing checked October 2026, attribution trade-offs, and a straight answer on who should pick what." +metaDescription: "Five honest FirstPromoter alternatives for SaaS: Affitor ($0 until $10K), Rewardful, Tolt, Dub and PartnerStack. Its $5K revenue cap and who should pick what." date: "2026-07-05" updated: "2026-11-12" category: Comparison diff --git a/content/blog/firstpromoter-vs-dub.mdx b/content/blog/firstpromoter-vs-dub.mdx index dc38696e..0a5b42fc 100644 --- a/content/blog/firstpromoter-vs-dub.mdx +++ b/content/blog/firstpromoter-vs-dub.mdx @@ -1,6 +1,7 @@ --- title: "FirstPromoter vs Dub: Pricing, Fees and Features Compared (Checked Oct 2026)" description: "FirstPromoter starts at $49 a month with no fees listed and native support for five billing systems. Dub Partners starts at $90 a month plus a 5% payout fee, and sends payouts and handles tax forms on that plan. Checked on both pricing pages on October 12, 2026." +metaDescription: "FirstPromoter vs Dub: $49/month with no fees listed, or $90/month plus a 5% payout fee with tax forms handled, and where Affitor ($0 until $10K) fits." date: "2026-10-13" updated: "2026-10-17" category: "Comparison" diff --git a/content/blog/how-to-start-saas-affiliate-program.mdx b/content/blog/how-to-start-saas-affiliate-program.mdx index bd1a97de..f8d771a9 100644 --- a/content/blog/how-to-start-saas-affiliate-program.mdx +++ b/content/blog/how-to-start-saas-affiliate-program.mdx @@ -1,6 +1,7 @@ --- title: "How to Start an Affiliate Program for Your SaaS (Step-by-Step Guide 2026)" description: "Six steps take you from no program to your first partner payout: commission, software, tracking, recruiting, payout terms, and what to measure, with 2026 benchmarks and pricing checked October 2026." +metaDescription: "Start a SaaS affiliate program in six steps: set a 20–25% commission, pick software (Affitor is $0 until $10K), hand-recruit 5–20 partners, measure for 90 days." date: '2026-07-05' updated: '2026-11-12' category: Guide diff --git a/content/blog/partnerstack-alternatives.mdx b/content/blog/partnerstack-alternatives.mdx index ca396a51..a1107e73 100644 --- a/content/blog/partnerstack-alternatives.mdx +++ b/content/blog/partnerstack-alternatives.mdx @@ -1,6 +1,7 @@ --- title: "Best PartnerStack Alternatives in 2026 (5 Tools Compared)" description: "PartnerStack does not publish its prices: every plan is priced during a demo. Here is what its plans include, who should pay for it, and five self-serve alternatives with pricing checked in October 2026." +metaDescription: "Best PartnerStack alternatives for small SaaS: Affitor ($0 until $10K), Rewardful, FirstPromoter, Tolt and Dub. Demo-only pricing and who should pick what." date: '2026-07-05' updated: '2026-11-12' category: Comparison diff --git a/content/blog/partnerstack-vs-rewardful.mdx b/content/blog/partnerstack-vs-rewardful.mdx index 1b645b85..4783e62e 100644 --- a/content/blog/partnerstack-vs-rewardful.mdx +++ b/content/blog/partnerstack-vs-rewardful.mdx @@ -1,6 +1,7 @@ --- title: "PartnerStack vs Rewardful: Which Should Your SaaS Pick in 2026?" description: "One prices you in a sales demo, the other starts at $49 a month: they aren't really the same tool. A straight comparison of the enterprise PRM versus the focused affiliate app, with every price checked against both pages in October 2026, plus Affitor, the $0/month option that starts where they both charge." +metaDescription: "Rewardful vs PartnerStack: a focused $49/month affiliate app or an enterprise PRM priced in a sales demo? Which fits your stage, plus Affitor at $0 until $10K." date: '2026-07-06' updated: '2026-10-17' category: Comparison diff --git a/content/blog/rewardful-alternatives.mdx b/content/blog/rewardful-alternatives.mdx index 1f1d4175..a3f71ba6 100644 --- a/content/blog/rewardful-alternatives.mdx +++ b/content/blog/rewardful-alternatives.mdx @@ -1,6 +1,7 @@ --- title: "Best Rewardful Alternatives for SaaS in 2026 (5 Tools Compared)" description: "Five honest Rewardful alternatives for SaaS on Stripe: Affitor, FirstPromoter, Tolt, Dub Partners, and PartnerStack. Pricing checked October 2026, attribution trade-offs, and a straight answer on who should pick what." +metaDescription: "Best Rewardful alternatives for SaaS on Stripe: Affitor ($0 until $10K), FirstPromoter, Tolt, Dub and PartnerStack. Rewardful's caps and who should pick what." date: "2026-07-05" updated: "2026-11-12" category: Comparison diff --git a/content/blog/rewardful-vs-dub.mdx b/content/blog/rewardful-vs-dub.mdx index 27373134..e5283943 100644 --- a/content/blog/rewardful-vs-dub.mdx +++ b/content/blog/rewardful-vs-dub.mdx @@ -1,6 +1,7 @@ --- title: "Rewardful vs Dub: Pricing, Fees and Features Compared (Checked Oct 2026)" description: "Rewardful starts at $49 a month with a 0% transaction fee and unlimited affiliates. Dub Partners starts at $90 a month plus a 5% payout fee, and sends payouts and handles tax forms on that plan. Prices, limits and features checked on both pricing pages on October 12, 2026." +metaDescription: "Rewardful vs Dub: $49/month with a 0% transaction fee, or $90/month plus a 5% payout fee with tax forms handled, and where Affitor ($0 until $10K) fits." date: "2026-10-13" updated: "2026-10-17" category: "Comparison" diff --git a/content/blog/rewardful-vs-firstpromoter.mdx b/content/blog/rewardful-vs-firstpromoter.mdx index 6f2365b7..aba063c1 100644 --- a/content/blog/rewardful-vs-firstpromoter.mdx +++ b/content/blog/rewardful-vs-firstpromoter.mdx @@ -1,6 +1,7 @@ --- title: "Rewardful vs FirstPromoter: Which Is Best for SaaS in 2026?" description: "Same $49 floor, different ceilings: revenue caps, plan limits, and billing coverage decide this one. Every number checked against both pricing pages in October 2026, plus Affitor, the $0/month option neither compare page mentions." +metaDescription: "Rewardful vs FirstPromoter: which is better for SaaS? Same $49 floor, different ceilings: revenue caps and billing coverage, plus Affitor at $0 until $10K." date: '2026-07-05' updated: '2026-10-17' category: Comparison diff --git a/content/blog/stripe-affiliate-program.mdx b/content/blog/stripe-affiliate-program.mdx index aaaeeba4..386dfd65 100644 --- a/content/blog/stripe-affiliate-program.mdx +++ b/content/blog/stripe-affiliate-program.mdx @@ -1,6 +1,7 @@ --- title: "Best Affiliate Tracking Software for Stripe in 2026 (8 Tools Compared)" description: "Eight Stripe affiliate tracking tools compared on what they read from Stripe, price, fees, revenue caps and the catch, with every price checked on October 12, 2026. Then a four-step Affitor setup that ends with a test click, signup and sale." +metaDescription: "Best affiliate tracking software for Stripe: 8 tools compared on price and fees, then a four-step setup on Affitor ($0 until $10K) that ends with a test sale." date: '2026-07-05' updated: '2026-11-12' category: Comparison diff --git a/content/blog/tolt-alternatives.mdx b/content/blog/tolt-alternatives.mdx index cd509830..067fd8f5 100644 --- a/content/blog/tolt-alternatives.mdx +++ b/content/blog/tolt-alternatives.mdx @@ -1,6 +1,7 @@ --- title: "Best Tolt Alternatives for SaaS in 2026 (5 Tools Compared)" description: "Five honest Tolt alternatives for SaaS: Affitor, Rewardful, FirstPromoter, Dub Partners, and PartnerStack. Pricing checked October 2026, the 2% payout-fee nuance, attribution trade-offs, and a straight answer on who should pick what." +metaDescription: "Five honest Tolt alternatives for SaaS: Affitor ($0 until $10K), Rewardful, FirstPromoter, Dub and PartnerStack. Tolt's 2% payout fee and who should pick what." date: "2026-07-05" updated: "2026-11-12" category: Comparison diff --git a/content/blog/tolt-vs-rewardful.mdx b/content/blog/tolt-vs-rewardful.mdx index b4d3e79c..e1dfd9ab 100644 --- a/content/blog/tolt-vs-rewardful.mdx +++ b/content/blog/tolt-vs-rewardful.mdx @@ -1,6 +1,7 @@ --- title: "Tolt vs Rewardful: Which Is Best for SaaS in 2026?" description: "Rewardful starts $50 lower; Tolt gives a third more headroom at $99 and automates global payouts. Both publish an API. Every number checked against both pricing pages in October 2026 (Tolt re-checked November 12, 2026), plus Affitor, the $0/month option neither compare page mentions." +metaDescription: "Rewardful vs Tolt: which is best for SaaS? Rewardful starts $50 lower; Tolt gives a third more headroom at $99 and automates payouts. Affitor is $0 until $10K." date: '2026-07-05' updated: '2026-11-12' category: Comparison diff --git a/scripts/check-agent-surface.mjs b/scripts/check-agent-surface.mjs index 25cbee62..873422bc 100644 --- a/scripts/check-agent-surface.mjs +++ b/scripts/check-agent-surface.mjs @@ -206,6 +206,7 @@ function inventory() { sourceDate: data.updated ?? data.date, body: markdown(data, id), date: data.date, category: data.category, title: data.title, description: data.description, + metaDescription: data.metaDescription, }; }); return [...docs, blogIndexInventory(posts), ...posts, ...changelogInventory()]; @@ -230,6 +231,25 @@ function blogIndexInventory(posts) { } /** The built /blog page: the twin link, and one CollectionPage whose ItemList is the twin's list, in order. */ +/** + * CORE-1010 P1.2: a post's search snippet may differ from its dek. The prerendered page carries + * metaDescription (or description) in , and still shows description as the dek. + */ +function checkBlogMeta(posts) { + for (const post of posts) { + const route = `/${post.id}`; + const html = read(join(APP, `${post.id}.html`)); + const metas = [...html.matchAll(/]*\bname="description"[^>]*>/g)].map((m) => m[0]); + assert.equal(metas.length, 1, `${route}: expected one meta description`); + const content = decodeEntities(metas[0].match(/\bcontent="([^"]*)"/)[1]); + const expected = post.metaDescription ?? post.description; + assert.equal(content, expected, `${route}: meta description`); + if (post.metaDescription !== undefined) assert.ok(post.metaDescription.length <= 160, `${route}: metaDescription over 160`); + assert.ok(decodeEntities(html).includes(post.description), `${route}: the dek under the H1 must stay description`); + } + return posts.filter((post) => post.metaDescription !== undefined).length; +} + function checkBlogIndexHtml(index) { const html = read(join(APP, 'blog.html')); const links = [...html.matchAll(/]*>/g)].map((match) => match[0]) @@ -562,6 +582,8 @@ function main() { console.log(`PASS tracking contract: ${contract.statements} window statements, ${contract.pins} pinned statements, ${contract.examples} sale examples carry their idempotency key; ${contract.checked} contract rules checked in the docs, ${contract.outside} outside the docs`); const openApiPaths = checkOpenApi(); const pages = inventory(); + const separateMeta = checkBlogMeta(pages.filter((page) => page.type === 'blog')); + console.log(`PASS blog meta: ${separateMeta} posts carry their own search snippet; every dek stays description`); const ids = pages.map((page) => page.id); assert.equal(new Set(ids).size, ids.length, 'Duplicate source page ids'); const manifest = json(join(ROOT, '.next/prerender-manifest.json')); diff --git a/source.config.ts b/source.config.ts index 82f15a30..06e409ec 100644 --- a/source.config.ts +++ b/source.config.ts @@ -101,6 +101,9 @@ export const blog = defineCollections({ schema: frontmatterSchema.extend({ // description doubles as the one-line dek + machine summary — required for blog description: z.string(), + // Search snippet only (meta, og, twitter, JSON-LD). The dek under the H1, the /blog card and the + // .md twin keep `description`. Falls back to `description` when absent. + metaDescription: z.string().max(160).optional(), date: z.string(), category: z.string(), authors: z.array(z.string()), diff --git a/src/app/blog/[slug]/page.tsx b/src/app/blog/[slug]/page.tsx index 0ce34789..833a54f5 100644 --- a/src/app/blog/[slug]/page.tsx +++ b/src/app/blog/[slug]/page.tsx @@ -55,7 +55,7 @@ function buildJsonLd(post: Post, slug: string) { graph.push({ '@type': 'BlogPosting', headline: post.title, - description: post.description, + description: post.metaDescription ?? post.description, datePublished: post.date, dateModified, url, @@ -110,7 +110,7 @@ function buildJsonLd(post: Post, slug: string) { graph.push({ '@type': 'HowTo', name: post.title, - description: post.description, + description: post.metaDescription ?? post.description, step: steps.map((item, i) => ({ '@type': 'HowToStep', position: i + 1, @@ -147,7 +147,7 @@ export async function generateMetadata(props: { return { // absolute: the blog lives on affitor.com, so no "| Affitor Docs" suffix. title: { absolute: `${post.title} | Affitor` }, - description: post.description, + description: post.metaDescription ?? post.description, alternates: { // Canonical home of every post is the proxied affitor.com/blog zone. canonical: `${BLOG_URL}/${slug}`, @@ -156,7 +156,7 @@ export async function generateMetadata(props: { }, openGraph: { title: post.title, - description: post.description, + description: post.metaDescription ?? post.description, type: 'article', url: `${BLOG_URL}/${slug}`, publishedTime: post.date, @@ -166,7 +166,7 @@ export async function generateMetadata(props: { twitter: { card: 'summary_large_image', title: post.title, - description: post.description, + description: post.metaDescription ?? post.description, }, }; } From c93b1447653bb192a90cbdb1328e10cd313e53fb Mon Sep 17 00:00:00 2001 From: sonpiaz Date: Sun, 15 Nov 2026 20:15:58 -0800 Subject: [PATCH 2/2] fix: blog meta check covers posts, not the blog index Co-Authored-By: Claude Opus 5.5 --- scripts/check-agent-surface.mjs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/check-agent-surface.mjs b/scripts/check-agent-surface.mjs index 873422bc..4040755e 100644 --- a/scripts/check-agent-surface.mjs +++ b/scripts/check-agent-surface.mjs @@ -582,7 +582,7 @@ function main() { console.log(`PASS tracking contract: ${contract.statements} window statements, ${contract.pins} pinned statements, ${contract.examples} sale examples carry their idempotency key; ${contract.checked} contract rules checked in the docs, ${contract.outside} outside the docs`); const openApiPaths = checkOpenApi(); const pages = inventory(); - const separateMeta = checkBlogMeta(pages.filter((page) => page.type === 'blog')); + const separateMeta = checkBlogMeta(pages.filter((page) => page.type === 'blog' && page.id.startsWith('blog/'))); console.log(`PASS blog meta: ${separateMeta} posts carry their own search snippet; every dek stays description`); const ids = pages.map((page) => page.id); assert.equal(new Set(ids).size, ids.length, 'Duplicate source page ids');