From d2447f1b1a7b3244fddd1456cbb4a1e279a5996b Mon Sep 17 00:00:00 2001
From: Ray Clanan <115944+rclanan@users.noreply.github.com>
Date: Fri, 16 Oct 2026 10:00:48 -0400
Subject: [PATCH] fix(marketing): correct llms.txt CLI commands, unify homepage
 metadata, add FAQPage schema

- llms.txt: replace the nonexistent `mockforge http --spec` with
  `mockforge serve --spec`, drop the unsupported Homebrew/npm install
  claims, add the GHCR Docker command, and note that the admin UI needs
  `--admin` (it is off by default).
- Homepage: keyword-bearing title and one description across meta, Open
  Graph, Twitter and JSON-LD (reuses the existing JSON-LD wording).
- FAQ: FAQPage JSON-LD mirroring the five visible questions verbatim.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 faq.html             | 48 ++++++++++++++++++++++++++++++++++++++++++++
 index.html           | 12 +++++------
 public/llms.txt      |  8 +++++---
 src/pages/faq.html   | 48 ++++++++++++++++++++++++++++++++++++++++++++
 src/pages/index.html | 12 +++++------
 5 files changed, 113 insertions(+), 15 deletions(-)

diff --git a/faq.html b/faq.html
index f33848f..3315a39 100644
--- a/faq.html
+++ b/faq.html
@@ -8,6 +8,54 @@
     <link rel="canonical" href="https://mockforge.dev/faq.html" />
     <link rel="icon" href="/public/favicon.ico" sizes="any" />
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet" />
+    <script type="application/ld+json">
+    {
+      "@context": "https://schema.org",
+      "@type": "FAQPage",
+      "mainEntity": [
+        {
+          "@type": "Question",
+          "name": "Is MockForge open source?",
+          "acceptedAnswer": {
+            "@type": "Answer",
+            "text": "Yes. MockForge is available under MIT or Apache-2.0. See the source repository and licenses."
+          }
+        },
+        {
+          "@type": "Question",
+          "name": "Do I need a Cloud account to run it?",
+          "acceptedAnswer": {
+            "@type": "Answer",
+            "text": "You can run the CLI on your own machine without a Cloud account. Follow the installation guide to get started."
+          }
+        },
+        {
+          "@type": "Question",
+          "name": "Which API protocols can I mock?",
+          "acceptedAnswer": {
+            "@type": "Answer",
+            "text": "MockForge supports HTTP APIs, gRPC, GraphQL, WebSocket, and messaging protocols. Available commands depend on the features enabled in your build. Check the protocol documentation for setup and configuration."
+          }
+        },
+        {
+          "@type": "Question",
+          "name": "Can I use it in CI?",
+          "acceptedAnswer": {
+            "@type": "Answer",
+            "text": "Yes. Run MockForge alongside your tests and point your application at its local endpoints. Keep your specification and configuration in version control so the same setup can run locally and in CI."
+          }
+        },
+        {
+          "@type": "Question",
+          "name": "Where can I get help?",
+          "acceptedAnswer": {
+            "@type": "Answer",
+            "text": "The Support page explains how to report a bug, ask about a Cloud account, or contact the team privately."
+          }
+        }
+      ]
+    }
+    </script>
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
     <script>
diff --git a/index.html b/index.html
index 1b9861a..57e85b2 100644
--- a/index.html
+++ b/index.html
@@ -3,14 +3,14 @@
   <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <title>MockForge — A comprehensive mocking framework</title>
-    <meta name="description" content="MockForge is a comprehensive mocking framework for REST, gRPC, and WebSockets with intelligent data synthesis and a modern admin UI." />
+    <title>MockForge: open-source API mock server for REST, gRPC, WebSocket and Kafka</title>
+    <meta name="description" content="A comprehensive mocking framework for REST, gRPC, GraphQL, WebSocket, Kafka, MQTT and more. Generate realistic data, inject latency and failures, and deploy hosted mocks with a single command." />
 
     <link rel="canonical" href="https://mockforge.dev/" />
 
     <!-- Open Graph -->
-    <meta property="og:title" content="MockForge — A comprehensive mocking framework" />
-    <meta property="og:description" content="MockForge helps developers mock APIs and generate realistic data for testing and development." />
+    <meta property="og:title" content="MockForge: open-source API mock server for REST, gRPC, WebSocket and Kafka" />
+    <meta property="og:description" content="A comprehensive mocking framework for REST, gRPC, GraphQL, WebSocket, Kafka, MQTT and more. Generate realistic data, inject latency and failures, and deploy hosted mocks with a single command." />
     <meta property="og:type" content="website" />
     <meta property="og:url" content="https://mockforge.dev/" />
     <meta property="og:image" content="https://mockforge.dev/public/og-image.png" />
@@ -18,8 +18,8 @@
 
     <!-- Twitter Card -->
     <meta name="twitter:card" content="summary_large_image" />
-    <meta name="twitter:title" content="MockForge — A comprehensive mocking framework" />
-    <meta name="twitter:description" content="Mock REST, gRPC, GraphQL, WebSocket, Kafka, MQTT and more. Deploy hosted mocks with a single command." />
+    <meta name="twitter:title" content="MockForge: open-source API mock server for REST, gRPC, WebSocket and Kafka" />
+    <meta name="twitter:description" content="A comprehensive mocking framework for REST, gRPC, GraphQL, WebSocket, Kafka, MQTT and more. Generate realistic data, inject latency and failures, and deploy hosted mocks with a single command." />
     <meta name="twitter:image" content="https://mockforge.dev/public/og-image.png" />
 
     <link rel="icon" href="/public/favicon.ico" sizes="any">
diff --git a/public/llms.txt b/public/llms.txt
index 81c738a..1201175 100644
--- a/public/llms.txt
+++ b/public/llms.txt
@@ -17,14 +17,16 @@
 
 ## How an agent should use it
 
-- Install the CLI (`cargo install mockforge-cli`, Homebrew, npm SDKs, or Docker) and run `mockforge http --spec <openapi-file>` to serve a mock from an OpenAPI spec. See https://docs.mockforge.dev for all protocols and flags.
-- The admin UI runs by default; every behavior is also scriptable over HTTP and config files (`mockforge.yaml`), so agents can drive it without a browser.
+- Install the CLI with `cargo install mockforge-cli` (installs the `mockforge` binary), or use the container image `ghcr.io/saasy-solutions/mockforge:latest`. Installation guide: https://docs.mockforge.dev/getting-started/installation.html
+- Serve a mock from an OpenAPI spec: `mockforge serve --spec <openapi-file> --http-port 3000`. With Docker: `docker run --rm -p 3000:3000 -v "$PWD":/work ghcr.io/saasy-solutions/mockforge:latest serve --spec /work/<openapi-file> --http-port 3000`. Run `mockforge serve --help` for protocol ports (`--grpc-port`, `--ws-port`, `--graphql-port`, `--kafka-port`, `--mqtt-port`, `--smtp-port`) and other flags; see https://docs.mockforge.dev for all protocols.
+- The admin UI is off by default; add `--admin` (default port 9080) to enable it. Every behavior is also scriptable over HTTP and config files (`mockforge.yaml`), so agents can drive it without a browser.
 - Config is declarative: generate or edit a `mockforge.yaml` rather than clicking through the UI.
 
 ## Docs
 
 - Documentation home: https://docs.mockforge.dev
-- Installation & quickstart: https://docs.mockforge.dev
+- Installation: https://docs.mockforge.dev/getting-started/installation.html
+- Quick start: https://docs.mockforge.dev/getting-started/quick-start.html
 - Configuration reference: https://docs.mockforge.dev/configuration/environment.html
 
 ## Site
diff --git a/src/pages/faq.html b/src/pages/faq.html
index 0c26e2d..45e6c2b 100644
--- a/src/pages/faq.html
+++ b/src/pages/faq.html
@@ -8,6 +8,54 @@
     <link rel="canonical" href="https://mockforge.dev/faq.html" />
     <link rel="icon" href="/public/favicon.ico" sizes="any" />
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet" />
+    <script type="application/ld+json">
+    {
+      "@context": "https://schema.org",
+      "@type": "FAQPage",
+      "mainEntity": [
+        {
+          "@type": "Question",
+          "name": "Is MockForge open source?",
+          "acceptedAnswer": {
+            "@type": "Answer",
+            "text": "Yes. MockForge is available under MIT or Apache-2.0. See the source repository and licenses."
+          }
+        },
+        {
+          "@type": "Question",
+          "name": "Do I need a Cloud account to run it?",
+          "acceptedAnswer": {
+            "@type": "Answer",
+            "text": "You can run the CLI on your own machine without a Cloud account. Follow the installation guide to get started."
+          }
+        },
+        {
+          "@type": "Question",
+          "name": "Which API protocols can I mock?",
+          "acceptedAnswer": {
+            "@type": "Answer",
+            "text": "MockForge supports HTTP APIs, gRPC, GraphQL, WebSocket, and messaging protocols. Available commands depend on the features enabled in your build. Check the protocol documentation for setup and configuration."
+          }
+        },
+        {
+          "@type": "Question",
+          "name": "Can I use it in CI?",
+          "acceptedAnswer": {
+            "@type": "Answer",
+            "text": "Yes. Run MockForge alongside your tests and point your application at its local endpoints. Keep your specification and configuration in version control so the same setup can run locally and in CI."
+          }
+        },
+        {
+          "@type": "Question",
+          "name": "Where can I get help?",
+          "acceptedAnswer": {
+            "@type": "Answer",
+            "text": "The Support page explains how to report a bug, ask about a Cloud account, or contact the team privately."
+          }
+        }
+      ]
+    }
+    </script>
     {{SHARED_HEAD_BLOCK}}
   </head>
   <body class="bg-surface-subtle text-text-primary antialiased">
diff --git a/src/pages/index.html b/src/pages/index.html
index f2859b1..8561f43 100644
--- a/src/pages/index.html
+++ b/src/pages/index.html
@@ -3,14 +3,14 @@
   <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <title>MockForge — A comprehensive mocking framework</title>
-    <meta name="description" content="MockForge is a comprehensive mocking framework for REST, gRPC, and WebSockets with intelligent data synthesis and a modern admin UI." />
+    <title>MockForge: open-source API mock server for REST, gRPC, WebSocket and Kafka</title>
+    <meta name="description" content="A comprehensive mocking framework for REST, gRPC, GraphQL, WebSocket, Kafka, MQTT and more. Generate realistic data, inject latency and failures, and deploy hosted mocks with a single command." />
 
     <link rel="canonical" href="https://mockforge.dev/" />
 
     <!-- Open Graph -->
-    <meta property="og:title" content="MockForge — A comprehensive mocking framework" />
-    <meta property="og:description" content="MockForge helps developers mock APIs and generate realistic data for testing and development." />
+    <meta property="og:title" content="MockForge: open-source API mock server for REST, gRPC, WebSocket and Kafka" />
+    <meta property="og:description" content="A comprehensive mocking framework for REST, gRPC, GraphQL, WebSocket, Kafka, MQTT and more. Generate realistic data, inject latency and failures, and deploy hosted mocks with a single command." />
     <meta property="og:type" content="website" />
     <meta property="og:url" content="https://mockforge.dev/" />
     <meta property="og:image" content="https://mockforge.dev/public/og-image.png" />
@@ -18,8 +18,8 @@
 
     <!-- Twitter Card -->
     <meta name="twitter:card" content="summary_large_image" />
-    <meta name="twitter:title" content="MockForge — A comprehensive mocking framework" />
-    <meta name="twitter:description" content="Mock REST, gRPC, GraphQL, WebSocket, Kafka, MQTT and more. Deploy hosted mocks with a single command." />
+    <meta name="twitter:title" content="MockForge: open-source API mock server for REST, gRPC, WebSocket and Kafka" />
+    <meta name="twitter:description" content="A comprehensive mocking framework for REST, gRPC, GraphQL, WebSocket, Kafka, MQTT and more. Generate realistic data, inject latency and failures, and deploy hosted mocks with a single command." />
     <meta name="twitter:image" content="https://mockforge.dev/public/og-image.png" />
 
     <link rel="icon" href="/public/favicon.ico" sizes="any">