Skip to content

docs: add unique SEO titles & descriptions to AI provider pages#9702

Open
kilo-code-bot[bot] wants to merge 1 commit intomainfrom
docs/seo-titles-ai-providers
Open

docs: add unique SEO titles & descriptions to AI provider pages#9702
kilo-code-bot[bot] wants to merge 1 commit intomainfrom
docs/seo-titles-ai-providers

Conversation

@kilo-code-bot
Copy link
Copy Markdown
Contributor

@kilo-code-bot kilo-code-bot Bot commented Apr 29, 2026

Summary

Every page under /docs/ai-providers/* was rendering the generic site-wide <title>Kilo Code Documentation</title> in the browser tab and SERP. These pages already rank at Position 5–8 in Google search results — giving them unique, descriptive, keyword-rich titles is the lowest-effort/highest-return SEO change available.

Root cause

packages/kilo-docs/pages/_app.tsx falls back to the constant TITLE = "Kilo Code Documentation" whenever markdoc.frontmatter.title is missing:

let title = TITLE
if (markdoc?.frontmatter.title) title = markdoc.frontmatter.title

31 of the 35 AI provider markdown files only had sidebar_label: in their frontmatter — no title — so they all shared the same generic tab title and meta <title>.

What changed

Added a title and description field to the frontmatter of every AI provider doc page. No body content was modified.

  • Title format: Use <Provider> with Kilo Code (or Run Local LLMs with <Provider> in Kilo Code for Ollama/LM Studio), each ≤ 60 characters.
  • Description: one-sentence summary, ~100–150 characters, focused on user search intent ("how to use X with Kilo Code" / "X API key setup").
  • Existing sidebar_label and keywords entries are preserved.
  • index.md already had a title; it was left untouched.

Files changed (34)

File New title
anthropic.md Use Anthropic Claude with Kilo Code
bedrock.md Use AWS Bedrock Models with Kilo Code
cerebras.md Use Cerebras Fast Inference with Kilo Code
chutes-ai.md Use Chutes AI with Kilo Code
claude-code.md Use Claude Code Subscription with Kilo Code
deepseek.md Use DeepSeek (V3, R1) with Kilo Code
fireworks.md Use Fireworks AI with Kilo Code
gemini.md Use Google Gemini with Kilo Code
glama.md Use Glama with Kilo Code
groq.md Use Groq LPU Inference with Kilo Code
human-relay.md Use the Human Relay Provider in Kilo Code
inception.md Use Inception Labs Models with Kilo Code
kilocode.md Use the Kilo Code Built-in Provider
lmstudio.md Run Local LLMs with LM Studio in Kilo Code
minimax.md Use MiniMax Models with Kilo Code
mistral.md Use Mistral AI with Kilo Code
moonshot.md Use Moonshot Kimi Models with Kilo Code
ollama.md Run Local LLMs with Ollama in Kilo Code
openai-chatgpt-plus-pro.md Use ChatGPT Plus/Pro Subscription in Kilo Code
openai-compatible.md Use OpenAI-Compatible Providers with Kilo Code
openai.md Use OpenAI GPT Models with Kilo Code
openrouter.md Use OpenRouter with Kilo Code
ovhcloud.md Use OVHcloud AI Endpoints with Kilo Code
requesty.md Use Requesty with Kilo Code
sap-ai-core.md Use SAP AI Core with Kilo Code
synthetic.md Use Synthetic with Kilo Code
unbound.md Use Unbound with Kilo Code
v0.md Use Vercel v0 Models with Kilo Code
vercel-ai-gateway.md Use Vercel AI Gateway with Kilo Code
vertex.md Use Google Cloud Vertex AI with Kilo Code
virtual-quota-fallback.md Virtual Quota Fallback Provider in Kilo Code
vscode-lm.md Use VS Code Language Model API with Kilo Code
xai.md Use xAI Grok Models with Kilo Code
zenmux.md Use ZenMux with Kilo Code

All files live under packages/kilo-docs/pages/ai-providers/.

Rationale

  • SEO — unique titles per AI provider page. Unique <title> tags are a primary ranking signal; sharing one across 35 high-intent pages dilutes every one of them.
  • Matches search intent. Titles lead with "Use <Provider>" / "Run Local LLMs with…" — matching the phrasing of queries like "use anthropic with kilo code" and "ollama kilo code setup".
  • Adds meta descriptions so Google has a high-quality snippet to display instead of auto-extracting body text.

Not in scope

  • Page bodies, navigation, or routing — untouched.
  • index.md — already has a title and description.
  • Keyword frontmatter — only vercel-ai-gateway.md had it and it is preserved.

Built for Job Rietbergen by Kilo for Slack

All 34 AI provider docs pages under /docs/ai-providers/* previously
rendered the generic site-wide title 'Kilo Code Documentation' because
their frontmatter lacked a `title` field. Since _app.tsx only overrides
the default when `markdoc.frontmatter.title` is set, every provider
page shared the same <title> tag — hurting search rankings despite
these pages already ranking on page 1.

This adds a unique, SEO-focused `title` and `description` per page,
all under the 60-character title limit. Existing `sidebar_label` and
`keywords` frontmatter keys are preserved. Page bodies are untouched.
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 29, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs (docs-staging) Ready Ready Preview, Comment Apr 29, 2026 2:36pm

Request Review

@kilo-code-bot
Copy link
Copy Markdown
Contributor Author

kilo-code-bot Bot commented Apr 29, 2026

Code Review Summary

Status: No Issues Found | Recommendation: Merge

Files Reviewed (34 files)
  • packages/kilo-docs/pages/ai-providers/anthropic.md
  • packages/kilo-docs/pages/ai-providers/bedrock.md
  • packages/kilo-docs/pages/ai-providers/cerebras.md
  • packages/kilo-docs/pages/ai-providers/chutes-ai.md
  • packages/kilo-docs/pages/ai-providers/claude-code.md
  • packages/kilo-docs/pages/ai-providers/deepseek.md
  • packages/kilo-docs/pages/ai-providers/fireworks.md
  • packages/kilo-docs/pages/ai-providers/gemini.md
  • packages/kilo-docs/pages/ai-providers/glama.md
  • packages/kilo-docs/pages/ai-providers/groq.md
  • packages/kilo-docs/pages/ai-providers/human-relay.md
  • packages/kilo-docs/pages/ai-providers/inception.md
  • packages/kilo-docs/pages/ai-providers/kilocode.md
  • packages/kilo-docs/pages/ai-providers/lmstudio.md
  • packages/kilo-docs/pages/ai-providers/minimax.md
  • packages/kilo-docs/pages/ai-providers/mistral.md
  • packages/kilo-docs/pages/ai-providers/moonshot.md
  • packages/kilo-docs/pages/ai-providers/ollama.md
  • packages/kilo-docs/pages/ai-providers/openai-chatgpt-plus-pro.md
  • packages/kilo-docs/pages/ai-providers/openai-compatible.md
  • packages/kilo-docs/pages/ai-providers/openai.md
  • packages/kilo-docs/pages/ai-providers/openrouter.md
  • packages/kilo-docs/pages/ai-providers/ovhcloud.md
  • packages/kilo-docs/pages/ai-providers/requesty.md
  • packages/kilo-docs/pages/ai-providers/sap-ai-core.md
  • packages/kilo-docs/pages/ai-providers/synthetic.md
  • packages/kilo-docs/pages/ai-providers/unbound.md
  • packages/kilo-docs/pages/ai-providers/v0.md
  • packages/kilo-docs/pages/ai-providers/vercel-ai-gateway.md
  • packages/kilo-docs/pages/ai-providers/vertex.md
  • packages/kilo-docs/pages/ai-providers/virtual-quota-fallback.md
  • packages/kilo-docs/pages/ai-providers/vscode-lm.md
  • packages/kilo-docs/pages/ai-providers/xai.md
  • packages/kilo-docs/pages/ai-providers/zenmux.md

Reviewed by gpt-5.5-2026-04-23 · 486,872 tokens

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.

0 participants