Getting Started

Installation & Setup

Set up CleverSearch in minutes and prepare your site for LLM optimization.

Prerequisites

Make sure these basics are in place before installing.

Required

Account & Workspace

Create your CleverSearch workspace and add your site domain.

Required

Site Access

Ability to edit your website header or deployment pipeline.

Recommended

Baseline Content

Existing pages or a sitemap to analyze and optimize.

Install in 3 Steps

Follow these steps to connect your site and begin optimizing.

Add the tracker script

Install the lightweight tracker to enable content injection and analytics.

<script
  src="https://backend.cleversearch.ai/tracker/v1/tracker.js"
  async
  defer
  data-config='{"SITE_ID": "your-site-id"}'
></script>

Set environment variables

Store keys in your deployment environment instead of hardcoding credentials.

CLEVERSEARCH_SITE_ID=your-site-id
CLEVERSEARCH_PUBLIC_KEY=pk_live_...

Import your sitemap

Provide a sitemap URL to discover pages and create optimization tasks.

Example: https://example.com/sitemap.xml

Next.js Install Example

If your site runs on Next.js, add the tracker in the root layout.

// app/layout.tsx
import Script from "next/script";

export default function RootLayout({ children }: { children: React.ReactNode }) {
  return (
    <html lang="en">
      <body>
        {children}
        <Script
          src="https://backend.cleversearch.ai/tracker/v1/tracker.js"
          strategy="afterInteractive"
          data-config='{"SITE_ID":"your-site-id"}'
        />
      </body>
    </html>
  );
}

Go Live Checklist

Confirm these items to finish your initial setup.

●Tracker installed on all production pages

●Sitemap imported and validated

●First analysis scheduled

●Injection rules reviewed

Post-Install Validation

Run these checks before enabling automation rules in production.

●The tracker request appears in browser network logs

●Your site appears as connected in Settings -> Tracker

●Your sitemap URLs are discovered with no parsing errors

●First analysis result includes page score + recommendations

Setup Rollout Guidance

Use a staged rollout to avoid production surprises during installation.

●Install tracker in staging first and confirm requests load on all templates.

●Validate sitemap parsing and URL discovery before production launch.

●Create a baseline analysis report before enabling any automated injection.

●Set owner alerts for tracker disconnects and import failures.

Execution Phases

Week 1: Foundation

Finish installation and validate data flow.

Output: Connected tracker, imported sitemap, baseline analysis report.

Week 2: Prioritization

Select high-impact pages and define task backlog.

Output: Prioritized optimization list with owners and due dates.

Week 3-4: Iteration

Ship updates and verify score + business impact.

Output: Before/after snapshots with measurable deltas.

Common Mistakes

●Starting automation before validating tracker and sitemap integrity.

●Treating overall score as the only KPI and ignoring category gaps.

●Rolling out broad template changes without controlled testing.

●Skipping documentation of changes, making results hard to attribute.

Success Metrics

Analyzed Coverage

>= 90% priority URLs analyzed monthly

Ensures optimization decisions are based on current data.

Score Movement

+8 to +15 points on target templates in 30-60 days

Validates that executed recommendations are improving quality.

Execution Velocity

At least 1 improvement cycle per week

Creates compounding gains from consistent iteration.

Getting Started

Installation & Setup

Set up CleverSearch in minutes and prepare your site for LLM optimization.

Prerequisites

Make sure these basics are in place before installing.

Required

Account & Workspace

Create your CleverSearch workspace and add your site domain.

Required

Site Access

Ability to edit your website header or deployment pipeline.

Recommended

Baseline Content

Existing pages or a sitemap to analyze and optimize.

Install in 3 Steps

Follow these steps to connect your site and begin optimizing.

Add the tracker script

Install the lightweight tracker to enable content injection and analytics.

<script
  src="https://backend.cleversearch.ai/tracker/v1/tracker.js"
  async
  defer
  data-config='{"SITE_ID": "your-site-id"}'
></script>

Set environment variables

Store keys in your deployment environment instead of hardcoding credentials.

CLEVERSEARCH_SITE_ID=your-site-id
CLEVERSEARCH_PUBLIC_KEY=pk_live_...

Import your sitemap

Provide a sitemap URL to discover pages and create optimization tasks.

Example: https://example.com/sitemap.xml

Next.js Install Example

If your site runs on Next.js, add the tracker in the root layout.

// app/layout.tsx
import Script from "next/script";

export default function RootLayout({ children }: { children: React.ReactNode }) {
  return (
    <html lang="en">
      <body>
        {children}
        <Script
          src="https://backend.cleversearch.ai/tracker/v1/tracker.js"
          strategy="afterInteractive"
          data-config='{"SITE_ID":"your-site-id"}'
        />
      </body>
    </html>
  );
}

Go Live Checklist

Confirm these items to finish your initial setup.

●Tracker installed on all production pages

●Sitemap imported and validated

●First analysis scheduled

●Injection rules reviewed

Post-Install Validation

Run these checks before enabling automation rules in production.

●The tracker request appears in browser network logs

●Your site appears as connected in Settings -> Tracker

●Your sitemap URLs are discovered with no parsing errors

●First analysis result includes page score + recommendations

Setup Rollout Guidance

Use a staged rollout to avoid production surprises during installation.

●Install tracker in staging first and confirm requests load on all templates.

●Validate sitemap parsing and URL discovery before production launch.

●Create a baseline analysis report before enabling any automated injection.

●Set owner alerts for tracker disconnects and import failures.

Execution Phases

Week 1: Foundation

Finish installation and validate data flow.

Output: Connected tracker, imported sitemap, baseline analysis report.

Week 2: Prioritization

Select high-impact pages and define task backlog.

Output: Prioritized optimization list with owners and due dates.

Week 3-4: Iteration

Ship updates and verify score + business impact.

Output: Before/after snapshots with measurable deltas.

Common Mistakes

●Starting automation before validating tracker and sitemap integrity.

●Treating overall score as the only KPI and ignoring category gaps.

●Rolling out broad template changes without controlled testing.

●Skipping documentation of changes, making results hard to attribute.

Success Metrics

Analyzed Coverage

>= 90% priority URLs analyzed monthly

Ensures optimization decisions are based on current data.

Score Movement

+8 to +15 points on target templates in 30-60 days

Validates that executed recommendations are improving quality.

Execution Velocity

At least 1 improvement cycle per week

Creates compounding gains from consistent iteration.