# GEOScope API
> Real-time Generative Engine Optimization (GEO) & AI search visibility diagnostic engine.

GEOScope is an edge micro-service built by AgentLabs. It evaluates why websites are invisible to generative AI search engines, tests AI crawler access for 10 bots, unmasks client-side rendering ghost towns, simulates 500-token RAG retrieval windows, and generates 1-click code remediation for /llms.txt and JSON-LD Schema.

## Core Endpoints
- [Execute Full GEO Audit](https://geoscope.agentlabs.workers.dev/v1/geo-audit?url=example.com): Complete 10-bot crawlability, CSR risk, and RAG chunk audit.
- [Specialized Bot Firewall Audit](https://geoscope.agentlabs.workers.dev/v1/audit/bots?url=example.com): Test GPTBot, ClaudeBot, PerplexityBot, etc.
- [Interactive API Documentation](https://geoscope.agentlabs.workers.dev/docs): Test the API in an interactive Scalar API console.
- [OpenAPI 3.0 Specification](https://geoscope.agentlabs.workers.dev/v1/openapi.json): Standard machine-readable OpenAPI schema for agents and RapidAPI.
- [Sister Tool: StackScope Tech Intelligence](https://stackscope.agentlabs.workers.dev): Sub-50ms website tech stack and email DNS detection.
- [Sister Tool: MailLock Deliverability Sentry](https://maillock.agentlabs.workers.dev): Sub-100ms email deliverability, SPF lookup flattener, and zero-trust DNS sentry.

## Example Request
```bash
curl "https://geoscope.agentlabs.workers.dev/v1/geo-audit?url=stripe.com"
```

## Response Schema Highlights
- geo_scorecard: Overall AI readiness score (0-100), letter grade (A+ to F), bot access score, SSR rendering score, RAG answerability score, and Schema readiness score.
- bot_firewall_audit: 10-bot access matrix with priority, impact, and crawlability verdict.
- one_click_remediation: Auto-generated /llms.txt, JSON-LD Schema, and permissive AI robots.txt.
- pro_executive_report: AI engine retrieval matrix, 45-word narrative rewrites, and 30-day remediation roadmap.