API REST + serveur MCP

L'API de rapports SEO pour les
développeurs et agents IA

Créez des rapports via REST, interrogez leur statut et lisez le même objet de rapport enregistré que votre équipe voit sur le site web. La même clé API connecte n'importe quel agent compatible MCP.

Modèle d'accès

Compte gratuit + clé API

L’accès API est lié au compte. Créez un compte gratuit, obtenez une clé API et commencez avec les aperçus de score. Aucune carte n’est requise pour le chemin d’évaluation.

Un objet de rapport

Sessions du site web, appels API, et sessions d'agent lisent à partir du même état de rapport enregistré

Flux simple

Créez un rapport, interrogez le statut, puis lisez l'aperçu ou les résultats complets à partir du même objet.

Voir les tarifs

Points de terminaison disponibles

POST/api/v1/reports/preview

Créer un aperçu de score pour les flux de partenariat et de lancement de produit.

POST/api/v1/reports

Créez un nouveau rapport ou réutilisez-en un qui existe déjà.

GET/api/v1/reports/:id

Obtenez le dernier statut et les sections du rapport.

GET/api/v1/reports/:id/result

Lisez les résultats complets une fois le rapport débloqué.

GET/api/v1/reports/:id/download?format=json

Exporter le payload du rapport en JSON pour les intégrations programmatiques.

Client officiel TypeScript

Authentification sans configuration, prêt pour le niveau gratuit, prêt pour la plateforme de lancement.

Voir l’intégration de la plateforme de lancementVoir la documentation

Ligne de commande

Exécutez des rapports depuis votre terminal. Une installation globale, aperçus instantanés.

Bash
npm install -g @seoreport/client
Obtenez votre clé API

Serveur MCP — même API, même clé

Pointez n'importe quel client compatible MCP vers https://seoreport.dev/mcp et authentifiez-vous avec la même clé API Bearer que pour REST. Les outils de rapport et de compte sont annoncés à la connexion : un agent peut lancer un audit et lire les constats sans code intermédiaire.

Configuration du client MCPJSON
{
  "mcpServers": {
    "seoreport": {
      "url": "https://seoreport.dev/mcp",
      "headers": {
        "Authorization": "Bearer sr__live_your_api_key"
      }
    }
  }
}
create_report

Lancez un rapport pour une URL et récupérez un identifiant de tâche.

get_report_status

Interrogez la tâche jusqu'à ce que le rapport soit prêt.

get_report

Lisez le rapport terminé avec son score et ses constats.

list_reports

Listez les rapports du compte.

get_report_download

Obtenez une URL de téléchargement en JSON, Markdown, texte ou PDF.

get_usage

Consultez les crédits restants et la période de facturation en cours.

Le paiement, la résiliation et la suppression de compte renvoient une URL de confirmation à ouvrir dans le navigateur au lieu d'agir directement. Un agent peut les amorcer ; seule une personne peut les finaliser.

Guide de configuration des agentsRéférence complète de l'API
Réponse d'exempleJSON
{
  "success": true,
  "report": {
    "jobId": "383c5318-5e81-45a8-9df8-579d10442f72",
    "stage": "snapshot_ready",
    "status": "completed",
    "targetUrl": "https://rbeckner.com",
    "isSnapshotReady": true,
    "preview": {
      "sectionKeys": ["hero_summary", "top_findings"]
    },
    "paidUnlock": {
      "unlockEligible": true,
      "unlocked": false
    }
  },
  "pollAfterMs": 0
}

Prêt à construire?

Obtenez votre clé gratuite API et commencez à intégrer les rapports SEO dans votre produit.

Démarrer un rapportObtenez votre clé API