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.)
• ✅ Builds authority signals through sameAs links and keywords
• ✅ Sends telemetry to track AI search visibility
• ✅ Ensures content is structured for AI model comprehension

Usage

Installation

Using pnpm (Recommended)

# Install as a dependency
pnpm add @careerdriver/black-box

# Install as a dev dependency
pnpm add -D @careerdriver/black-box

# Install specific version
pnpm add @careerdriver/black-box@1.0.1

# Install latest version
pnpm add @careerdriver/black-box@latest

Using npm

npm install @careerdriver/black-box

Using yarn

yarn add @careerdriver/black-box

ESM Import Usage

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();

Browser Usage (Script Tag / CDN)

Via unpkg CDN

Add the script tag to your HTML:

<script
  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
></script>

Via Local Installation

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

<script
  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
></script>

Manual Initialization

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();

AI Search Optimization Features

JSON-LD Schema Injection

Automatically injects structured data that AI models can parse:

• Organization schema with authority signals
• Product/Service schemas (Silver/Gold tiers)
• FAQ schemas for question-answer pairs
• LocalBusiness schemas for geo-targeting

Authority Grove Integration

Builds trust signals through:

• sameAs links (social profiles, other domains)
• Keywords and verticals
• Partner network relationships

TruthSeeker Integration

Ensures content is:

• Factually accurate
• Authoritative
• Fair and unbiased
• Recent and relevant

Build

pnpm build

Output:

• dist/runtime.js (ESM)
• dist/runtime.global.js (IIFE for script tag)
• dist/runtime.d.ts (types)

Deployment

Deploy to Vercel CDN for global distribution. The file should be served with appropriate cache headers.

AI Search Optimization vs Traditional SEO