Skip to main content

Installation

Installation connects your existing URLs to camolabs. Your existing site stays the default response. Only eligible agent requests are routed to camolabs for an Agent Page.

Installation has two pieces, both set up in your CDN or hosting layer:

  1. An Agent domain, such as agents.yourdomain.com, pointed at camolabs with a CNAME to app.camolabs.ai.
  2. A routing rule on your main domain. It passes normal traffic to your existing site and routes only eligible agent requests to the Agent domain.

Human browsers and search crawlers always pass through to your existing site.

Set it up

The step-by-step lives in the guide for wherever your public site is served:

For any other CDN, follow the same model: pass traffic to the existing site by default, route only eligible GET page requests to the Agent domain, and return the camolabs response only when it is 200 text/html with x-camolabs-agent-page-outcome: served_agent_page.

Values you will use

ValueExampleUsed in
Main domainwww.yourdomain.comExisting public site
Agent domainagents.yourdomain.comDNS and Settings > Install
CNAME targetapp.camolabs.aiDNS provider
CAMOLABS_AGENT_ORIGINhttps://agents.yourdomain.comCloudflare Worker or Vercel Middleware
Routing policyhttps://agents.yourdomain.com/.well-known/camolabs-routing-policy.jsonEdge adapter
MCP endpointhttps://agents.yourdomain.com/mcpApproved Actions

What gets routed

camolabs never blocks anything. The default path is pass-through to your existing site. Requests that look automated can receive Agent Pages when they hit a published route.

These AI agents receive Agent Pages when they hit a published route:

AgentUser-agent token
ChatGPTChatGPT-User
OpenAI SearchOAI-SearchBot
ClaudeClaude-User
Claude SearchClaude-SearchBot
PerplexityPerplexity-User
PerplexityBotPerplexityBot
Google AgentGoogle-Agent
Meta FetcherMeta-ExternalFetcher
MistralMistralAI-User
Mistral IndexMistralAI-Index
Amazon UserAmzn-User
Amazon SearchAmzn-SearchBot

These AI crawlers are labeled in your activity but still get your existing site, not Agent Pages:

CrawlerUser-agent token(s)What it is
GPTBotGPTBotOpenAI training
ClaudeBotClaudeBot, anthropic-aiAnthropic training
GoogleOtherGoogleOtherGeneric Google
Meta AIMeta-ExternalAgentMeta crawler
AmazonbotAmazonbotAmazon crawler

Search crawlers always continue to your original site to avoid cloaking:

Search crawlerUser-agent token(s)
GooglebotGooglebot
Bingbotbingbot, BingPreview
Yahoo SlurpSlurp
DuckDuckBotDuckDuckBot
BaiduspiderBaiduspider