# Viraill Core GEO & Agentic Readiness Engine
> API d'arbitrage sémantique GEO, de calcul de centroïdes d'intentions et d'audit d'Agentic Readiness.

## Endpoints Publics (essai gratuit: audit/scan 1 appel unique par IP, écriture 1 appel/jour; puis x402)
- POST /v1/geo/audit : Scan de lisibilité crawler, détection de friction marché et Answer Blocks RAG-First. Prix: $5/appel (USDC Base, x402). Essai: 1 appel offert par IP.
- POST /v1/geo/social-generate : Génération de contenus multi-formats (LinkedIn, X, carrousel, débat, script vidéo, article Medium, communiqué de presse, site copy, tweet) alignés sur les barycentres d'intentions. Prix: $2/appel (contenu plafonné à 5000 caractères par format). Essai: 1 appel/jour/IP.
- POST /v1/agentic/scan : Audit complet /100 sur les 5 piliers d'éligibilité et 8 canaux de distribution machine. Prix: $10/appel. Essai: 1 appel offert par IP.

## Découverte machine
- Manifeste pricing/decouverte: GET /.well-known/x402.json
- OpenAPI 3.1: GET /api/openapi.json

## Protocoles
- Accepte 'Accept: text/markdown' pour obtenir des synthèses directes adaptées aux agents.
- Handshake HTTP 402 x402 v2 (schéma exact, USDC sur Base): sans X-PAYMENT -> 402 avec payload 'accepts'; au-dela du free tier, envoyer le header X-PAYMENT.