Docs · Start here
Install the script
Where to paste the agentprose Cloud script tag on WordPress, Ghost, Webflow, static site generators and any other site, plus CSP, CDN and analytics-only options.
The whole install is one script tag in the <head> of every page:
<script src="https://agentprose.cloud/v/0.1.0/agentprose.min.js" data-key="pk_…" defer></script>
It replaces any agentprose tag you already have. agentprose Cloud serves the open-source agentprose library itself, so your site doesn't depend on a public CDN, and the script knows where its Cloud is. https://agentprose.cloud/v/0.1.0/agentprose.min.js never changes and is cached for a year; https://agentprose.cloud/agentprose.min.js always points at the current version.
The script is deferred, about 9 KB gzipped, and doesn't touch your layout. It makes no network requests on page load. It only loads its search engine when an agent first calls a site-wide tool.
Where to paste it
| Platform | Where |
|---|---|
| WordPress | Your theme's header settings, or any "insert headers and footers" plugin |
| Ghost | Settings → Code injection → Site header |
| Webflow | Site settings → Custom code → Head code |
| Hugo, Jekyll, Astro, Eleventy, Next.js | Your base layout's <head> |
| Anything else | Wherever your pages' <head> is built |
Check that it works
Open a page with ?agentprose-inspect added to the address. The 🔌 inspector lists the registered tools and lets you call them.
Content-Security-Policy
With a strict Content-Security-Policy, allow https://agentprose.cloud in script-src (the script loads its search engine and adapters from the same folder) and in connect-src (beacons and hosted search). The script uses no eval and no inline code.
Load it from jsDelivr instead
The same library is on npm. From a public CDN the script can't know your Cloud, so data-cloud is required:
<script src="https://cdn.jsdelivr.net/npm/agentprose@0.1/dist/agentprose.min.js"
data-cloud="https://agentprose.cloud" data-key="pk_…" defer></script>
Options
- Analytics only: use
data-analytics="https://agentprose.cloud/v1/collect"withdata-key, withoutdata-cloud. - Keep search in the browser: add
data-cloud-search="false". - Content under a sub-path: add
data-base="https://example.com/blog/". - Subscribe and comment links for agents:
data-subscribe="https://example.com/newsletter".
Every option is a data-* attribute. The full list is in the library's configuration reference.
Allowed domains
The public key only works from the domains on the site's list (the site's Settings & install tab). Add your staging domain there if you want to test on it.