Frequently Asked Questions

Quick answers to the most common questions about Cleversearch, installation, and optimization workflows.

Getting Started

Basics to help you launch quickly

What do I need before I can start?

FAQ

You will need access to your website, a Cleversearch account, and a sitemap or list of pages you want to optimize.

How long does setup take?

FAQ

Most teams finish tracker installation and sitemap import in under 30 minutes.

Do I need developer help?

FAQ

For basic setup, not necessarily. For advanced integrations or custom placement, a developer is helpful.

Setup & Onboarding

Installation and setup flow

Where do I install the tracker script?

FAQ

Install it in your site <head> so it loads early and can detect route changes properly.

Do I need to import a sitemap?

FAQ

Yes, a sitemap helps Cleversearch discover all pages for analysis and optimization.

Can I start with a single page?

FAQ

Yes, you can start with a small set of URLs and expand later.

Tracker & Injection

How content is injected and updated

Will the tracker change my original content?

FAQ

No. It injects optimized content alongside your existing content unless you configure replacements explicitly.

Does it work with single-page apps?

FAQ

Yes. The tracker listens for route changes and re-evaluates content automatically.

Can I control where FAQs appear?

FAQ

Yes. Add selectors like .clever-search-faq to control placement on the page.

Integrations

Platforms and frameworks

Is there a Next.js-friendly setup?

FAQ

Yes. Use the Next.js Script component with the recommended loading strategy.

Does it support WordPress and Shopify?

FAQ

Yes. Add the script to your theme header or use platform settings to inject it.

Will it work on static sites?

FAQ

Yes. Static sites can load the tracker via a standard script tag.

API & Security

Authentication and data protection

Where should I store secret keys?

FAQ

Store secret keys in server-side environment variables and never expose them in client-side code.

How often should I rotate keys?

FAQ

Rotate keys every 90 days or immediately if you suspect exposure.

How do I verify webhooks?

FAQ

Use your webhook secret to validate the signature header before accepting events.

Analytics & Reporting

Understanding results and progress

How do I know if optimization is working?

FAQ

Track your LLM readiness score, citation mentions, and page-level improvements.

How often are reports updated?

FAQ

Reports update after new analyses or when pages change and are re-processed.

Can I export data?

FAQ

Yes. You can export reports from the dashboard for external analysis.

Billing & Limits

Plans, quotas, and usage

What happens if I hit rate limits?

FAQ

Requests are throttled temporarily. Reduce volume or contact support for higher limits.

Is there a free plan?

FAQ

Free plans are available with limited usage. Paid tiers unlock higher limits and priority support.

How is usage calculated?

FAQ

Usage is typically based on analyzed pages, API requests, and active sites in your account.

Troubleshooting

Common issues and fixes

I installed the script but see no changes.

FAQ

Check for console errors, verify SITE_ID, and ensure the page URL is in your sitemap.

FAQs are injected in the wrong place.

FAQ

Add the correct CSS selector or container element for FAQ placement.

Why is content not updating after changes?

FAQ

Trigger a refresh or re-run analysis to update injected content.

Frequently Used Commands

Compact setup snippets referenced throughout the FAQs.

Tracker Script (HTML)

Add to your <head> section for basic tracking and injection.

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

API Auth Header

Use a secret key in the Authorization header.

curl https://api.cleversearch.ai/v1/analysis \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

Debug Mode

Enable detailed logs during troubleshooting.

?clever-search-debug=true

Still Need Help?

Check the troubleshooting guide or reach out to support for personalized help.

Troubleshooting Guide API Keys & Auth Content Injection

FAQ Usage Tips

Use FAQs as fast lookup and connect answers back to primary guides.

●Link recurring issues to a single canonical troubleshooting article.

●Update FAQ entries after product or workflow changes.

●Include concise examples with expected outcomes.

●Tag frequent questions by team function for quicker triage.

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.