Skip to main content

Connecting your website to AXP using Akamai

This guide explains how to connect your website to Scrunch AXP (Agent Experience Platform) using Akamai. Once connected, AXP can deploy scripts directly to your Akamai property to enable optimized content delivery and LLM bot experiences.

Updated yesterday

Overview

The Agent Experience Platform (AXP) in Scrunch allows you to optimize how LLM agents—such as ChatGPT, Perplexity, Gemini, and others—access and interpret your website’s content. By connecting your site through Akamai EdgeWorkers, AXP enables real-time content delivery and rule-based optimization specifically designed for AI crawlers and conversational models.

If your website is hosted or proxied by Akamai, EdgeWorkers is the ideal way to deploy and manage AXP directly at the edge, ensuring faster performance, versioned rule control, and automatic synchronization between Scrunch and your Akamai property.


Before you begin

Before starting the setup, make sure you have:

  • Your website is already hosted and running on Akamai

  • Permission to create and manage Properties and EdgeWorkers inside Akamai

  • A Scrunch account with access to the AXP section


Step 1 — Open the AXP section in Scrunch

  1. In your Scrunch dashboard, go to AXP → Sites

  2. Click Connect Site

  3. Enter your domain and click Next

  4. Select Akamai as your platform

  5. Pick the best region based on your website/audience

You will see a page like this with variables that will be used later:


Step 2 — Creating the Edge Worker

Now, let's install the Edge Worker

  1. Go to EdgeWorkers and click on "Create EdgeWorker ID"

  2. Fill the form. The Resource tier can be Basic or Dynamic (if you have)

4. After saving, access the Edge Worker and click on Create version

5. Download and upload our EdgeWorker: scrunch_akamai_edge_worker.tgz

6. Finally, click on the three dots on the new version and activate it in Staging (optional but recommended) and Production

Example:

Wait for activations. As soon as they are ready, go to the next step.


Step 3 — Add your Edge Worker to your Property

  1. Still on Akamai Control Center, go to Properties and access your website

  2. Edit a new version of your Property Rules

  3. Add a new Behavior (button +Behavior) and search for "EdgeWorkers"

  4. Select your EdgeWorker on the Identifier

  5. Add the new environment variables to the Property Variables: SITE_ID and REGION. Use the values available on Scrunch Console

  6. Finally, launch the new version and wait until the changes are fully deployed


Step 4 — Confirm AXP is ready!

After the new version of your website is deployed, you can click on "Confirm AXP is ready!"

If everything goes well, the AXP will move from "Pending" to "Active" 🎉

Now your AXP integration is complete. You can start creating rules and delivering optimized content for LLM bots.


Troubleshooting and Tips

EdgeWorker is deployed but not running?
Verify that the assigned Property version includes the EdgeWorker behavior and that it’s active in your production rule tree.

Avoid piling up many Edge Workers

Akamai allows multiple EdgeWorkers on the same property, but only one runs per behavior. If several match the same request, they run in order and may overwrite each other’s changes. If possible, keep just one EdgeWorker for Scrunch AXP to prevent conflicts.

Ensure AXP is working as soon as you see it active
Create a simple new rule or optimized content and deploy it whenever AXP becomes active to ensure everything is working as expected.

Tips for better results:

  • Use a dedicated API client for Scrunch AXP to avoid permission conflicts

  • If you manage multiple domains, repeat the process for each property

Did this answer your question?