Skip to main content

Colter Lens

Continuous AI agent traffic monitoring for e-commerce stores. Classify agent visits, track protocol health, verify signatures, analyze journeys, and export reports.

TL;DR: Register a site with colter lens https://mystore.com, deploy the edge worker, then use colter lens status, alerts, protocols, report, and export to monitor live AI agent traffic. Lens is the runtime view of what agents actually do after launch.

What Lens Tracks

  • agent traffic volume
  • protocol health
  • signature verification
  • funnel progression
  • session drill-downs
  • alerts and exports

Quick Start

Register the site:

colter lens https://mystore.com

Or via the API:

curl -X POST https://agenticcom.ai/api/v1/lens/sites \
  -H "Authorization: Bearer $COLTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://mystore.com"}'

Deploy the worker:

cd workers/lens-edge
npm install
npx wrangler secret put COLTER_API_KEY
npx wrangler deploy

Core CLI

Register:

colter lens https://mystore.com --json

Status:

colter lens status --url https://mystore.com --period 7d --json

Alerts:

colter lens alerts --site-id <id> --status open --json

Protocol health:

colter lens protocols --site-id <id> --json

Report:

colter lens report --site-id <id> --period 7d --json

Export:

colter lens export --site-id <id> --type traffic --period 7d --format csv --out lens-traffic.csv

Deploy:

colter lens deploy --url https://mystore.com --cf-account-id <id> --cf-api-token <token>

Dashboard Areas

AreaWhat it answers
Traffic overviewWhich agents are visiting and in what volume
Protocol healthWhich readiness surfaces are up or down
Journey funnelWhere agents drop off
Session explorerWhat happened in one session
AlertsWhat changed and what needs action
PortfolioHow multiple sites compare

Authenticated API

Lens endpoints require a session cookie or Authorization: Bearer $COLTER_API_KEY.

Useful endpoints:

  • POST /api/v1/lens/sites
  • GET /api/v1/lens/traffic
  • GET /api/v1/lens/journeys
  • GET /api/v1/lens/protocols
  • GET /api/v1/lens/alerts
  • GET /api/v1/lens/export
  • POST /api/v1/lens/revenue-webhook

Alert Types

  • protocol_down
  • protocol_recovered
  • score_drop
  • signature_failure
  • new_agent
  • x402_down
  • x402_recovered
  • acp_checkout_down
  • acp_checkout_recovered

Notes

  • Lens pricing and limits follow the current Pricing page.
  • Lens is for live monitoring; use Check, Test, and Verify for setup and validation work.

Next Steps