Agentic Bridge

A lightweight JavaScript snippet that websites install to expose their search as structured tools for AI agents, with WebMCP support and server-side dispatch.

Architecture

bridge/       Client-side JS snippet (<30KB gzipped)
worker/       Agentic Indexing API (Cloudflare Worker + D1)
webflow-app/  Webflow Data Client App (OAuth + script injection)

Quick Start

npm install
npm run build

Development

npm run dev:worker     # Start worker locally
npm run build:bridge   # Build bridge snippet
npm run typecheck      # Typecheck all packages

Bridge Script Usage

Add to any website:

<script
  src="https://your-cdn.com/bridge.js"
  data-bridge-api-url="https://your-worker.workers.dev"
  data-bridge-api-key="your-api-key"
  data-bridge-site-id="your-site-id"
  async
></script>

The bridge will:

1. Detect the platform (Webflow, Shopify, or generic)
2. Find search forms and generate tool schemas
3. Register tools via WebMCP (if browser supports it)
4. Register tools with the server API for server-side dispatch

API Endpoints

Method	Path	Auth	Purpose
POST	/api/register	API Key	Register tool schemas
GET	/api/discover	API Key	Return tool contracts
POST	/api/dispatch	API Key	Execute tool server-side
POST	/api/analytics	None	Ingest signals
GET	/api/health	None	Health check

License

MIT