Panthera Black Box Runtime

AI Search Optimization Runtime - Minimal JavaScript runtime (<10KB gzipped) that optimizes websites for AI search engines by injecting structured data (JSON-LD schemas), building authority signals, and enabling AI model comprehension.

Purpose

The Black Box runtime optimizes websites specifically for AI search engines (ChatGPT, Perplexity, Claude, etc.) by:

1. Injecting JSON-LD Structured Data - Makes content easily parseable by AI models
2. Building Authority Signals - Creates trust graphs through Authority Grove
3. Ensuring Factual Accuracy - Uses TruthSeeker to ensure AI models prioritize your content
4. Tracking AI Visibility - Sends telemetry to measure AI search performance

Safety

- No eval() - No code execution
- No Function() - No dynamic function creation
- Declarative only - All operations are safe JSON/DOM manipulations
- Fail-safe - Never breaks the host site

How It Works

The runtime reads JSON configuration from your GPTO dashboard and automatically:

- ✅ Injects JSON-LD schemas (Organization, Product, Service, FAQ, etc.) client-side
- ✅ Server-side schema injection available for external audit tool visibility
- ✅ Builds authority signals through sameAs links and keywords
- ✅ Sends telemetry to track AI search visibility
- ✅ Periodic telemetry sends comprehensive metrics every 5 minutes for real-time dashboard updates
- ✅ Ensures content is structured for AI model comprehension
- ✅ Automatically updates schemas when configuration changes
- ✅ Telemetry-driven improvements optimize schemas over time

Usage

$3

#### Using pnpm (Recommended)

``bash


Install as a dependency

`bash


Install latest version (includes periodic telemetry)

`bash


Install latest version (includes periodic telemetry)

`ts
import { PantheraBlackBox } from '@careerdriver/black-box';

const blackBox = new PantheraBlackBox({
configUrl: 'https://api.example.com/api/sites/[site-id]/config',
telemetryUrl: 'https://api.example.com/api/telemetry/events',
siteId: 'your-site-id',
});

await blackBox.init();
`

$3

#### Via unpkg CDN

Add the script tag to your HTML:

`html
src="https://unpkg.com/@careerdriver/black-box@latest/dist/runtime.global.js"
data-config-url="https://api.example.com/api/sites/[site-id]/config"
data-telemetry-url="https://api.example.com/api/telemetry/events"
data-site-id="your-site-id"
async
>
`

Note: The @latest version includes periodic telemetry (v1.2.0+). To use a specific version, replace @latest with @1.2.0 or your preferred version.

#### Via Local Installation

If you've installed via pnpm/npm, reference the local file:

`html
src="./node_modules/@careerdriver/black-box/dist/runtime.global.js"
data-config-url="https://api.example.com/api/sites/[site-id]/config"
data-telemetry-url="https://api.example.com/api/telemetry/events"
data-site-id="your-site-id"
async
>
`

$3

`javascript
const blackBox = new PantheraBlackBox({
configUrl: 'https://api.example.com/api/sites/[site-id]/config',
telemetryUrl: 'https://api.example.com/api/telemetry/events',
siteId: 'your-site-id',
});

await blackBox.init();
`

$3

For optimal visibility with external audit tools that don't execute JavaScript, you can automatically inject schemas server-side:

#### Option 1: Schema Render Endpoint

Fetch schemas and inject into your HTML template:

`typescript
// Next.js / React Server Component
async function getSchemas(siteId: string) {
const response = await fetch(https://gpto-dashboard.vercel.app/api/sites/${siteId}/render);
return await response.text();
}

export default async function Page() {
const schemaScripts = await getSchemas('your-site-id');

return (