Cette page répertorie tous les outils exposés par le serveur MCP Docsbook à l’adresse https://docsbook.io/api/mcp/server. Le serveur expose 309 outils. Chacun nécessite une authentification Bearer via OAuth 2.0 + PKCE.
La colonne Facturation indique la classe sous laquelle un appel est facturé, sur le solde propre au projet :
Classe
Ce qu’elle couvre
Inclus
Découverte et connexion — jamais facturées
Lecture
Lecture d’une page, d’un paramètre ou d’une ligne de registre déjà stockée par Docsbook
Écriture
Modification de quelque chose — contenu, configuration, objectifs, enregistrements
Analytique
Analyse de l’entrepôt d’événements : entonnoirs, parcours, rétention, flux
Sortie
Sortie du réseau de Docsbook — récupération d’une URL ou déclenchement d’une livraison réelle
Sonde
Collecte et normalisation d’une famille de données, sans modèle dans le processus
IA
Basée sur un modèle : quelque chose qu’un modèle rédige, lit ou classe pour vous
Agent
Une exécution complète d’agent : des minutes de travail, un rapport et son propre enregistrement d’exécution
Les tarifs actuels par classe sont publiés sur la page des tarifs de Docsbook. Un appel refusé en raison d’un solde insuffisant l’indique ; rien sur cette page n’est soumis à une autre condition.
Fonctionnalités du serveur, version, liste des outils disponibles
list_workspaces
Inclus
Tous les espaces de travail de l’utilisateur authentifié avec leurs fonctionnalités
get_workspace
Inclus
Récupérer un espace de travail par son ID ou owner/repo
create_workspace
Inclus
Créer un espace de travail à partir d’un dépôt GitHub
update_branding
Écriture
Couleurs, polices, logo, icône, thème par défaut, URL d’appel à l’action, URL source du site, prix moyen du produit
update_ui_settings
Écriture
Activer ou désactiver l’en-tête, la recherche, les commentaires, le bouton de copie et le fil d’Ariane
update_navigation
Écriture
Liens d’en-tête, liens sociaux, onglets de dossiers du sous-en-tête (avec icônes facultatives), icônes des pages et dossiers de la barre latérale gauche, et remplacements des libellés de la barre latérale — renommer l’intitulé d’une page ou d’un dossier dans la barre latérale sans modifier son adresse ni son emplacement dans l’arborescence
update_ai_settings
Écriture
Activer le chat IA, définir le fournisseur et la clé API, sélectionner le modèle — y compris utiliser la clé de votre propre fournisseur
update_seo
Écriture
Balises meta SEO, plan du site, OpenGraph
update_access
Écriture
Rendre un espace de travail privé ; définir un mot de passe et/ou utiliser votre propre fournisseur d’identité SSO/OIDC
update_domain
Écriture
Associer ou supprimer un domaine personnalisé
update_languages
Écriture
Activer les langues cibles pour la traduction par IA
Recherche en texte intégral, par expression régulière, titre ou chemin dans le contenu de documentation de l’espace de travail. En lecture seule — fonctionne avec n’importe quel jeton, quelle que soit sa portée en lecture/écriture.
search
AI
Recherche sémantique (fondée sur des embeddings) dans le contenu de documentation de l’espace de travail — trouve les pages par leur sens, et non par la simple correspondance littérale des mots-clés. Lit un index vectoriel préconstruit (aucune réindexation lors de la recherche). En lecture seule, disponible avec tous les forfaits et fourni sans jeton via un endpoint limité au dépôt pour un site public. Lorsqu’aucun index n’est créé ou activé, répond en texte intégral au lieu de refuser, et mode (semantic / lexical) indique quel moteur a répondu.
get_doc_outline
Lecture
Répertorie le titre, le nombre de titres et la taille de chaque page Markdown avant toute recherche ou écriture. En lecture seule — fonctionne avec n’importe quel jeton, quelle que soit sa portée en lecture/écriture.
write_docs
AI
Valide un ou plusieurs fichiers Markdown dans le dépôt de documentation de l’espace de travail en un seul commit git atomique. Nécessite un jeton autorisé avec une portée lecture-écriture — un jeton en lecture seule est refusé. Accepte un intent facultatif : ce que la personne a demandé, avec ses propres mots. Celui-ci est affiché avec le commit dans le panneau des modifications, afin que l’objectif d’une modification survive à la conversation qui l’a produite.
fetch_url
Sortie
Lit une page web publique et la renvoie sous forme de Markdown propre, avec son titre, sa description et l’URL finale après les redirections. Sert à vérifier une affirmation par rapport à une page située en dehors de l’espace de travail — le tarif d’un concurrent, votre propre site marketing ou le fait qu’un lien dont dépend un document fonctionne toujours. Une erreur 404 ou un écran de connexion est renvoyé comme résultat explicite plutôt que comme échec, puisque c’est la réponse lorsque la question porte sur le fonctionnement d’un lien. Les adresses privées et internes sont refusées, robots.txt est respecté et le contenu des pages est traité comme des données, jamais comme des instructions.
list_sources
Lecture
Répertorie les dépôts et les sites web auxquels cet espace de travail est connecté en tant que sources de vérité, ainsi que le dépôt à partir duquel le site est construit. Chaque entrée contient la propre note de son propriétaire expliquant pourquoi elle est connectée. En lecture seule. Appelez-le avant d’écrire ou de mettre à jour la documentation : une source connectée est un fait que vous pouvez consulter et lire au lieu de le rappeler.
read_source
Sortie
Lit l’une de ces sources. Un dépôt sans path renvoie ses fichiers lisibles et, avec celui-ci, renvoie ce fichier ; un site web sans path renvoie plusieurs de ses pages au format Markdown, découvertes depuis son propre plan du site et limitées à la section qui a été connectée. Les mêmes protections que fetch_url s’appliquent — les adresses privées sont refusées, robots.txt est respecté, et le contenu des pages est traité comme des données, jamais comme des instructions.
connect_source
Écriture
Connecte un dépôt, un site web ou une page individuelle comme source de vérité — ce que list_sources répertorie ensuite, que read_source lit et qu’un agent équipé de enable_agent surveille. Un dépôt GitHub est vérifié comme étant lisible (publiquement ou avec une autorisation GitHub déjà détenue par ce projet) avant d’être enregistré ; un dépôt privé que personne n’a encore autorisé est refusé avec l’unique information permettant de résoudre le problème, plutôt qu’enregistré sans pouvoir être lu. note contient les propres mots du propriétaire expliquant à quoi sert la source et est interprété comme une instruction par tout ce qui la lira ultérieurement. Nécessite un jeton lecture-écriture.
configure_source
Écriture
Renomme une source connectée, réécrit son note, la met en pause (enabled: false — elle reste connectée, mais plus rien ne la lit) ou la déconnecte entièrement (supprime toute autorisation GitHub qui lui est associée). Identifiez la source par source_id depuis list_sources ou par match (un mot de son libellé ou de son URL). Nécessite un jeton lecture-écriture.
Pour une navigation plus approfondie dans le graphe local (plan, titres approximatifs, références de liens, résolution des liens) lorsqu’un agent a extrait vos documents sur le disque, utilisez plutôt markdown-lsp — exécutez npx markdown-lsp <subcommand> ./docs pour exposer les outils doc_* de type LSP sur l’arborescence de travail. Consultez le README de markdown-lsp pour la configuration. search_docs/write_docs et markdown-lsp sont complémentaires : les premiers fonctionnent via la connexion MCP hébergée sans extraction locale, tandis que le dernier nécessite que le dépôt soit présent sur le disque.
Les problèmes du dépôt GitHub à partir duquel votre documentation est générée — le travail ouvert sur le projet. C'est ici qu'une découverte survit à la conversation qui l'a produite : un agent qui vient d'auditer votre documentation peut consigner ce qu'il a trouvé au lieu de le laisser dans un historique de discussion.
Ce sont les mêmes trois outils que la section Problèmes du panneau d'administration utilise pour lire et écrire ; ainsi, un problème créé depuis Claude Code apparaît dans ce tableau, et inversement.
Outil
Facturation
Description
list_issues
Lecture
Répertorie les problèmes du dépôt du projet — ouverts, fermés ou tous, avec filtrage facultatif par étiquette. Les demandes de tirage ne sont jamais incluses. Lecture seule. Appelez-le avant create_issue : un problème qui fait doublon avec un problème ouvert est pire que l'absence de problème.
get_issue
Lecture
Lit un problème dans son intégralité — son corps complet, ses étiquettes, son état et son lien. Lecture seule. Agir sur l'aperçu de 280 caractères renvoyé par list_issues revient à implémenter la mauvaise moitié d'une demande.
create_issue
Écriture
Crée un problème dans le dépôt du projet, avec un titre, un corps au format Markdown et des étiquettes. Nécessite un jeton autorisé avec la portée lecture-écriture — un jeton en lecture seule est refusé. Un appel par problème. Renvoie le numéro et le lien du problème.
Les problèmes d'un site hébergé par Docsbook résident dans le dépôt que Docsbook héberge pour ce site ; un site généré à partir de votre propre dépôt utilise ce dépôt, et un appel MCP agit comme le propre compte de Docsbook sur celui-ci — suffisamment pour lire un dépôt public et y ouvrir un problème, et renvoie une erreur d'autorisation explicite pour un dépôt privé plutôt qu'une liste vide.
L’enregistrement d’un webhook est gratuit ; seules les livraisons sortantes et les rejouements sont facturés au titre de la sortie de données.
Outil
Facturation
Description
register_webhook_<event>
Écriture
Enregistrer un webhook pour l’un des 18 événements typés (secret HMAC + URL)
list_webhooks
Lecture
Répertorier les webhooks enregistrés pour l’espace de travail
unregister_webhook
Écriture
Supprimer un abonnement à un webhook
list_webhook_deliveries
Analytique
Historique des livraisons avec statut, nombre de tentatives et charge utile
replay_webhook_delivery
Sortie
Relivrer une livraison passée spécifique
test_webhook
Sortie
Envoyer une charge utile synthétique à une URL
Il existe 18 événements typés, parmi lesquels content.indexed, translation.completed, chat.no_answer, chat.negative_feedback et usage.limit_approaching — consultez Webhooks pour obtenir la liste complète et les schémas des charges utiles.
Rechercher dans le catalogue docs-skills par query avec des filtres category et requires_plan facultatifs. Renvoie raw_url afin que l’agent récupère directement le fichier SKILL.md.
135 outils en lecture seule. Chacun correspond à une action sur un sujet, et non à une discipline entière : observe_link_graph signale les liens entre vos pages, decide_next_market sélectionne un marché et explique pourquoi pas les autres, draft_comparison_page rédige la page. L’appelant choisit une étape, pas un service.
La famille est le croisement de trois axes, et chaque outil déclare sa position sur chacun d’eux :
Le verbe détermine la forme de la réponse et ce que l’exécution refuse.
Le domaine détermine le sujet et les éléments probants qu’il consulte.
Le résultat — charge du support, trafic organique, citations par l’IA, délai de réponse, conversion et huit autres — est le chiffre que l’on attend de cet outil, et il est nommé dans sa propre description.
Verbe
Répond avec
Refuse
observe_*
Ce qui existe, avec la source de chaque ligne
De recommander quoi que ce soit
explain_*
Le mécanisme sous-jacent, et non une corrélation reformulée
Une histoire qu’il ne peut pas relier à une étape
discover_*
Ce qui manque, nommé avec suffisamment de précision pour être créé
« Plus de contenu sur X »
decide_*
Un choix, avec chaque rejet et sa raison
Renvoyer une liste classée au lieu d’une décision
plan_*
Une séquence ordonnée dont la première étape est un appel
Planifier au-delà de la première chose susceptible de l’invalider
draft_*
L’artefact lui-même, prêt à être appliqué
Renvoyer un brief en le présentant comme une ébauche
measure_*
Un tableau de scores calculé par nos soins, comparable d’une exécution à l’autre
Écrire un score ou combler une lacune par un zéro
verify_*
Un verdict par rapport à un contrôle, avec la possibilité de conclure « trop tôt »
Conclure « confirmé » sur une période trop courte
learn_*
Une règle transférable et la limite de son application
Une leçon sans limite
handoff_*
L’appel exact, ses arguments et le contrôle d’acceptation
Un travail dont il ne peut pas énoncer le test d’acceptation
Chacun renvoie une charge utile JSON validée plutôt qu’un paragraphe de prose : une carte evidence contenant chaque fait brut recueilli par l’exécution, ainsi que des affirmations qui ne peuvent énoncer qu’un nombre apparaissant dans les éléments probants qu’elles citent. Un nombre qui ne renvoie à aucune source fait échouer l’exécution au lieu d’être livré ; vous n’avez donc pas à vérifier qu’un chiffre a été inventé.
Lorsqu’un outil attribue un score — les quinze outils measure_*, un par domaine — le score est calculé par nos soins à partir des éléments probants recueillis, avec ses pondérations publiées dans la charge utile, et non rédigé par le modèle. Un score de 0 à 100 produit par un modèle n’est pas comparable à celui du même modèle la semaine suivante, ce qui détruit la seule raison d’en avoir un : observer son évolution. Un axe qui n’a pas pu être vérifié est signalé comme non mesuré, jamais comme zéro.
Les 135 outils ne modifient rien et fonctionnent avec un jeton en lecture seule : les écritures sont refusées pendant toute l’exécution. Chacun est facturé dans la classe Agent. Cela inclut draft_*, qui produit la page ou le bloc et nomme l’appel qui permettrait de l’appliquer (run_docs_create / run_docs_manage) au lieu de l’appliquer lui-même. Chaque ligne contient cet appel, de sorte qu’une analyse peut être transmise sans qu’un humain ait à traduire entre les deux.
Le prix de chacun est calculé à partir du travail qu’il déclare — le nombre de familles d’éléments probants qu’il consulte, le nombre d’allers-retours avec le modèle qu’il peut effectuer, s’il sort de votre site, s’il produit un artefact — de sorte qu’une observation ciblée coûte une fraction du prix d’une ébauche approfondie, au lieu que chaque action soit facturée au même tarif forfaitaire d’agent. Le délai d’attente varie de la même manière, et le délai habituel est indiqué pour chaque outil ci-dessous. Le prix actuel de chaque outil est affiché à côté de celui-ci dans le panneau et sur la page de tarification de Docsbook.
Une ligne par capacité réellement exposée par votre produit, à côté de la page qui la documente — et l’emplacement vide lorsqu’aucune page n’existe.
~41 s
explain_capability_confusion
Le mécanisme qui pousse les lecteurs à demander quelque chose que le produit fait déjà — la formulation exacte, l’emplacement ou l’absence qui rend une capacité existante invisible.
~45 s
discover_undocumented_capabilities
Les capacités qui existent dans le produit et n’apparaissent nulle part dans la documentation, chacune nommée avec suffisamment de précision pour rédiger une page dès demain.
~45 s
decide_capability_priority
Une capacité à documenter ensuite, avec toutes les alternatives sérieuses listées et la raison pour laquelle chacune a été écartée.
~26 s
plan_capability_page_set
L’ensemble des pages dont une capacité a réellement besoin — et, tout aussi important, les pages dont elle n’a pas besoin — dans l’ordre où elles doivent être rédigées.
~39 s
draft_capability_matrix
Une page de matrice des capacités terminée — chaque capacité, son état, son jalon de planification et son lien vers la page — en markdown prêt à être intégré.
~52 s
measure_capability_coverage
Une grille d’évaluation reproductible de la part du produit réellement couverte par la documentation, selon cinq axes définis par des personnes différentes.
~45 s
verify_capability_claims
Pour chaque capacité revendiquée par la documentation, un verdict indiquant si le produit la propose toujours — avec la source qui permet de trancher.
~52 s
handoff_capability_backlog
Le travail sur les capacités préparé pour la personne qui l’exécutera ensuite : l’appel exact, ses arguments et la manière de savoir qu’il a fonctionné.
Les tâches que les lecteurs ont formulées avec leurs propres mots — à partir des questions posées à l’assistant et des recherches — regroupées, comptées et citées textuellement.
~32 s
explain_job_abandonment
L’endroit où une tâche cesse de pouvoir être accomplie, ainsi que le mécanisme qui l’interrompt — l’étape, le prérequis manquant ou la phrase que les lecteurs rencontrent avant de partir.
~42 s
discover_unserved_jobs
Les tâches que votre produit peut prendre en charge et que votre documentation n’aborde nulle part — déduites de la capacité au lecteur, car une tâche prise en charge nulle part ne laisse aucune trace à mesurer.
~48 s
decide_primary_job
L’unique tâche autour de laquelle cette documentation devrait être organisée, avec les tâches concurrentes nommées et le coût de chaque rejet explicité.
~32 s
plan_job_journey
La séquence ordonnée de pages qui mène une tâche du premier contact à son accomplissement, avec les lacunes de cette séquence signalées.
~33 s
draft_job_walkthrough
La page de guide elle-même, rédigée de bout en bout pour une tâche, avec chaque prérequis indiqué et chaque étape vérifiable.
~55 s
measure_job_completion
Un tableau de bord indiquant si les lecteurs ayant une tâche l’accomplissent réellement — entrée, poursuite, impasses, résultats déclarés et retour.
~39 s
verify_job_now_served
Si les pages rédigées pour une tâche ont effectivement changé ce que font les lecteurs — avant, après, période, contrôle, verdict.
~36 s
learn_job_patterns
La règle qui sous-tend les tâches que votre documentation prend bien en charge, formulée de manière à pouvoir être transposée — ainsi que la limite au-delà de laquelle elle cesse de s’appliquer.
Tous les sujets couverts par ce corpus, avec le nombre de pages qui les traitent, le niveau de profondeur atteint par la plus approfondie et le nombre de pages qui y renvoient.
~32 s
explain_authority_shortfall
Pourquoi ce corpus donne l’impression d’être un site qui mentionne un sujet plutôt que le site de référence sur celui-ci — avec l’absence précise qui produit cette impression.
~39 s
discover_missing_entities
Les entités qu’un sujet exige et que ce corpus ne nomme jamais — les concepts, outils, formats et modes d’échec qu’un lecteur s’attend à voir traités par une véritable source.
~39 s
decide_topic_cluster_focus
Le seul groupe de sujets à développer ensuite, avec les concurrents nommés et la raison pour laquelle chacun a été écarté.
~32 s
plan_topic_cluster
Le hub et ses pages satellites : toutes les pages nécessaires au groupe, le rôle de chacune, leurs liens et l’ordre dans lequel les rédiger.
~33 s
draft_topic_hub_page
La page hub elle-même, rédigée : la définition, la cartographie des sous-sujets et les liens qui transforment le groupe en graphe.
~46 s
measure_topical_depth
Un score reproductible permettant de déterminer si le corpus est perçu comme une autorité sur ses sujets — définition, couverture, relations, preuves et interconnexion.
~36 s
verify_cluster_effect
Si un groupe que vous avez créé a réellement produit des résultats — classements, arrivées ou citations — par rapport à un contrôle et sur une période définie.
~36 s
learn_authority_wins
La règle qui sous-tend les sujets sur lesquels ce site s’est effectivement imposé — ce que ces pages avaient contrairement aux autres, et où cette règle cesse de s’appliquer.
Les requêtes pour lesquelles ce site est trouvé, classées selon l’intention portée par chacune — tutoriel, définition, comparaison, erreur, prix, référence.
~32 s
explain_intent_mismatch
Pourquoi une page bien classée perd malgré tout le lecteur — l’écart précis entre la forme de la question et celle de la page.
~36 s
discover_intent_gaps
Les intentions avec lesquelles les lecteurs arrivent manifestement, auxquelles aucune page de ce site n’est conçue pour répondre.
~36 s
decide_page_shape
Ce que doit être UNE page — tutoriel, guide pratique, référence, explication ou comparaison — compte tenu des intentions qui l’atteignent réellement, avec les formats rejetés indiqués.
~26 s
plan_intent_coverage
L’ensemble ordonné des pages qui couvriraient les intentions attirées par ce site, chacune conçue pour répondre exactement à l’une d’elles.
~30 s
draft_intent_matched_opening
Le titre, la description et le premier écran réécrits d’une page, adaptés à l’intention pour laquelle elle est réellement classée — rédigés et prêts à être appliqués.
~39 s
measure_intent_match
Une grille d’évaluation de la correspondance entre les pages présentées aux lecteurs et les intentions avec lesquelles ils sont arrivés, selon cinq axes calculés à partir d’observations.
~36 s
verify_intent_fix
Si une réécriture fondée sur l’intention a effectivement modifié les clics ou l’engagement — avec un groupe témoin et le délai des données de recherche pris en compte.
~36 s
handoff_intent_rewrites
Les réécritures fondées sur l’intention présentées sous forme d’actions : quelle page modifier, par quoi la remplacer et quelle requête la modification doit remporter.
Les modèles d’URL de ce site qui se répètent déjà selon un axe, avec le nombre de membres existants et le nombre réel de membres de l’axe.
~26 s
explain_thin_family_pages
Pourquoi les membres générés d’une famille sont sous-performants — le champ qui est vide, identique ou inventé pour la plupart d’entre eux.
~36 s
discover_scalable_patterns
Les modèles de recherche récurrents auxquels ce produit pourrait répondre à grande échelle — l’axe, le modèle de requête et le fait unique que chaque membre contiendrait.
~48 s
decide_family_worth_building
Un verdict unique sur la pertinence de créer une famille proposée, avec les alternatives nommées et la condition d’arrêt énoncée d’emblée.
~30 s
plan_family_rollout
Le déploiement : quels membres sont publiés en premier, quelles données les alimentent, quels sont les garde-fous et où se situe le point de contrôle.
~42 s
draft_family_template
Le modèle lui-même — la structure de la page, les variables propres à chaque membre et deux exemples de membres entièrement générés.
~58 s
measure_family_coverage
Une fiche d’évaluation par famille : la part de l’axe couverte, le degré de distinction entre les membres, la qualité de leurs liens et l’actualité de leurs faits.
~32 s
verify_family_indexation
Si les membres générés sont effectivement accessibles et indexés — récupérés en direct, avec ceux qui ne le sont pas nommés individuellement.
~45 s
learn_family_thresholds
Le seuil au-dessus duquel un membre généré apporte une quelconque valeur sur ce site — énoncé sous forme de règle avec les cas qui la sous-tendent.
Les demandes que les lecteurs formulent déjà et qui ressemblent à un outil — calculer, convertir, valider, générer, vérifier — citées et comptabilisées.
~32 s
explain_tool_underuse
Pourquoi un outil gratuit existant n’est pas utilisé — le point d’entrée, la friction ou le décalage qui empêchent les lecteurs d’y accéder ou d’aller jusqu’au bout.
~45 s
discover_tool_ideas
Les outils gratuits que ce produit pourrait héberger de manière crédible, avec pour chacun la requête à laquelle il répondrait et les données qui le rendent possible.
~48 s
decide_tool_to_build
Un outil à créer, les autres écartés avec leurs raisons, et le coût de maintenance de celui qui a été retenu établi avant que quiconque ne commence.
~39 s
plan_tool_launch
Le lancement : où l’outil est hébergé, quels liens y mènent, ce qu’il propose ensuite au lecteur et comment sa réussite sera évaluée.
~33 s
draft_tool_page
La page de l’outil, rédigée : ce qu’il fait au-dessus de la ligne de flottaison, l’exemple détaillé, la méthode utilisée et l’étape suivante — ainsi que les spécifications d’intégration du widget lui-même.
~58 s
measure_tool_pull
Un tableau de bord des résultats réellement générés par un outil — arrivées, achèvement, poursuite de la navigation, liens obtenus et lisibilité autonome.
~32 s
verify_tool_traffic
Si le lancement de l’outil a produit un changement mesurable — par rapport à un groupe témoin, sur une période donnée, avec une conclusion pouvant être « trop tôt ».
~32 s
handoff_tool_build
L’outil spécifié pour la personne qui le construira : entrées, règles, sorties, cas limites et contrôle d’acceptation qu’il doit réussir.
Les données que ce produit détient déjà et que personne à l’extérieur ne peut calculer — ce qu’elles couvrent, jusqu’où elles remontent et si elles peuvent seulement être publiées.
~41 s
explain_research_ignored
Pourquoi une étude publiée n’a obtenu aucune citation — la méthode manquante, le format impossible à citer ou l’affirmation absente que quelqu’un aurait pu reprendre.
~48 s
discover_research_questions
Les questions auxquelles vos propres données pourraient répondre et auxquelles personne d’autre ne peut répondre, chacune accompagnée du découpage des données qui y répondrait et du public qui la reprendrait.
~45 s
decide_research_to_publish
Une étude à mener, avec les questions écartées nommées et le risque honnêtement énoncé : que se passe-t-il si la réponse est sans intérêt.
~30 s
plan_research_release
La publication : le découpage à exécuter, la méthode à présenter, les artefacts à publier et la cadence qui la rend reproductible l’année prochaine.
~33 s
draft_research_report
Le rapport lui-même : l’affirmation principale en une phrase que l’on peut citer, les chiffres avec leurs dénominateurs, la méthode et les limites.
~68 s
measure_research_citations
Un tableau de bord de la citabilité réelle de la recherche publiée — affirmation citable, méthode énoncée, données accessibles, datation et lisibilité machine.
~45 s
verify_research_claims
Si chaque chiffre publié reste valide lorsque le même découpage est réexécuté — avec les divergences nommées individuellement.
~39 s
learn_research_formats
La règle qui explique quelles publications parmi celles que vous avez publiées ont été reprises — le format, la formulation de l’affirmation ou le rythme de publication — et où elle cesse de s’appliquer.
Ce que les moteurs de réponse disent actuellement sur ce produit, et quelle source ils ont utilisée pour l’affirmer — avec citation, date et les questions qui ont produit ce résultat.
~46 s
explain_citation_absence
Pourquoi cette documentation n’est pas la source citée par un assistant — la propriété précise de la page qui la rend impossible à citer.
~48 s
discover_quotable_atoms
Les passages autonomes que ce corpus devrait contenir et ne contient pas — une question, une réponse complète, citable sans son contexte.
~39 s
decide_geo_surface_priority
Quelle surface machine corriger en premier — structure de la page, llms.txt, données structurées, flux ou accès des robots d’exploration — le reste étant classé puis écarté.
~39 s
plan_geo_surfaces
Le travail à effectuer dans l’ordre sur les surfaces machine, chaque étape indiquant le paramètre ou la page concernée ainsi que la vérification qui prouve sa mise en place.
~39 s
draft_answer_blocks
Les passages citables eux-mêmes — question, réponse complète, source et date — rédigés pour être repris intégralement tout en restant exacts.
~55 s
measure_ai_visibility
Un tableau de bord indiquant dans quelle mesure ce produit est présent dans les moteurs de réponse — présence, exactitude, attribution, fraîcheur et part des questions couvertes.
~48 s
verify_citation_gain
Si le travail GEO a modifié ce que disent les assistants — les mêmes questions posées avant et après, avec une comparaison littérale des réponses.
~45 s
learn_citation_patterns
La règle qui détermine quelles pages sont citées — la structure, la position de la réponse, la date — avec ses limites.
Ce que contient réellement la documentation d’un concurrent donné — sections, types de pages, ce qu’il documente et que vous ne documentez pas — récupéré et daté.
~46 s
explain_switching_objections
L’objection précise qu’un évaluateur forme en lisant les deux ensembles de documentation — ainsi que la page et la phrase de la vôtre qui la suscitent.
~48 s
discover_market_gaps
Les besoins auxquels ni vous ni les concurrents nommés ne répondent — avec les preuves que quelqu’un a ce besoin et que personne n’y répond.
~52 s
decide_positioning_wedge
La comparaison unique que ce produit devrait proposer, ainsi que celles qu’il devrait refuser et la raison de chaque refus.
~33 s
plan_comparison_pages
L’ensemble des pages comparatives qui valent la peine d’être créées, ce que chacune doit contenir pour être crédible et l’ordre dans lequel les rédiger.
~39 s
draft_comparison_page
La page comparative elle-même, rédigée à partir de preuves récupérées — chaque affirmation concernant l’autre partie étant datée et sourcée, y compris celles où elle l’emporte.
~58 s
measure_competitive_coverage
Une grille d’évaluation de la position de votre documentation par rapport à celle de concurrents nommés, sur les aspects que les évaluateurs consultent réellement.
~48 s
verify_competitor_claims
Si les affirmations que vos pages formulent au sujet des concurrents sont toujours vraies aujourd’hui — chacune étant vérifiée à nouveau, les informations obsolètes étant indiquées.
~42 s
learn_competitor_moves
Ce qui a changé du côté des concurrents depuis la dernière vérification, ainsi que la tendance qui se dégage — formulée sous la forme de ce qu’il faut surveiller ensuite.
Les mots que les lecteurs saisissent et demandent réellement, textuellement et décomptés, à côté du terme que votre documentation utilise pour désigner la même chose.
~29 s
explain_term_misses
Pourquoi le terme d'un lecteur ne renvoie aucun résultat — et laquelle des deux causes très différentes l'explique : un concept nommé différemment ou un concept totalement absent.
~36 s
discover_missing_synonyms
Les autres noms des concepts que vous documentez déjà qui n'apparaissent nulle part dans le corpus — chacun accompagné de la page qui devrait le porter.
~32 s
decide_canonical_terms
Un nom canonique par concept, les noms rejetés étant conservés comme synonymes plutôt que supprimés, avec la raison de chaque choix.
~30 s
plan_terminology_migration
Le plan ordonné pour appliquer une décision de terminologie à l'ensemble du corpus, y compris les pages qui ne doivent pas changer et pourquoi.
~30 s
draft_glossary_entries
Les entrées du glossaire elles-mêmes — chaque concept défini en une phrase qu'un nouvel arrivant peut utiliser, avec ses synonymes et la page qui en est responsable.
~52 s
measure_vocabulary_alignment
Un tableau de bord indiquant à quel point le langage du corpus diffère de celui des lecteurs — couverture de leurs termes, cohérence du nôtre et proportion des recherches résolues.
~32 s
verify_renaming_effect
Si l'ajout des mots des lecteurs a réellement réduit les échecs — les mêmes recherches avant et après, avec un contrôle.
~32 s
handoff_term_changes
Le travail de terminologie présenté sous forme de demandes : quelle page, quel terme devient lequel et quelle recherche doit ensuite cesser d'échouer.
La forme du corpus tel qu'il est : sections, profondeur de chaque branche, taille des pages et part du corpus effectivement atteinte par la navigation déclarée.
~26 s
explain_navigation_failure
Pourquoi les lecteurs ne trouvent pas ce qu'ils cherchent — le décalage précis entre l'arborescence que vous avez déclarée et les parcours que les lecteurs suivent réellement.
~42 s
discover_orphan_pages
Les pages vers lesquelles aucun lien ne pointe et les pages que les lecteurs atteignent sans pouvoir en sortir — les deux extrémités du corpus invisibles depuis l'intérieur de l'arborescence.
~32 s
decide_structure_model
Le principe d'organisation que ce corpus devrait adopter — par tâche, par domaine produit, par type de page ou par audience — ainsi que les modèles écartés et leurs coûts.
~36 s
plan_restructure
La liste des déplacements : quelle page va où et dans quel ordre, avec chaque changement d'URL et la redirection qu'il nécessite indiqués sur leur propre ligne.
~39 s
draft_navigation_tree
La navigation elle-même, transcrite — l'arborescence complète avec des libellés formulés dans les mots des lecteurs, prête à être appliquée.
~42 s
measure_findability
Un tableau de bord indiquant si un lecteur peut passer de l'endroit où il arrive à ce dont il a besoin — accessibilité, équilibre de la profondeur, orientation, points d'entrée et solution de repli par la recherche.
~39 s
verify_restructure_effect
Si une restructuration a été utile — les mêmes mesures de trouvabilité et de comportement avant et après, avec les redirections vérifiées et une section témoin.
~45 s
learn_structure_lessons
La règle qui sous-tend les sections efficaces de ce corpus — comment elles sont regroupées, jusqu'où elles vont, comment elles s'ouvrent — et où elle cesse de s'appliquer.
Le corpus sous forme de graphe : quelles pages renvoient vers quelles autres, combien d’arêtes entrantes et sortantes chacune possède, et quelles pages le graphe considère comme des hubs.
~29 s
explain_unreachable_pages
Pourquoi une page est en pratique inaccessible — l’arête manquante, le lien que personne ne suit ou le texte d’ancrage qui ne donne aucune raison de cliquer.
~36 s
discover_missing_links
Les paires de pages qui traitent de la même entité sans renvoyer l’une vers l’autre — chacune avec la phrase où le lien doit être inséré.
~39 s
decide_hub_pages
Quelles pages deviennent des hubs — celles vers lesquelles tout le reste pointe — avec les candidates écartées et les raisons de leur rejet.
~30 s
plan_linking_pass
La passe de maillage : quelles pages sont modifiées, dans quel ordre, combien de liens chacune gagne et la règle qui l’empêche de devenir du spam de liens.
~30 s
draft_link_insertions
Les modifications exactes : pour chaque page, la phrase telle qu’elle apparaîtra après l’insertion du lien, avec le texte d’ancrage et la cible.
~46 s
measure_graph_health
Un tableau de bord du graphe de liens — connectivité, concentration des hubs, franchissement des clusters, qualité des ancres et nombre de pages qui dépendent uniquement de la navigation.
~36 s
verify_link_effect
Si une passe de maillage interne a changé quoi que ce soit — arrivées sur les pages liées, taux d’impasses et classements, par rapport à un groupe témoin.
~36 s
handoff_link_edits
Les modifications de liens regroupées par page sous forme d’appels, avec le contrôle d’acceptation formulé comme une arrivée ou un décompte des liens entrants.
Les éléments de crédibilité que les pages contiennent réellement — auteurs, dates, sources, chiffres avec dénominateurs, exemples détaillés, limites énoncées — page par page.
~32 s
explain_disbelief
Pourquoi un lecteur ne croit pas une page pourtant factuellement correcte — le chiffre non sourcé, la limite non énoncée ou l’affirmation que vous êtes le seul à formuler.
~45 s
discover_unsourced_claims
Chaque affirmation des pages importantes sur le plan commercial qui ne comporte ni source, ni dénominateur, ni date — listée individuellement.
~35 s
decide_evidence_standard
Les preuves que chaque catégorie d’affirmations doit fournir avant de pouvoir être publiée — décidées une fois pour toutes, avec les critères rejetés et leur coût.
~29 s
plan_trust_upgrade
Le travail priorisé qui amène les pages au niveau de preuve requis, en commençant par les pages sur lesquelles la confiance est réellement accordée.
~30 s
draft_evidence_blocks
Les affirmations réécrites elles-mêmes — chacune avec sa source, son dénominateur, sa date et la limitation indiquée à côté.
~55 s
measure_trust
Une grille d’évaluation de la crédibilité selon cinq axes — la vérifiabilité en premier, car c’est le seul que la concurrence ne peut pas copier en un après-midi.
~45 s
verify_claim_freshness
Si chaque affirmation datée ou numérique est toujours vraie aujourd’hui — revérifiée par rapport à sa source, les affirmations obsolètes étant nommées individuellement.
~48 s
learn_trust_objections
Le schéma récurrent des objections dans tout ce que les lecteurs ont mis en doute — formulé comme une règle concernant ce que ce public a besoin de voir prouvé.
Qui fait actuellement référence à ce produit publiquement, ce que ces personnes en disent et s'il s'agit d'un lien, d'une mention ou d'une citation.
~42 s
explain_unlinkable_pages
Pourquoi personne ne crée de lien vers une page — ce qui lui manque et dont aurait besoin une personne rédigeant un contenu sur ce sujet.
~45 s
discover_link_targets
Les endroits précis qui seraient susceptibles de faire référence à ce produit — chacun avec la page vers laquelle il créerait un lien et la raison pour laquelle il le ferait.
~51 s
decide_linkable_asset
La ressource unique à créer pour obtenir des références — données, outil, définition ou argument — avec les options écartées et les raisons de leur rejet.
~39 s
plan_outreach_sequence
Le plan de prise de contact sous forme de lignes ordonnées : qui contacter, dans quel ordre, avec quel contenu et selon quelle condition d'arrêt.
~42 s
draft_outreach_pitch
Le message lui-même, rédigé pour chaque cible — ce à quoi il fait référence sur sa page, ce qu'il propose et l'unique demande formulée.
~51 s
measure_linkability
Une grille d'évaluation du potentiel de citation de ce corpus — faits uniques, sections vers lesquelles pointer, format citable, fraîcheur et permanence des URL.
~45 s
verify_mention_gain
Si de nouvelles références sont effectivement apparues après le travail — recherche effectuée à nouveau, comparaison avec l'ensemble initial et trafic de référence associé.
~42 s
handoff_pr_targets
La prise de contact préparée pour une personne : la cible, sa page, le message rédigé, la demande et la signification d'une réponse.
D'où viennent déjà les lecteurs — pays, langues, sites référents — et à quel point chaque groupe se comporte différemment une fois arrivé ici.
~32 s
explain_market_stall
Pourquoi un marché qui arrive ne convertit pas — la langue, l'exemple, l'hypothèse de tarification ou la preuve manquante qui l'arrête.
~42 s
discover_adjacent_markets
Les publics que ce produit pourrait servir mais qu'il n'atteint pas du tout — avec, pour chacun, les preuves que le besoin existe et l'obstacle à franchir.
~48 s
decide_next_market
Un marché à conquérir ensuite, les autres étant écartés, avec le coût récurrent de ce choix indiqué avant tout engagement.
~36 s
plan_market_entry
Le plan d'entrée : quelles pages créer en premier, ce qui doit être localisé au-delà de la langue et le point de contrôle qui détermine s'il faut poursuivre.
~33 s
draft_market_landing
La page d'accueil du marché, rédigée dans sa langue avec ses exemples, sa devise et les preuves demandées par ce marché.
~46 s
measure_market_readiness
Un tableau de bord indiquant si la documentation est prête pour un marché — couverture, localisation au-delà de la langue, preuves, découvrabilité et maintenance.
~36 s
verify_market_traction
Si l'entrée sur le marché a changé quoi que ce soit — arrivées, résultats et retours de ce marché, comparés à un groupe témoin et sur une période définie.
~36 s
learn_expansion_lessons
La règle qui explique les marchés ayant fonctionné ici — ce qui a été fait pour eux et pas pour les autres — avec ses limites.
~32 s
La plupart acceptent un request facultatif formulé avec vos propres mots, qui resserre l'exécution sans remplacer la méthode, ainsi que les entrées typées nécessaires à sa question (path, path_prefix, pages, competitors, window_days). Une charge utile qui ne respecte pas son propre contrat est signalée comme un échec, avec la liste des violations — jamais comme une réponse réussie avec un résultat vide, car « aucune constatation » se lit comme « le site va bien ».
Collecteurs — les éléments probants, sans leur interprétation#
Cinq outils appartiennent à cette famille, dans une catégorie tarifaire moins chère qui leur est propre, Probe : collect_page_text, collect_corpus_map, collect_assistant_questions, collect_traffic et collect_onsite_search. Ils renvoient les lignes normalisées qu’une action aurait lues, ainsi qu’un bloc reproduce indiquant les appels exacts à l’origine de chaque ligne — aucun modèle n’intervient dans le processus, il n’y a donc rien en eux qu’il faudrait remettre en question. Achetez-en un lorsque vous voulez obtenir les chiffres avant de décider si vous souhaitez acheter leur interprétation. audit_geo subsiste également de la génération précédente : sa couche de preuves repose sur du code plutôt que sur un modèle, et il indique si les moteurs de réponse peuvent récupérer vos pages ou non.
find_skill transmet le SKILL.md à votre agent pour exécution. Ces outils font l’inverse : ils exécutent la compétence du côté de Docsbook, sur votre espace de travail, avec l’ensemble des outils administratifs pour lesquels la compétence a été conçue — ainsi, un assistant auquel aucun autre outil Docsbook n’est connecté peut quand même effectuer le travail.
Chaque appel à run_docs_* renvoie immédiatement { run_id, state }. Il ne renvoie pas le résultat — le travail prend plusieurs minutes, et un appelant qui présente le démarrage comme la réponse rend compte d’un travail qui n’a pas encore eu lieu. Interrogez get_agent_run avec le run_id renvoyé.
Outil
Facturation
Description
run_docs_analyze
Agent
Exécute la compétence docs-analyze : audite le site à partir de données réelles et indique ce qui ne va pas ainsi que son coût. Mode d’audit déclaré — les écritures sont refusées pendant toute l’exécution, ce qui permet de fonctionner avec un jeton en lecture seule.
run_docs_create
Agent
Exécute la compétence docs-create : crée la documentation à partir de votre site, d’un dépôt, d’une autre plateforme de documentation ou du seul nom d’un produit. Valide les pages — nécessite un jeton en lecture-écriture.
run_docs_manage
Agent
Exécute la compétence docs-manage : réécrit les pages et configure le site conformément au guide de rédaction et d’administration du site. Nécessite un jeton en lecture-écriture.
run_docs_automate
Agent
Exécute la compétence docs-automate : configure des protections contre la dérive, des abonnements aux événements, des vérifications sur les modifications entrantes, des alertes et des moniteurs permanents. Nécessite un jeton en lecture-écriture.
get_agent_run
Lecture
État d’une exécution (queued, running, succeeded, failed, canceled, expired), progression en temps réel pendant son déroulement et, une fois réussie, résultat complet : le rapport, chaque action effectuée et les modifications apportées au site.
list_agent_runs
Lecture
Vos exécutions récentes, de la plus récente à la plus ancienne. Utilisez-le pour vérifier si la tâche est déjà en cours avant d’en démarrer une seconde.
cancel_agent_run
Lecture
Arrête une exécution qui n’est pas terminée. Cela n’annule pas ce que l’exécution a déjà fait — les pages qu’elle a déjà validées restent validées.
Une exécution appartient au compte qui l’a démarrée : le run_id d’un autre compte renvoie exactement le même résultat que pour un compte inconnu. Une exécution en file d’attente qui n’a pas démarré au bout de quelques heures expire au lieu d’être exécutée en retard, car un audit répond à une question sur l’état du site au moment où elle a été posée. De plus, une exécution n’est tentée qu’une seule fois, sans nouvelle tentative — une exécution échouée peut déjà avoir validé des pages, et une seconde tentative les validerait deux fois.
Les outils ci-dessus s'exécutent une fois, sur demande. Ces deux outils activent une route permanente qui s'exécute de manière autonome — selon un calendrier, lors d'un événement émis par cet espace de travail ou lors de nouveaux commits vers un dépôt connecté — le même catalogue que celui affiché et activé par l'onglet Agents du panneau d'administration.
Outil
Facturation
Description
find_agent
Lire
Recherchez dans le catalogue des routes que cet espace de travail peut activer en fonction du résultat souhaité (« garder la documentation synchronisée avec le dépôt », « traduire », « surveiller le trafic »). Chaque résultat contient state — indiquant si cet espace de travail l'a déjà activée et dans quel contexte — afin de distinguer « rien ne surveille le dépôt » de « activée, mais en échec depuis mardi ». Appelez cet outil avant de proposer de configurer quelque chose manuellement : la route existe généralement déjà.
enable_agent
Écrire
Activez (ou désactivez) un agent du catalogue de find_agent à l'aide de son agent_key. Ce qui le déclenche est exactement l'un des éléments suivants : schedule (une expression cron, avec une fréquence maximale d'une fois par heure), on_event (un événement émis par cet espace de travail) ou watch_source_id (un dépôt GitHub connecté depuis list_sources/connect_source — l'agent s'exécute sur les commits qui y sont poussés). L'activation sur un dépôt enregistre son commit actuel ; la première exécution a donc lieu lors du prochain push, et non par la relecture de tout son historique. enabled: false le désactive sans oublier la manière dont il a été configuré. Nécessite un jeton en lecture-écriture.
