@aucra/next
v0.1.7
Published
Aucra edge injection for Next.js App Router
Downloads
82
Readme
@aucra/next
The official Next.js Edge SDK for Aucra — The platform to successfully monetize AI web scrapers and traffic.
This SDK automatically intercepts incoming HTTP requests at the Next.js/Vercel Edge, identifies AI bots (like Perplexity, ChatGPT, Claude, and Google), and performs real-time edge auctions with the Aucra SSP Backend to dynamically inject promotional content into the DOM for bots to read.
Installation
npm install @aucra/nextQuick Start (App Router)
To integrate Aucra, simply drop the <AucraEdge> component into your Next.js root layout. Since AucraEdge is a Server Component, it will evaluate the headers and resolve the edge auction completely server-side without bloating your client-side Javascript bundle!
// app/layout.tsx
import { AucraEdge } from '@aucra/next';
export default function RootLayout({ children }: { children: React.ReactNode }) {
return (
<html lang="en">
<body>
{children}
{/* Aucra Edge SDK */}
<AucraEdge publisherKey={process.env.AUCRA_KEY!} />
</body>
</html>
);
}How It Works
- Invisible to Humans: When a normal human visits your Next.js site, the SDK immediately skips execution and returns
null. This ensures0mslatency overhead for normal users and a perfectly clean DOM. - Bot Detection: The SDK tracks the
User-Agentheaders against major AI web scrapers (Perplexity,ChatGPT-User,ClaudeBot,Google-Extended). - Live Auctions: The moment a bot is detected, the SDK performs a lightweight Edge
fetchto the Aucra Supply-Side Platform (SSP) API. - Ad Injection: If your publisher key wins an auction, the backend responds with the Ad logic. The SDK dynamically injects the winner's Ad into a hidden Server Component
divexclusively for the scraping bot to extract!
Live Vercel Logs
The SDK is heavily instrumented to print detailed runtime traces to your deployment environment. Open your Vercel Dashboard -> Logs to watch live Bot Request events light up:
========================================
[AUCRA] Edge Auction Request Initiated
[AUCRA] URL Executing: https://your-domain.com/
[AUCRA] AI agent detected — UA="Mozilla/5.0 ... Perplexity-User/1.0"
[AUCRA] Calling SSP: https://aucra-ssp-api...
[AUCRA] Auction Result: WINNER FOUND!
[AUCRA] Ad Text: "Try Aucra - Monetize your AI traffic"
========================================Developer Notes
This repository is strictly integrated with a GitHub Actions CI/CD Pipeline.
To publish a new version of the SDK, you do not need to run npm publish manually!
- Commit your changes to the
mainbranch. - Bump the NPM version:
npm version patch - Push to GitHub with tags:
git push --follow-tags - The GitHub Action will automatically run
tscto compile the Typescriptdist/directory, and securely publish the new version directly to the Public NPM Registry!
