Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

docs: improve SEO for docs homepage#16

Open
ekline[bot] wants to merge 1 commit into
main from
docs/seo-review-2026年04月02日
Open

docs: improve SEO for docs homepage #16
ekline[bot] wants to merge 1 commit into
main from
docs/seo-review-2026年04月02日

Conversation

@ekline

@ekline ekline Bot commented Apr 2, 2026

Copy link
Copy Markdown
Contributor

Context

This PR addresses an SEO issue identified by auditing the Fastn documentation against the company's keyword strategy derived from fastn.ai.

Keyword map

Extracted from the marketing website:

  • Primary keywords: embedded integration platform, AI agent integrations, unified context layer, adaptive context
  • Secondary keywords: tool orchestration for AI agents, managed OAuth integrations, multi-tenant integration platform, MCP gateway, workflow automation platform, SaaS integration infrastructure
  • Audience terms: SaaS companies, AI agent builders, developers, engineering teams

Top 3 findings

Rank Priority Page Issue Proposed fix
1 High README.md (homepage) Missing title in frontmatter — the most important page has no title field, so search engines fall back to the H1 which lacks product context Add keyword-optimized title to frontmatter
2 High ucl-unified-context-layer/getting-started/README.md Missing title in frontmatter — UCL landing page loses ranking potential for flagship product keywords Add title with UCL and AI agent keywords
3 Medium README.md (homepage) Heading hierarchy violation — H1 jumps to H3, weakening topic structure signals Change ### to ##

What this PR fixes

Finding #1: Added title: "Fastn docs — embedded integration platform for AI agents" to the docs homepage frontmatter. This is the single highest-impact SEO change because:

  • The homepage is the most crawled and linked-to page
  • The title tag is the strongest on-page ranking signal
  • The title now includes the primary keyword "embedded integration platform for AI agents", aligning with the marketing site's positioning

Remaining items

  • Tutorial: Your first embedded integration widget #2 (High): Add title to UCL getting started page with keywords like "AI agent integrations" and "unified context layer"
  • Tutorial: Build your first flow #3 (Medium): Fix heading hierarchy on homepage (##### for "Integrate Instantly with 1000+ Connectors")
  • Broader: 74 files across the docs are missing title frontmatter; 60+ are missing description. A follow-up effort should systematically add keyword-aligned metadata to all pages.

How to verify

  1. Check the updated frontmatter in README.md renders correctly on GitBook
  2. Confirm the title appears in the browser tab and search engine preview
  3. Validate with any SEO preview tool (e.g., Google Search Console, Ahrefs) that the title and description display correctly in SERPs

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

0 participants

AltStyle によって変換されたページ (->オリジナル) /