Tutoriel

Construisez votre propre agent d'audit IA en 5 minutes

Utilisez l'API SGE-SCORE dans ChatGPT Custom GPTs, Claude Projects, Python ou JavaScript. Pas de clé API — juste un email.

Aller directement à : ChatGPT Claude Lovable / Manus MCP Server Python JavaScript

Pourquoi construire votre propre agent ?

Pour vos clients

En tant qu'agence, proposez un audit AI-readiness automatique dans votre propre chatbot.

Pour votre équipe

Laissez vos outils internes valider chaque landing avant le lancement.

Pour des produits SaaS

Intégrez les audits SGE comme feature de votre propre outil marketing.

ChatGPT Custom GPT (5 minutes)

Le plus simple — sans programmation.

  1. 1

    Ouvrir le GPT Builder

    Allez sur chat.openai.com/gpts/editor, cliquez 'Create a GPT'. (ChatGPT Plus requis.)

  2. 2

    Onglet Configure

    Cliquez 'Configure' en haut. Donnez un nom (ex. 'SGE Audit Bot') et une description courte.

  3. 3

    Ajouter Actions

    Descendez, cliquez 'Create new action' → 'Import from URL' et collez :

    https://sge-score.com/openapi.yaml
  4. 4

    Authentication: None

    Choisissez 'None'. L'API est ouverte — protection via rate-limits (email + IP).

  5. 5

    Tester

    Dans la preview : 'Audit https://example.com — mon email est test@example.com'

Instruction système recommandée (à coller dans 'Instructions') :

Tu es un consultant AI-readiness. Quand un user donne une URL :
1. Demande son email (requis par l'API).
2. Appelle analyzeUrl avec url + email.
3. Sonde le status toutes les 8 secondes (max 90s).
4. À la fin : explique le score (0-114), liste les 3 problèmes principaux.
5. Mentionne que le Master-Fix complet avec code est dispo pour $9 (lien : masterfix_url).
Réponds dans la langue du user.

Prompt de test : "Audit https://example.com"

Claude Project (Tool Use)

Pour Claude.ai Projects ou l'API Anthropic avec Tool Use.

Ajoutez cette définition d'outil à votre Claude Project :

{
  "name": "audit_landing_page",
  "description": "Audit a landing page for AI/SGE readiness against 57 Google patent checkpoints. Returns score 0-114, failed checkpoints, and a Master-Fix purchase URL.",
  "input_schema": {
    "type": "object",
    "properties": {
      "url":   { "type": "string", "format": "uri" },
      "email": { "type": "string", "format": "email" },
      "language": { "type": "string", "enum": ["de","en","es","fr"], "default": "fr" }
    },
    "required": ["url", "email"]
  },
  "url": "https://jhocisiphtyopyxrahgo.supabase.co/functions/v1/agent-analyze",
  "method": "POST"
}

Éditeurs web IA (Lovable, Manus, Cursor, Bolt)

Après chaque audit, des boutons sur la page de résultats ouvrent votre Master-Fix directement dans l'éditeur choisi. Les prompts longs passent par un lien de partage.

1. Lancez un audit sur SGE-SCORE, achetez le Master-Fix ($9). 2. Cliquez 'Ouvrir dans Lovable' — le prompt est pré-rempli sur lovable.dev. 3. L'agent Lovable applique les correctifs.

https://lovable.dev/?prompt=<URL-encoded master-fix prompt>

MCP Server (Cursor / Claude Desktop / Windsurf)

Notre serveur MCP expose 5 outils utilisables nativement par tout client MCP (Cursor, Claude Desktop, Windsurf, Continue.dev). Sans clé API, Streamable HTTP, JSON-RPC 2.0.

Tools

  • audit_landing_page — start free audit
  • get_audit_status — poll score (0-114)
  • purchase_masterfix — $9 single (2 credits) or $99 bulk (100 credits)
  • get_masterfix — retrieve fix after payment
  • search_knowledge — search ~1500 schema/blog entries

Endpoint

Streamable HTTP, JSON-RPC 2.0, no auth.

https://jhocisiphtyopyxrahgo.supabase.co/functions/v1/mcp

Configuration pour Cursor / Claude Desktop / Windsurf :

{
  "mcpServers": {
    "sge-score": {
      "url": "https://jhocisiphtyopyxrahgo.supabase.co/functions/v1/mcp"
    }
  }
}

Discovery : /.well-known/mcp.json

Python Quickstart

Un script complet et exécutable.

Installer : pip install requests

import requests, time

API = "https://jhocisiphtyopyxrahgo.supabase.co/functions/v1"

# 1. Start audit
r = requests.post(f"{API}/agent-analyze", json={
    "url": "https://example.com",
    "email": "you@example.com",
    "language": "fr",
})
analysis_id = r.json()["analysis_id"]
print(f"Started: {analysis_id}")

# 2. Poll until completed (max ~90s)
for _ in range(18):
    time.sleep(5)
    s = requests.get(f"{API}/agent-analysis-status", params={"id": analysis_id}).json()
    if s.get("status") == "completed":
        break

print(f"Score: {s['score']}/{s['max_score']}  (Grade {s['grade']})")
print(f"Estimated after Master-Fix: {s.get('estimated_score_after_masterfix')}")
print(f"Master-Fix URL ($9): {s.get('masterfix_url')}")

for c in s.get("failed_checkpoints", [])[:3]:
    print(f"  - [{c['severity']}] {c['name']}  (Sector {c['sector']})")

# Bonus: search the knowledge base
kb = requests.get(f"{API}/agent-knowledge-search",
                  params={"q": "FAQPage schema", "limit": 3}).json()
for hit in kb.get("results", []):
    print(f"KB: {hit['name']}")

Tarifs (Agent API)

Audits gratuits. Les packs Master-Fix débloquent du code copy-paste pour chaque manque détecté.

Free Audit
$0
  • • 2 audits / 24h per email+IP
  • • Score 0–114, sectors, failed checkpoints
  • • No account, email only
Master-Fix Single
$9 USD
  • • sku=masterfix_2
  • • 2 credits, valid 30 days
  • • Bound to 1 analysis
Master-Fix Bulk (agences)
$99 USD
  • • sku=masterfix_100
  • • 100 credits, valid 12 months
  • • Rate limit lifted: 20/24h
  • • session_id = bulk_session_id

Bulk : un crédit par domaine via ?session_id=...&analysis_id=.... Analyses manuelles et API partagent la file FIFO (max 4) — pas de collision.

FAQ

Prêt ?

Besoin de la référence technique ou de la spec OpenAPI ?

Référence API complète Spec OpenAPI (YAML)Bloqué ? Contactez-nous