B2BEA.org Rebuild seo-geo-social-spec
seo-geo-social-spec artifact · for B2BEA.org Rebuild · status draft
seo-geo-social-spec artifact · for B2BEA.org Rebuild · status draft
No explicit evidence field yet. Require tests, screenshots, linked PRs, or reviewed outputs before marking complete.
- source: atlas-codex
- status: draft
- project: B2BEA.org Rebuild
- version: 1
- filename: docs/specs/2026-05-08-b2bea-org-seo-geo-social-spec.md
- project id: a820dd0c-6cef-4133-bfbd-d802fd806e44
- generated at: 2026-05-08
- artifact type: seo-geo-social-spec
Full legacy body rendered for humans
B2BEA.org V1 SEO GEO Social Spec
Source of record: RedKey local project artifact draft.
- Project:
B2BEA.org Rebuild - Project ID:
a820dd0c-6cef-4133-bfbd-d802fd806e44 - Artifact:
seo-geo-social-spec - Version:
1 - Status:
draft - Generated:
2026-05-08
Purpose
Define required metadata, AI/GEO readiness, sitemap/search-index inclusion, and redirect behavior for all public publishable B2BEA.org routes.
Metadata Rule
No public publishable route is release-ready without validated SEO, GEO, social, canonical, and indexability fields.
Page Family Requirements
| page_family | required_schema_type | sitemap | search_index | social_image |
| --- | --- | --- | --- | --- |
| marketing_home_or_landing | WebPage | yes | yes | required |
| standard_marketing_page | WebPage | yes | yes | required |
| audience_landing_page | WebPage | yes | yes | required |
| editorial_index | CollectionPage | yes | yes | optional default allowed |
| editorial_detail | Article or PodcastEpisode | yes if published | yes if published | required |
| resource_index | CollectionPage | yes | yes | optional default allowed |
| resource_detail_or_download | WebPage | yes if published | public preview only | required |
| directory_index | CollectionPage | yes | yes | optional default allowed |
| vendor_profile_detail | ProfilePage | yes if published | yes if published | required or fallback |
| people_profile_detail | ProfilePage | yes if public | yes if public | required or fallback |
| event_detail | Event | yes unless archived | yes unless archived | required |
| job_detail | JobPosting | yes if active | yes if active | optional default allowed |
| course_detail | Course | yes if public preview | public preview only | required |
| auth/private/admin/vendor/company/member | none | no | no | no |
Required Fields
type RouteMetadata = {
canonicalPath: string;
metaTitle: string;
metaDescription: string;
robots: 'index,follow' | 'noindex,nofollow' | 'noindex,follow';
schemaType: string;
schemaJson: Record<string, unknown>;
ogTitle: string;
ogDescription: string;
ogImage: string;
twitterCard: 'summary' | 'summary_large_image';
geo: {
aiSummary: string;
entities: string[];
audience: string[];
questionsAnswered: string[];
expertiseSignals: string[];
};
};
GEO Rules
aiSummarymust be factual and short enough for AI retrieval snippets.entitiesshould include B2BEA, relevant vendors/people/events/topics, and named organizations.questionsAnsweredshould reflect real query intent, not keyword stuffing.- Expertise signals should identify practitioners, awards, research, interviews, or source data where applicable.
Redirect Rules
- Published slug changes require a redirect before deploy.
- Removed public pages require either a canonical redirect or explicit
410decision. /studioredirects to/admin/studio./studio/mediaredirects to/admin/studio/media./vendor-portalredirects to/vendor.- Draft, preview, private, and gated download URLs do not enter sitemap.
Validation Gates
Route metadata validation fails if:
- title or description is missing
- canonical path conflicts with route registry
- public route is missing schema type
- published route has
noindexwithout approved reason - private route is indexable
- social image is missing where required
- slug changed without redirect
Acceptance Criteria
- Every public route family has metadata requirements.
- Private/protected/admin routes are excluded from sitemap/search index.
- AI/GEO fields are explicit and testable.
- Redirect requirements are known before route migration.
Machine-readable source fields
atlas-codex
draft
B2BEA.org Rebuild
1
docs/specs/2026-05-08-b2bea-org-seo-geo-social-spec.md
a820dd0c-6cef-4133-bfbd-d802fd806e44
2026-05-08
seo-geo-social-spec