Setup guides

Documentation

Install the Black Box via npm and configure your site with the details you need.

Black Box npm installation (primary)

Use the npm package as the main integration path. Script tag/CDN are secondary fallback options.

npm install @careerdriver/black-box

import { PantheraBlackBox } from '@careerdriver/black-box'; const blackBox = new PantheraBlackBox({ configUrl: 'https://your-dashboard-url/api/sites/YOUR-SITE-ID/config', telemetryUrl: 'https://your-dashboard-url/api/telemetry/events', siteId: 'YOUR-SITE-ID', }); await blackBox.init();

The runtime is ESM-only. Use it in modern bundlers (Vite, Next.js, Webpack 5) or ESM-compatible environments.

Telemetry v2 included: journey context, intent confidence, search diagnostics, engagement/technical signals, and privacy redaction metadata are sent automatically when telemetry is enabled.

Alternative installation methods

If npm integration is not possible, use one of these fallback methods:

https://unpkg.com/@careerdriver/black-box@1.4.0/dist/runtime.global.js

Server-Side Schema Injection (Recommended)

For optimal visibility with external audit tools, inject schemas server-side. Schemas automatically update when your configuration changes.

Schema Render Endpoint

GET /api/sites/YOUR-SITE-ID/render

Returns HTML script tags with schemas that can be injected into your HTML template.

// Next.js / React Server Component const schemas = await fetch( '/api/sites/YOUR-SITE-ID/render' ); const schemaHTML = await schemas.text(); // Inject into HTML <div dangerouslySetInnerHTML={{ __html: schemaHTML }} />

✅ Automatic Updates: Schemas are generated from your configuration and update automatically. No manual HTML edits needed!

Configuration details

The Black Box pulls configuration from your dashboard and safely applies it to the page. Works alongside server-side schema injection for best results.

Get your Site ID

In the dashboard, open Sites, select a site, and copy the UUID from the URL.

Set the endpoints

Use your dashboard URL for both endpoints so the runtime can fetch config and send telemetry.

configUrl → https://your-dashboard-url/api/sites/YOUR-SITE-ID/config
telemetryUrl → https://your-dashboard-url/api/telemetry/events

What to enable

Telemetry: turn on event collection in the site config.
Brand/schema: set your brand name and JSON-LD schema fields.
Features: enable ads, autofill, and geo nodes only after review.

Verify

Open the browser console for [Panthera Black Box] logs and confirm your config endpoint returns JSON.

For server-side schemas: View page source and search for application/ld+json to verify schemas are in the HTML.

What GPTO Measures (and does not measure)

A GPTO audit measures how clearly and confidently your website communicates with search engines and AI, not how much traffic it currently gets.

Measures: AI clarity, structure, content signal quality, technical machine-readability.
Does not measure: traffic uplift, lead volume, conversion rates, revenue impact, ROI.
Package mapping: Foundation establishes clarity, Growth improves discoverability, and Elite strengthens authority signals.

{ "panthera_blackbox": { "ai_readability": { "frameworkVersion": "gpto.ai_readability.v1", "packageTier": "bronze", "overall": { "score": 0, "grade": "F" }, "recommendedActions": [], "insufficientData": { "reason": "Readability rollup is still building.", "missingSignals": ["periodic telemetry", "readability rollup"] } } } }

GPTO

GPTO Loading

Initialising reasoning core...