feat(geo): AI visibility tracking

.env.example

@@ -85,6 +85,15 @@ UNKEY_API_ID=
 # Twitter
 TWITTER_BEARER_TOKEN=
 
+# GEO grounded scanning (optional)
+OPENAI_API_KEY=
+ANTHROPIC_API_KEY=
+PERPLEXITY_API_KEY=
+
+# Tinybird (social analytics)
+TINYBIRD_TOKEN=
+TINYBIRD_BASE_URL=https://api.tinybird.co
+
 # Social account linking provider
 POST_FOR_ME_API_KEY=
 POST_FOR_ME_API_KEY_TWITTER=
@@ -104,3 +113,9 @@ AXIOM_ORG_ID=""
 
 # Notra
 NOTRA_API_KEY=""
+
+# Beacon (AI traffic detection)
+BEACON_INGEST_SECRET=
+BEACON_INGEST_URL="http://localhost:3002/api/beacon"
+BEACON_ORG_TOKEN=
+BEACON_ORG_ID=

apps/dashboard/knip.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://unpkg.com/knip@6/schema.json",
-  "entry": ["src/**/*.test.ts"],
+  "entry": ["src/**/*.test.ts", "scripts/*.ts"],
   "ignoreIssues": {
     "src/app/(dashboard)/**/constants/**/*.ts": ["exports"],
     "src/components/**/*.tsx": ["types"],

apps/dashboard/package.json

@@ -17,6 +17,9 @@
     "smoke:autonomy": "bun run scripts/autonomy-smoke.ts"
   },
   "dependencies": {
+    "@ai-sdk/anthropic": "3.0.84",
+    "@ai-sdk/openai": "3.0.71",
+    "@ai-sdk/perplexity": "3.0.35",
     "@ai-sdk/react": "3.0.208",
     "@aws-sdk/client-s3": "^3.990.0",
     "@aws-sdk/s3-request-presigner": "^3.990.0",
@@ -38,6 +41,7 @@
     "@lexical/utils": "^0.39.0",
     "@neoconfetti/react": "^1.0.0",
     "@notra/ai": "workspace:*",
+    "@notra/analytics": "workspace:*",
     "@notra/content-generation": "workspace:*",
     "@notra/db": "workspace:*",
     "@notra/email": "workspace:*",

apps/dashboard/scripts/register-analytics-schedule.ts

@@ -0,0 +1,26 @@
+import { getAppUrl } from "@notra/ai/qstash/triggers";
+import { Client as QStashClient } from "@upstash/qstash";
+
+const HOURLY_CRON = "0 * * * *";
+const SCHEDULE_ID = "social-analytics-sync-hourly";
+
+const token = process.env.QSTASH_TOKEN;
+if (!token) {
+  throw new Error("QSTASH_TOKEN is not configured");
+}
+
+const client = new QStashClient({ token });
+const destination = `${getAppUrl()}/api/workflows/social-analytics-sync`;
+
+const result = await client.schedules.create({
+  scheduleId: SCHEDULE_ID,
+  destination,
+  cron: HOURLY_CRON,
+  body: JSON.stringify({}),
+  headers: { "Content-Type": "application/json" },
+});
+
+console.log(
+  `Registered schedule ${result.scheduleId ?? SCHEDULE_ID} -> ${destination} (${HOURLY_CRON})`
+);
+process.exit(0);

apps/dashboard/src/app/(dashboard)/[slug]/analytics/loading.tsx

@@ -0,0 +1,5 @@
+import { AnalyticsPageSkeleton } from "./skeleton";
+
+export default function Loading() {
+  return <AnalyticsPageSkeleton />;
+}