Documentation

Everything you need to understand and integrate AgentSight.

Quick Start

1. Scan your website

Go to the homepage and enter any public URL. You'll get an AI visibility score across 5 dimensions in about 10 seconds. No signup required.

2. Read your report

Your report shows a score breakdown, specific findings ranked by severity, and actionable recommendations with code snippets.

3. Track and monitor

Verify your domain to unlock bot traffic tracking and AI mention monitoring. See which AI bots visit your site and whether AI engines recommend you.

Scoring Dimensions

AgentSight scores your website across 5 dimensions that determine how well AI agents can find and understand your content.

Can AI see your content?30%
Non-JS Readability

Sites that rely on JavaScript to render content are invisible to most AI crawlers. We check if your key content is accessible without executing JS.

Can AI understand what you do?25%
Structured Data

Schema.org JSON-LD markup tells AI agents exactly what your business is, what you sell, and how you relate to other entities.

How does AI describe your site?20%
Metadata Quality

Your title, description, and Open Graph tags are the first thing AI reads. Incomplete metadata means AI guesses — often wrong.

Does AI see what users see?15%
Render Stability

If your page looks completely different with and without JavaScript, AI crawlers see a broken version of your site.

Have you invited AI in?10%
AI Access Policy

robots.txt, sitemap.xml, and llms.txt tell AI agents what they can access. Missing or misconfigured files mean AI skips your site.

API Reference

All endpoints accept and return JSON. Public endpoints require no authentication. Protected endpoints require X-Action-Token and X-Action-Token-Expires headers obtained through domain verification.

Base URL: https://api.agentsight.eighti.app

Public Endpoints

POST /api/scan

Submit a URL for AI visibility scanning.

GET /api/scan/:id

Get scan report by ID. Returns score, dimensions, findings, and recommendations.

GET /api/scans

List scan history. Query params: page, limit, domain.

Protected Endpoints (require domain verification)

POST /api/tracking/tokens

Generate a bot tracking token for your domain.

GET /api/tracking/stats

Get bot visit analytics. Query params: domain, days.

POST /api/mentions/queries

Add a keyword to monitor for AI mentions.

POST /api/mentions/queries/:id/test

Test a keyword against configured AI engines (Perplexity, ChatGPT).

GET /api/mentions/results

Get mention monitoring history. Query params: domain, queryId, days.

npm Package

@agentsight/tracking is an AI bot detection and tracking middleware. It identifies 19+ AI bots and sends visit events to AgentSight.

npm install @agentsight/tracking

Detect 19+ AI bots (GPTBot, ClaudeBot, PerplexityBot, etc.) · Classify bots as training crawlers or live agents · Fire-and-forget tracking events · Framework adapters for Next.js, Express, Hono, Cloudflare, Astro

Next.js
// middleware.ts
import { createAgentsightMiddleware, matcherConfig } from '@agentsight/tracking/nextjs'

export const middleware = createAgentsightMiddleware({ token: 'ast_your_token' })
export const config = matcherConfig
Express
import express from 'express'
import { createAgentsightMiddleware } from '@agentsight/tracking/express'

const app = express()
app.use(createAgentsightMiddleware({ token: 'ast_your_token' }))
Hono
import { Hono } from 'hono'
import { agentsightMiddleware } from '@agentsight/tracking/hono'

const app = new Hono()
app.use('*', agentsightMiddleware({ token: 'ast_your_token' }))
Cloudflare Pages
// functions/_middleware.ts
import { createAgentsightMiddleware } from '@agentsight/tracking/cloudflare'

export const onRequest = createAgentsightMiddleware({
  token: 'ast_your_token',
})
Astro
// src/middleware.ts
import { createAgentsightMiddleware } from '@agentsight/tracking/astro'

export const onRequest = createAgentsightMiddleware({ token: 'ast_your_token' })

AI Mention Monitoring

Monitor whether AI search engines (Perplexity, ChatGPT) mention and recommend your website when users ask questions about your industry or keywords.

1Verify your domain on the Tracking page
2Add up to 5 keywords to monitor (e.g. "best project management tool")
3Click Test Now to check if AI engines mention your site for that query
4Results are also checked automatically once per day

Currently supported engines: Perplexity (Sonar), ChatGPT (web search).

Frequently Asked Questions

What is AgentSight?
AgentSight is a free tool that measures how visible your website is to AI agents like ChatGPT, Perplexity, and Claude. It scans your site across 5 dimensions and provides an AI visibility score with actionable recommendations.
Is it free?
Yes, AgentSight is free to use. You can scan any public URL without signing up. Bot tracking and mention monitoring are also free after domain verification.
How does the scoring work?
We analyze 5 dimensions: Non-JS Readability (30%), Structured Data (25%), Metadata Quality (20%), Render Stability (15%), and AI Access Policy (10%). Each dimension is scored 0-100, and the weighted average gives your total score.
Which AI bots does AgentSight detect?
We detect 19+ AI bots including GPTBot, ChatGPT-User, ClaudeBot, Claude-User, PerplexityBot, Google-Extended, Grok, Bytespider, Amazonbot, and more. Bots are classified as training crawlers or live agents.
What is AI Mention Monitoring?
It checks whether AI search engines like Perplexity and ChatGPT mention your website when users ask questions related to your keywords. This tells you if AI is actively recommending your site.
How do I install the tracking snippet?
Install the @agentsight/tracking npm package and add the middleware to your server. We support Next.js, Express, Hono, Cloudflare Pages, and Astro. The snippet runs server-side because AI bots don't execute JavaScript.
Does it support my framework?
We provide official adapters for Next.js, Express, Hono, Cloudflare Pages, and Astro. You can also use the core API directly with any Node.js or edge runtime.
How often is mention monitoring checked?
Keywords are checked automatically once per day via a scheduled cron job. You can also click Test Now to check immediately (up to 10 tests per hour per domain).
What AI engines are supported for mention monitoring?
Currently Perplexity (Sonar API) and ChatGPT (OpenAI web search). We plan to add more engines like Claude and Gemini in the future.
Is my data private?
We only scan publicly accessible pages and respect robots.txt. Bot tracking data is tied to your verified domain and only accessible with your action token. We don't share data with third parties.
Can I use AgentSight with AI assistants?
Yes! Click the "Copy for AI" button at the top of this page to copy a markdown version of our documentation. Paste it into ChatGPT, Claude, or any AI assistant for integration help.
How do I verify my domain?
Go to the Tracking page and enter your domain. Choose DNS TXT or file upload verification. DNS: add a TXT record to your domain. File: place a file at /.well-known/agentsight-verify. Verification takes about 2 minutes.

Scan Your Website

Back to Home