← Updates

Public API et MCP 2.4 : filtres, annotations, share et SEO enrich

Filtres enregistrés, tags et notes sur les rapports, liens de partage invité et rechargement des métriques SEO — dans l’API REST et MCP. 31 outils au lieu de 21, la même clé API.

La Public API et le serveur MCP prennent en charge le workflow rapport complet — auparavant réservé à l’application web. Une clé Bearer depuis Profil → Paramètres ; la limite de 60 requêtes par minute est partagée entre REST et MCP.

MCP compte désormais 31 outils (21 auparavant). Nouveau groupe Report workflow — les endpoints REST sont regroupés de la même façon : Reports, Account, Report workflow, Live checkers.

Filtres enregistrés

Enregistrez un jeu de filtres de recherche par nom et appelez-le depuis un script ou le chat.

  • REST : GET / PUT / DELETE /v1/user/saved-filters
  • MCP : list_saved_filters, save_saved_filter, delete_saved_filter

Annotations et tags

Notes jusqu’à 200 caractères et jusqu’à 10 tags par rapport — pour shortlists, CRM et travail d’équipe.

  • REST : GET /v1/reports/annotations/tags, GET / PUT / DELETE /v1/reports/annotations
  • MCP : list_annotation_tags, get_report_annotation, set_report_annotation, delete_report_annotation

Liens de partage invité

Envoyez un rapport à un collègue ou un client sans accès au compte.

  • REST : POST /v1/reports/share → share_url dans la réponse
  • MCP : create_share_link

Le corps de la requête contient report_type et report_id issus de la recherche ou du rapport complet.

SEO enrich via l’API

Le chargement des métriques SEO manquantes est désormais disponible par programmation — hors file système, comme sur la fiche rapport.

  • REST : POST /v1/reports/{report_type}/{report_id}/enrich-seo (réponse 202 + job_id), puis GET /v1/reports/enrich-jobs/{job_id} jusqu’au statut done
  • MCP : enrich_report_seo, get_enrich_report_seo_job

Si MCP est déjà connecté

Inutile de changer l’URL ou la clé. Le client met en cache la liste des outils pour la session — ouvrez un nouveau chat ou redémarrez Cursor / Claude / ChatGPT. Les nouvelles routes REST sont disponibles immédiatement.

Détails, exemples curl et schémas de champs — sur les landing pages mises à jour API et MCP ; schéma complet dans Swagger UI.