@careerdriver/black-box 1.0.3 → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +77 -1
- package/package.json +24 -1
package/README.md
CHANGED
|
@@ -22,10 +22,13 @@ The Black Box runtime optimizes websites specifically for **AI search engines**
|
|
|
22
22
|
|
|
23
23
|
The runtime reads JSON configuration from your GPTO dashboard and automatically:
|
|
24
24
|
|
|
25
|
-
- ✅ Injects JSON-LD schemas (Organization, Product, Service, FAQ, etc.)
|
|
25
|
+
- ✅ Injects JSON-LD schemas (Organization, Product, Service, FAQ, etc.) **client-side**
|
|
26
|
+
- ✅ **Server-side schema injection** available for external audit tool visibility
|
|
26
27
|
- ✅ Builds authority signals through `sameAs` links and keywords
|
|
27
28
|
- ✅ Sends telemetry to track AI search visibility
|
|
28
29
|
- ✅ Ensures content is structured for AI model comprehension
|
|
30
|
+
- ✅ **Automatically updates** schemas when configuration changes
|
|
31
|
+
- ✅ **Telemetry-driven improvements** optimize schemas over time
|
|
29
32
|
|
|
30
33
|
## Usage
|
|
31
34
|
|
|
@@ -115,6 +118,65 @@ const blackBox = new PantheraBlackBox({
|
|
|
115
118
|
await blackBox.init();
|
|
116
119
|
```
|
|
117
120
|
|
|
121
|
+
### Server-Side Schema Injection (Recommended for External Audit Tools)
|
|
122
|
+
|
|
123
|
+
For optimal visibility with external audit tools that don't execute JavaScript, you can automatically inject schemas server-side:
|
|
124
|
+
|
|
125
|
+
#### Option 1: Schema Render Endpoint
|
|
126
|
+
|
|
127
|
+
Fetch schemas and inject into your HTML template:
|
|
128
|
+
|
|
129
|
+
```typescript
|
|
130
|
+
// Next.js / React Server Component
|
|
131
|
+
async function getSchemas(siteId: string) {
|
|
132
|
+
const response = await fetch(`https://gpto-dashboard.vercel.app/api/sites/${siteId}/render`);
|
|
133
|
+
return await response.text();
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
export default async function Page() {
|
|
137
|
+
const schemaScripts = await getSchemas('your-site-id');
|
|
138
|
+
|
|
139
|
+
return (
|
|
140
|
+
<html>
|
|
141
|
+
<head>
|
|
142
|
+
<div dangerouslySetInnerHTML={{ __html: schemaScripts }} />
|
|
143
|
+
</head>
|
|
144
|
+
<body>{/* Your content */}</body>
|
|
145
|
+
</html>
|
|
146
|
+
);
|
|
147
|
+
}
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
#### Option 2: Proxy Endpoint
|
|
151
|
+
|
|
152
|
+
Use the proxy endpoint for external audit tools:
|
|
153
|
+
|
|
154
|
+
```
|
|
155
|
+
https://gpto-dashboard.vercel.app/api/sites/[site-id]/proxy?url=https://your-domain.com
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
This automatically serves your page with schemas injected server-side.
|
|
159
|
+
|
|
160
|
+
#### Option 3: Server-Side Utility
|
|
161
|
+
|
|
162
|
+
Import and use the schema generator directly:
|
|
163
|
+
|
|
164
|
+
```typescript
|
|
165
|
+
import { generateSchemaScriptTags, injectSchemasIntoHTML } from '@gpto/servos/gpto';
|
|
166
|
+
|
|
167
|
+
// Generate schema script tags
|
|
168
|
+
const schemaScripts = generateSchemaScriptTags(config.panthera_blackbox);
|
|
169
|
+
|
|
170
|
+
// Or inject into existing HTML
|
|
171
|
+
const htmlWithSchemas = injectSchemasIntoHTML(html, config.panthera_blackbox);
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
**Benefits:**
|
|
175
|
+
- ✅ Schemas visible to external audit tools
|
|
176
|
+
- ✅ Automatic updates when config changes
|
|
177
|
+
- ✅ No manual HTML edits required
|
|
178
|
+
- ✅ Works alongside client-side Black Box injection
|
|
179
|
+
|
|
118
180
|
## AI Search Optimization Features
|
|
119
181
|
|
|
120
182
|
### JSON-LD Schema Injection
|
|
@@ -152,6 +214,20 @@ Output:
|
|
|
152
214
|
|
|
153
215
|
Deploy to Vercel CDN for global distribution. The file should be served with appropriate cache headers.
|
|
154
216
|
|
|
217
|
+
## Version
|
|
218
|
+
|
|
219
|
+
**Current Version:** `1.1.0`
|
|
220
|
+
|
|
221
|
+
### What's New in v1.1.0
|
|
222
|
+
|
|
223
|
+
- ✅ Automatic server-side schema injection
|
|
224
|
+
- ✅ Zero manual HTML edits required
|
|
225
|
+
- ✅ Automatic schema updates when config changes
|
|
226
|
+
- ✅ External audit tool visibility
|
|
227
|
+
- ✅ Multiple integration options
|
|
228
|
+
|
|
229
|
+
See [CHANGELOG.md](../../CHANGELOG.md) for complete release notes.
|
|
230
|
+
|
|
155
231
|
## AI Search Optimization vs Traditional SEO
|
|
156
232
|
|
|
157
233
|
| Traditional SEO | GPTO (AI Search Optimization) |
|
package/package.json
CHANGED
|
@@ -1,6 +1,23 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@careerdriver/black-box",
|
|
3
|
-
"version": "1.0
|
|
3
|
+
"version": "1.1.0",
|
|
4
|
+
"description": "AI Search Optimization Runtime - Automatic JSON-LD schema injection with server-side rendering support",
|
|
5
|
+
"keywords": [
|
|
6
|
+
"ai-search",
|
|
7
|
+
"gpt-optimization",
|
|
8
|
+
"schema.org",
|
|
9
|
+
"json-ld",
|
|
10
|
+
"seo",
|
|
11
|
+
"ai-visibility",
|
|
12
|
+
"structured-data",
|
|
13
|
+
"chatgpt",
|
|
14
|
+
"perplexity",
|
|
15
|
+
"claude"
|
|
16
|
+
],
|
|
17
|
+
"repository": {
|
|
18
|
+
"type": "git",
|
|
19
|
+
"url": "https://github.com/careerdriver/gpto-suite"
|
|
20
|
+
},
|
|
4
21
|
"private": false,
|
|
5
22
|
"type": "module",
|
|
6
23
|
"files": [
|
|
@@ -20,6 +37,12 @@
|
|
|
20
37
|
"publishConfig": {
|
|
21
38
|
"access": "public"
|
|
22
39
|
},
|
|
40
|
+
"author": "CareerDriver",
|
|
41
|
+
"license": "UNLICENSED",
|
|
42
|
+
"bugs": {
|
|
43
|
+
"url": "https://github.com/careerdriver/gpto-suite/issues"
|
|
44
|
+
},
|
|
45
|
+
"homepage": "https://github.com/careerdriver/gpto-suite#readme",
|
|
23
46
|
"scripts": {
|
|
24
47
|
"build": "tsup src/runtime.ts --format iife,esm --global-name PantheraBlackBox --minify --sourcemap --dts",
|
|
25
48
|
"dev": "tsup src/runtime.ts --format iife,esm --global-name PantheraBlackBox --watch",
|