Esta página lista todas as ferramentas expostas pelo servidor MCP do Docsbook em https://docsbook.io/api/mcp/server. O servidor expõe 309 ferramentas. Cada uma requer autenticação Bearer via OAuth 2.0 + PKCE.
A coluna Faturamento indica a classe sob a qual uma chamada é contabilizada, usando o saldo do próprio projeto:
Classe
O que ela abrange
Incluída
Descoberta e conexão — nunca contabilizadas
Leitura
Lê uma página, uma configuração ou uma linha de registro que o Docsbook já armazena
Escrita
Altera algo — conteúdo, configuração, metas, registros
Análises
Examina o armazém de eventos: funis, jornadas, retenção, feeds
Saída
Sai da rede do Docsbook — busca uma URL ou realiza uma entrega real
Sondagem
Coleta uma família de informações e a normaliza, sem nenhum modelo no fluxo
IA
Baseada em modelo: algo que um modelo escreve, lê ou classifica para você
Agente
Uma execução completa de agente: minutos de trabalho, um relatório e seu próprio registro de execução
As tarifas atuais por classe estão publicadas na página de preços do Docsbook. Uma chamada recusada por saldo insuficiente informa isso; nada nesta página é condicionado a qualquer outra coisa.
Capacidades do servidor, versão, lista de ferramentas disponíveis
list_workspaces
Incluído
Todos os espaços de trabalho do usuário autenticado com suas capacidades
get_workspace
Incluído
Buscar um espaço de trabalho por ID ou owner/repo
create_workspace
Incluído
Criar um espaço de trabalho a partir de um repositório do GitHub
update_branding
Escrita
Cores, fontes, logotipo, ícone, tema padrão, URL de chamada para ação, URL de origem do site, preço médio do produto
update_ui_settings
Escrita
Ativar ou desativar cabeçalho, pesquisa, feedback, botão de cópia e breadcrumbs
update_navigation
Escrita
Links do cabeçalho, links sociais, abas de pastas do subcabeçalho (com ícones opcionais), ícones de páginas/pastas da barra lateral esquerda e substituições de rótulos da barra lateral — renomeando o que uma página ou pasta exibe na barra lateral sem mover seu endereço ou seu lugar na árvore
update_ai_settings
Escrita
Ativar o chat de IA, definir o provedor e a chave de API, selecionar o modelo — incluindo usar a chave do seu próprio provedor
update_seo
Escrita
Metatags de SEO, sitemap, OpenGraph
update_access
Escrita
Tornar um espaço de trabalho privado; definir uma senha e/ou usar seu próprio provedor de identidade SSO/OIDC
Pesquisa de texto completo/regex/títulos/caminhos no conteúdo da documentação do workspace. Somente leitura — funciona com qualquer token, independentemente do escopo de leitura/gravação.
search
IA
Pesquisa semântica (baseada em embeddings) no conteúdo da documentação do workspace — encontra páginas por significado, não por sobreposição literal de palavras-chave. Lê um índice vetorial pré-criado (sem reindexação durante a pesquisa). Somente leitura, disponível em todos os planos e fornecida sem um token em um endpoint com escopo de repositório para um site público. Quando nenhum índice é criado ou ativado, responde usando texto completo em vez de recusar, e mode (semantic / lexical) informa qual mecanismo respondeu.
get_doc_outline
Leitura
Lista o título, a contagem de títulos e o tamanho de cada página Markdown antes de pesquisar ou escrever. Somente leitura — funciona com qualquer token, independentemente do escopo de leitura/gravação.
write_docs
IA
Confirma um ou mais arquivos Markdown no repositório de documentação do workspace em um único commit atômico do git. Requer um token autorizado com escopo de leitura e escrita — um token somente leitura é recusado. Aceita um intent opcional: o que a pessoa solicitou, em suas próprias palavras. Ele é exibido junto ao commit no painel de Alterações, para que o objetivo por trás de uma edição sobreviva à conversa que a produziu.
fetch_url
Saída
Lê uma página pública da web e a retorna como Markdown limpo, com seu título, descrição e a URL final após os redirecionamentos. Para verificar uma afirmação em relação a uma página fora do workspace — os preços de um concorrente, seu próprio site de marketing ou se um link do qual um documento depende ainda resolve. Um 404 ou uma tela de login retorna como um resultado informado, e não como uma falha, pois essa é a resposta quando a pergunta é se um link funciona. Endereços privados e internos são recusados, robots.txt é respeitado e o conteúdo da página é tratado como dados, nunca como instruções.
list_sources
Leitura
Lista os repositórios e sites aos quais este workspace está conectado como suas fontes de verdade, além do repositório a partir do qual o site é criado. Cada entrada inclui a própria observação do proprietário sobre o motivo da conexão. Somente leitura. Chame-o antes de escrever ou atualizar a documentação: uma fonte conectada é um fato que você pode consultar e ler em vez de relembrar.
read_source
Saída
Lê uma dessas fontes. Um repositório sem path retorna seus arquivos legíveis e, com um, retorna esse arquivo; um site sem path retorna várias de suas páginas como Markdown, descobertas a partir do próprio sitemap e limitadas à seção que foi conectada. As mesmas proteções de fetch_url — endereços privados recusados, robots.txt respeitado, conteúdo da página tratado como dados e nunca como instruções.
connect_source
Escrita
Conecta um repositório, um site ou uma única página como fonte de verdade — o que list_sources então lista, read_source lê e um agente equipado com enable_agent monitora. Um repositório do GitHub tem sua legibilidade comprovada (publicamente ou com uma autorização do GitHub que este projeto já possui) antes de ser armazenado; um repositório privado que ainda não foi autorizado por ninguém é recusado com a única ação que o corrige, em vez de ser armazenado sem possibilidade de leitura. note são as próprias palavras do proprietário sobre a finalidade da fonte e são lidas como instruções por tudo que posteriormente a consultar. Requer um token de leitura e escrita.
configure_source
Escrita
Renomeia uma fonte conectada, reescreve seu note, pausa-a (enabled: false — permanece conectada, nada a lê) ou a desconecta completamente (remove qualquer autorização do GitHub associada a ela). Identifique a fonte por source_id de list_sources ou por match (uma palavra de seu rótulo ou URL). Requer um token de leitura e escrita.
Para uma navegação mais profunda no grafo local (estrutura, títulos aproximados, referências de links, resolução de links) enquanto um agente tem seus documentos verificados no disco, use markdown-lsp — execute npx markdown-lsp <subcommand> ./docs para expor ferramentas doc_* no estilo LSP na árvore de trabalho. Consulte o README do markdown-lsp para obter instruções de configuração. search_docs/write_docs e markdown-lsp são complementares: o primeiro funciona pela conexão MCP hospedada, sem checkout local, enquanto o segundo requer o repositório no disco.
Os problemas no repositório do GitHub a partir do qual sua documentação é criada — o trabalho que está aberto no projeto. É aqui que uma descoberta sobrevive à conversa que a produziu: um agente que acabou de auditar sua documentação pode registrar o que encontrou em vez de deixá-lo em um histórico de chat.
As mesmas três ferramentas são usadas pela seção Problemas do painel de administração para ler e gravar dados, portanto um problema registrado pelo Claude Code aparece nessa tabela e vice-versa.
Ferramenta
Cobrança
Descrição
list_issues
Leitura
Lista os problemas no repositório do projeto — abertos, fechados ou todos, opcionalmente filtrados por rótulo. As solicitações de pull nunca são incluídas. Somente leitura. Chame-a antes de create_issue: um problema que duplica outro aberto é pior do que nenhum problema.
get_issue
Leitura
Lê um problema completo — seu corpo integral, rótulos, estado e link. Somente leitura. Agir com base na visualização de 280 caracteres retornada por list_issues é como implementar a metade errada de uma solicitação.
create_issue
Escrita
Registra um problema no repositório do projeto, com título, corpo em markdown e rótulos. Requer um token autorizado com escopo leitura e escrita — um token somente leitura é recusado. Uma chamada por problema. Retorna o número e o link do problema.
Os problemas de um site hospedado pelo Docsbook ficam no repositório que o Docsbook hospeda para ele; um site criado a partir do seu próprio repositório usa esse repositório, e uma chamada MCP atua como a própria conta do Docsbook nesse local — suficiente para ler um repositório público e abrir um problema nele, e para retornar um erro de permissão explícito em um repositório privado, em vez de uma lista vazia.
Registrar um webhook não custa nada para mantê-lo; apenas as entregas de saída e as reproduções são contabilizadas como saída.
Ferramenta
Faturamento
Descrição
register_webhook_<event>
Escrita
Registrar um webhook para um dos 18 eventos tipados (segredo HMAC + URL)
list_webhooks
Leitura
Listar os webhooks registrados no workspace
unregister_webhook
Escrita
Remover uma assinatura de webhook
list_webhook_deliveries
Análises
Histórico de entregas com status, número de tentativas e payload
replay_webhook_delivery
Saída
Entregar novamente uma entrega anterior específica
test_webhook
Saída
Enviar um payload sintético para uma URL
Há 18 eventos tipados, entre eles content.indexed, translation.completed, chat.no_answer, chat.negative_feedback e usage.limit_approaching — consulte Webhooks para ver a lista completa e os esquemas de payload.
Pesquise o catálogo docs-skills por query com filtros opcionais de category e requires_plan. Retorna raw_url para que o agente busque o SKILL.md diretamente.
Ferramentas de ação — uma etapa do trabalho, uma ferramenta#
135 ferramentas somente leitura. Cada uma é uma ação sobre um assunto, não uma disciplina inteira: observe_link_graph relata as conexões entre suas páginas, decide_next_market escolhe um mercado e explica por que não os outros, draft_comparison_page escreve a página. Quem chama escolhe uma etapa, não um departamento.
A família é um cruzamento de três eixos, e cada ferramenta declara sua posição nos três:
O verbo decide o formato da resposta e o que a execução recusa.
O domínio decide o assunto e as evidências que ele lê.
O resultado — carga de suporte, tráfego orgânico, citações de IA, tempo até a resposta, conversão e mais oito — é o número que essa ferramenta é contratada para mover, e é nomeado na própria descrição da ferramenta.
Verbo
Responde com
Recusa
observe_*
O que existe, com a fonte de cada linha
Recomendar qualquer coisa
explain_*
O mecanismo por trás disso, não uma correlação reformulada
Uma história que não consegue apontar para uma etapa
discover_*
O que está faltando, especificado o suficiente para ser construído
"Mais conteúdo sobre X"
decide_*
Uma escolha, com cada rejeição e seu motivo
Retornar uma lista ordenada em vez de uma decisão
plan_*
Uma sequência ordenada cuja primeira etapa é uma chamada
Planejar além da primeira coisa que poderia invalidá-la
draft_*
O artefato em si, pronto para aplicação
Devolver um briefing e chamá-lo de rascunho
measure_*
Um painel de pontuação calculado por nós, comparável entre execuções
Escrever uma pontuação ou preencher uma lacuna com zero
verify_*
Um veredito em relação a um controle, permitindo "cedo demais"
Recorrer a "confirmado" em uma janela curta demais
learn_*
Uma regra transferível e onde ela deixa de se aplicar
Uma lição sem limite
handoff_*
A chamada exata, seus argumentos e a verificação de aceitação
Um trabalho cujo teste de aceitação não consegue declarar
Cada uma retorna uma carga JSON validada, em vez de um parágrafo em prosa: um mapa evidence contendo todos os fatos brutos coletados pela execução e afirmações que só podem declarar um número presente nas evidências que citam. Um número que não possa ser rastreado até nada faz a execução falhar em vez de ser enviado, portanto uma cifra inventada não é algo que você precise verificar.
Quando uma ferramenta atribui uma pontuação — as quinze ferramentas measure_*, uma por domínio — a pontuação é calculada por nós a partir das evidências coletadas, com seus pesos publicados na carga, e não escrita pelo modelo. Uma pontuação de 0 a 100 de um modelo não é comparável à da semana seguinte do mesmo modelo, o que destrói o único motivo para ter uma: observar sua evolução. Um eixo que não pôde ser verificado é reportado como não medido, nunca como zero.
As 135 não alteram nada e funcionam com um token de somente leitura: as gravações são recusadas durante toda a execução. Cada uma é cobrada na classe Agent. Isso inclui draft_*, que produz a página ou o bloco e nomeia a chamada que o aplicaria (run_docs_create / run_docs_manage), em vez de aplicá-la por conta própria. Cada linha traz essa chamada, para que uma análise seja encaminhada sem que um humano faça a tradução intermediária.
Cada uma tem o preço definido pelo trabalho que declara — quantas famílias de evidências lê, quantas interações com o modelo pode realizar, se sai do seu site, se emite um artefato —, portanto uma observação restrita custa uma fração de um rascunho aprofundado, em vez de cada ação carregar uma única tarifa fixa de agente. A espera varia da mesma forma, e a espera típica é listada para cada ferramenta abaixo. O preço atual de cada ferramenta é exibido junto dela no painel e na página de preços do Docsbook.
Uma linha por capacidade que seu produto realmente expõe, ao lado da página que a documenta — e o espaço em branco quando não existe nenhuma página.
~41 s
explain_capability_confusion
O mecanismo por trás de leitores que perguntam sobre algo que o produto já faz — a formulação exata, o posicionamento ou a ausência que torna uma capacidade existente invisível.
~45 s
discover_undocumented_capabilities
Capacidades que existem no produto e não aparecem em nenhum lugar da documentação, cada uma nomeada com especificidade suficiente para escrever uma página a partir de amanhã.
~45 s
decide_capability_priority
Uma capacidade para documentar em seguida, com todas as alternativas sérias listadas e o motivo pelo qual cada uma foi descartada.
~26 s
plan_capability_page_set
O conjunto de páginas de que uma capacidade realmente precisa — e, igualmente importante, as páginas de que não precisa — na ordem em que devem ser escritas.
~39 s
draft_capability_matrix
Uma página de matriz de capacidades concluída — cada capacidade, seu estado, seu marco no plano e seu link de página — em Markdown pronto para commit.
~52 s
measure_capability_coverage
Um scorecard reproduzível de quanto do produto a documentação realmente cobre, em cinco eixos definidos por pessoas diferentes.
~45 s
verify_capability_claims
Para cada capacidade declarada pela documentação, um veredito sobre se o produto ainda faz isso — com a fonte que esclarece a questão.
~52 s
handoff_capability_backlog
O trabalho de capacidade preparado para quem o executará em seguida: a chamada exata, seus argumentos e como essa pessoa saberá que funcionou.
As tarefas que os leitores declararam com suas próprias palavras — a partir de perguntas ao assistente e pesquisas — agrupadas, contabilizadas e citadas literalmente.
~32 s
explain_job_abandonment
Onde uma tarefa deixa de poder ser concluída e o mecanismo que a interrompe — a etapa, o pré-requisito ausente ou a frase com que os leitores se deparam antes de sair.
~42 s
discover_unserved_jobs
Tarefas que seu produto pode atender e que sua documentação não aborda em lugar algum — deduzidas da capacidade ao leitor, porque uma tarefa atendida em nenhum lugar não deixa vestígios para medir.
~48 s
decide_primary_job
A única tarefa em torno da qual esta documentação deve ser organizada, com as tarefas concorrentes nomeadas e o custo de cada rejeição declarado.
~32 s
plan_job_journey
A sequência ordenada de páginas que conduz uma tarefa do primeiro contato à conclusão, com as lacunas nessa sequência marcadas.
~33 s
draft_job_walkthrough
A própria página do passo a passo, escrita de ponta a ponta para uma tarefa, com todos os pré-requisitos declarados e cada etapa verificável.
~55 s
measure_job_completion
Uma ficha de avaliação sobre se os leitores com uma tarefa realmente a concluem — entrada, continuidade, becos sem saída, resultados declarados e retorno.
~39 s
verify_job_now_served
Se as páginas escritas para uma tarefa realmente mudaram o que os leitores fazem — antes, depois, janela, controle, veredito.
~36 s
learn_job_patterns
A regra por trás das tarefas que sua documentação atende bem, expressa de modo que possa ser transferida — e o limite além do qual ela deixa de se aplicar.
Todos os tópicos que este corpus aborda, com quantas páginas os apresentam, qual é a profundidade máxima alcançada e quantas páginas fazem links para eles.
~32 s
explain_authority_shortfall
Por que este corpus parece ser um site que menciona um tópico, em vez de ser o site sobre ele — com a ausência específica que produz essa impressão.
~39 s
discover_missing_entities
As entidades que um tópico exige, mas que este corpus nunca nomeia — os conceitos, as ferramentas, os formatos e os modos de falha que um leitor espera que uma fonte real conheça.
~39 s
decide_topic_cluster_focus
O único cluster de tópicos a desenvolver em seguida, com os concorrentes nomeados e o motivo pelo qual cada um foi rejeitado.
~32 s
plan_topic_cluster
O hub e seus spokes: todas as páginas de que o cluster precisa, o que cada uma aborda, como elas se vinculam e a ordem em que devem ser escritas.
~33 s
draft_topic_hub_page
A própria página hub, escrita: a definição, o mapa dos subtópicos e os links que transformam o cluster em um grafo.
~46 s
measure_topical_depth
Uma pontuação repetível para determinar se o corpus é percebido como uma autoridade em seus tópicos — definição, cobertura, relações, evidências e conectividade.
~36 s
verify_cluster_effect
Se um cluster que você desenvolveu realmente conquistou algo — classificações, acessos ou citações — em comparação com um controle e uma janela de tempo declarada.
~36 s
learn_authority_wins
A regra por trás dos tópicos em que este site venceu — o que essas páginas tinham que as outras não tinham e onde a regra deixa de se aplicar.
As consultas pelas quais este site é encontrado, organizadas de acordo com a intenção que cada uma carrega — tutorial, definição, comparação, erro, preço, referência.
~32 s
explain_intent_mismatch
Por que uma página que aparece bem posicionada ainda perde o leitor — a lacuna específica entre o formato da pergunta e o formato da página.
~36 s
discover_intent_gaps
As intenções com as quais os leitores comprovadamente chegam e que nenhuma página deste site está estruturada para responder.
~36 s
decide_page_shape
O que UMA página precisa ser — tutorial, guia prático, referência, explicação ou comparação — dadas as intenções que realmente chegam até ela, com os formatos rejeitados identificados.
~26 s
plan_intent_coverage
O conjunto ordenado de páginas que cobriria as intenções atraídas por este site, cada uma estruturada exatamente para uma delas.
~30 s
draft_intent_matched_opening
O título, a descrição e a primeira tela reescritos de uma página, correspondentes à intenção para a qual ela realmente aparece nos resultados — redigidos e prontos para aplicação.
~39 s
measure_intent_match
Uma avaliação de quão bem as páginas exibidas aos leitores correspondem às intenções com as quais eles chegaram, em cinco eixos calculados a partir de observações.
~36 s
verify_intent_fix
Se uma reescrita orientada pela intenção realmente alterou os cliques ou o engajamento — com um controle e o atraso dos dados de pesquisa devidamente considerados.
~36 s
handoff_intent_rewrites
As reescritas orientadas pela intenção organizadas como tarefas: qual página, para o que alterá-la e qual consulta a alteração precisa conquistar.
Os padrões de URL neste site que já se repetem em torno de um eixo, com quantos membros existem e quantos o eixo realmente possui.
~26 s
explain_thin_family_pages
Por que os membros gerados de uma família apresentam desempenho inferior — o campo que está vazio, é idêntico ou foi inventado na maioria deles.
~36 s
discover_scalable_patterns
Padrões de pesquisa repetitivos que este produto poderia responder em escala — o eixo, o modelo de consulta e o fato exclusivo que cada membro carregaria.
~48 s
decide_family_worth_building
Um único veredicto sobre se uma família proposta deve ser criada, com as alternativas nomeadas e a condição de encerramento declarada desde o início.
~30 s
plan_family_rollout
O lançamento: quais membros serão publicados primeiro, quais fontes de dados os alimentam, quais são as salvaguardas e onde está o ponto de verificação.
~42 s
draft_family_template
O próprio modelo — a estrutura da página, as variáveis por membro e dois exemplos de membros totalmente renderizados.
~58 s
measure_family_coverage
Um quadro de avaliação por família: quanto do eixo é coberto, quão distintos são os membros, quão bem estão vinculados e quão atuais são seus fatos.
~32 s
verify_family_indexation
Se os membros gerados são de fato acessíveis e indexados — buscados ao vivo, com aqueles que não são nomeados individualmente.
~45 s
learn_family_thresholds
O limite, neste site, acima do qual um membro gerado conquista algum resultado — declarado como uma regra com os casos que a fundamentam.
As solicitações que os leitores já fazem e que têm o formato de uma ferramenta — calcular, converter, validar, gerar, verificar — citadas e contabilizadas.
~32 s
explain_tool_underuse
Por que uma ferramenta gratuita existente não é usada — o ponto de entrada, o atrito ou a incompatibilidade que impede os leitores de acessá-la ou concluí-la.
~45 s
discover_tool_ideas
Ferramentas gratuitas que este produto poderia hospedar de forma plausível, cada uma com a consulta que responderia e os dados que a tornam possível.
~48 s
decide_tool_to_build
Uma ferramenta a ser criada, as demais rejeitadas com justificativas, e o custo de manutenção da escolhida declarado antes de qualquer início.
~39 s
plan_tool_launch
O lançamento: onde a ferramenta ficará, quais links levarão a ela, o que ela oferecerá ao leitor depois e como seu sucesso será avaliado.
~33 s
draft_tool_page
A página da ferramenta, redigida: o que ela faz acima da dobra, o exemplo resolvido, o método que utiliza e o próximo passo — além da especificação de incorporação do próprio widget.
~58 s
measure_tool_pull
Um painel de indicadores do que uma ferramenta realmente atrai — chegadas, conclusão, progressão, links conquistados e legibilidade independente.
~32 s
verify_tool_traffic
Se o lançamento da ferramenta alterou algo mensurável — em comparação com um grupo de controle, durante um período definido, com um veredito que pode ser “cedo demais”.
~32 s
handoff_tool_build
A especificação da ferramenta para quem irá desenvolvê-la: entradas, regras, saídas, casos extremos e a verificação de aceitação que ela deve passar.
Os dados que este produto já possui e que ninguém de fora consegue calcular — o que abrangem, até quando retrocedem e se podem ser publicados.
~41 s
explain_research_ignored
Por que um estudo publicado não recebeu citações — o método ausente, o formato impossível de citar ou a afirmação ausente que alguém poderia ter repetido.
~48 s
discover_research_questions
Perguntas que seus próprios dados poderiam responder e que ninguém mais pode, cada uma com o recorte de dados que a responderia e o público que a repetiria.
~45 s
decide_research_to_publish
Um estudo para realizar, com as perguntas rejeitadas nomeadas e o risco exposto com honestidade: o que acontece se a resposta for entediante.
~30 s
plan_research_release
A divulgação: o recorte a executar, o método a declarar, os artefatos a publicar e a periodicidade que a torna repetível no próximo ano.
~33 s
draft_research_report
O próprio relatório: a principal afirmação em uma frase citável, os números com seus denominadores, o método e as limitações.
~68 s
measure_research_citations
Uma ficha de avaliação sobre o quanto a pesquisa publicada é realmente citável — afirmação citável, método declarado, dados acessíveis, datação e legibilidade por máquinas.
~45 s
verify_research_claims
Se cada número publicado ainda se sustenta quando o mesmo recorte é executado novamente — com as discrepâncias nomeadas individualmente.
~39 s
learn_research_formats
A regra por trás de quais de suas publicações foram repetidas — o formato, a estrutura da afirmação ou o padrão de divulgação — e onde ela deixa de se aplicar.
O que os mecanismos de resposta dizem atualmente sobre este produto e qual fonte usaram para afirmar isso — com citações, datas e as perguntas que produziram a resposta.
~46 s
explain_citation_absence
Por que esta documentação não é a fonte citada por um assistente — a propriedade específica da página que faz com que ela não possa ser citada.
~48 s
discover_quotable_atoms
As passagens autocontidas que este corpus deveria ter, mas não tem — uma pergunta, uma resposta completa, citável sem o contexto das passagens vizinhas.
~39 s
decide_geo_surface_priority
Qual superfície de máquina corrigir primeiro — formato da página, llms.txt, dados estruturados, feeds ou acesso de rastreadores — com as demais classificadas e rejeitadas.
~39 s
plan_geo_surfaces
O trabalho ordenado nas superfícies de máquina, com cada etapa indicando a configuração ou página que ela afeta e a verificação que comprova sua aplicação.
~39 s
draft_answer_blocks
As próprias passagens citáveis — pergunta, resposta completa, fonte e data — escritas para serem extraídas por inteiro e continuarem corretas.
~55 s
measure_ai_visibility
Um quadro de pontuação sobre o quanto este produto está presente nos mecanismos de resposta — presença, precisão, atribuição, atualização e proporção das perguntas abrangidas.
~48 s
verify_citation_gain
Se o trabalho de GEO mudou o que os assistentes dizem — as mesmas perguntas feitas antes e depois, com as respostas comparadas literalmente.
~45 s
learn_citation_patterns
A regra por trás de quais páginas suas são citadas — o formato, a posição da resposta e a data — com seu limite.
O que a documentação de um concorrente específico realmente contém — seções, tipos de página, o que eles documentam e você não — obtido e datado.
~46 s
explain_switching_objections
A objeção específica que um avaliador forma ao ler os dois conjuntos de documentação — e a página e a frase suas que a geram.
~48 s
discover_market_gaps
Necessidades que nem você nem os concorrentes nomeados atendem — com evidências de que alguém tem essa necessidade e ninguém a responde.
~52 s
decide_positioning_wedge
A única comparação que este produto deve incentivar, com as comparações que deve recusar e o motivo de cada recusa.
~33 s
plan_comparison_pages
O conjunto de páginas de comparação que vale a pena ter, o que cada uma deve conter para ser confiável e a ordem em que devem ser escritas.
~39 s
draft_comparison_page
A própria página de comparação, escrita com base em evidências obtidas — toda afirmação sobre o outro lado datada e com fonte, inclusive aquelas em que eles vencem.
~58 s
measure_competitive_coverage
Uma ficha de pontuação sobre como sua documentação se compara à de concorrentes nomeados nas superfícies que os avaliadores realmente acessam.
~48 s
verify_competitor_claims
Se as afirmações que suas páginas fazem sobre os concorrentes ainda são verdadeiras hoje — cada uma obtida novamente, com as desatualizadas identificadas.
~42 s
learn_competitor_moves
O que mudou do lado dos concorrentes desde a última análise e o padrão por trás das mudanças — apresentado como o que observar em seguida.
As palavras que os leitores realmente digitam e usam em perguntas, literalmente e contabilizadas, ao lado da palavra que sua documentação usa para a mesma coisa.
~29 s
explain_term_misses
Por que a palavra de um leitor não retorna nada — e qual das duas causas muito diferentes está envolvida: um conceito com outro nome ou um conceito totalmente ausente.
~36 s
discover_missing_synonyms
Os nomes alternativos para conceitos que você já documenta e que não aparecem em nenhum lugar do corpus — cada um com a página que deve incluí-lo.
~32 s
decide_canonical_terms
Um nome canônico por conceito, com os nomes rejeitados mantidos como sinônimos em vez de excluídos, e o motivo de cada escolha.
~30 s
plan_terminology_migration
O plano ordenado para aplicar uma decisão de nomenclatura ao corpus, incluindo as páginas que não devem ser alteradas e o motivo.
~30 s
draft_glossary_entries
As próprias entradas do glossário — cada conceito definido em uma frase que um iniciante possa usar, com seus sinônimos e a página responsável por ele.
~52 s
measure_vocabulary_alignment
Um quadro de avaliação de quão distante está a linguagem do corpus da linguagem dos leitores — cobertura dos termos deles, consistência dos nossos e quanto disso a pesquisa resolve.
~32 s
verify_renaming_effect
Se adicionar as palavras dos leitores realmente reduziu as falhas — as mesmas pesquisas antes e depois, com um controle.
~32 s
handoff_term_changes
O trabalho de nomenclatura empacotado como chamadas: qual página, qual palavra se torna qual outra e qual pesquisa deve deixar de falhar depois disso.
A estrutura do corpus como ele é: seções, profundidade por ramificação, tamanhos das páginas e quanto dele a navegação declarada realmente alcança.
~26 s
explain_navigation_failure
Por que os leitores não conseguem encontrar as coisas — a incompatibilidade específica entre a árvore que você declarou e as rotas que os leitores realmente percorrem.
~42 s
discover_orphan_pages
Páginas para as quais nenhum link aponta e páginas às quais os leitores chegam e das quais não conseguem sair — as duas extremidades do corpus que são invisíveis de dentro da árvore.
~32 s
decide_structure_model
O princípio organizador que este corpus deve usar — por função, por área do produto, por tipo de página ou por público — com os modelos rejeitados e seus custos.
~36 s
plan_restructure
A lista de movimentações: qual página vai para onde, em que ordem, com cada alteração de URL e o redirecionamento necessário indicado em sua própria linha.
~39 s
draft_navigation_tree
A própria navegação, descrita por extenso — a árvore completa com rótulos nas palavras dos leitores, pronta para ser aplicada.
~42 s
measure_findability
Uma avaliação de quão bem um leitor consegue ir do ponto de entrada ao que precisa — alcançabilidade, equilíbrio de profundidade, orientação, pontos de entrada e alternativa de pesquisa.
~39 s
verify_restructure_effect
Se uma reestruturação ajudou — as mesmas medidas de encontrabilidade e comportamento antes e depois, com os redirecionamentos verificados e uma seção de controle.
~45 s
learn_structure_lessons
A regra por trás das seções deste corpus que funcionam — como são agrupadas, quão profundas são, como começam — e onde ela deixa de se aplicar.
O corpus como um grafo: quais páginas apontam para quais, quantas arestas cada uma tem de entrada e de saída e quais páginas o grafo trata como hubs.
~29 s
explain_unreachable_pages
Por que uma página é inalcançável na prática — a aresta ausente, o link que ninguém segue ou o texto âncora que não dá motivo para clicar.
~36 s
discover_missing_links
Pares de páginas que discutem a mesma entidade e não apontam umas para as outras — cada par com a frase onde o link deve ser inserido.
~39 s
decide_hub_pages
Quais páginas se tornam hubs — aquelas para as quais todo o restante aponta — com os candidatos rejeitados e os motivos.
~30 s
plan_linking_pass
A etapa de linkagem: quais páginas são editadas, em que ordem, quantos links cada uma ganha e a regra que impede que isso se torne spam de links.
~30 s
draft_link_insertions
As edições exatas: para cada página, a frase como ficará depois que o link for inserido, com o texto âncora e o destino.
~46 s
measure_graph_health
Um quadro de pontuação do grafo de links — conectividade, concentração de hubs, travessia entre clusters, qualidade das âncoras e quantas páginas dependem apenas da navegação.
~36 s
verify_link_effect
Se uma etapa de linkagem interna mudou alguma coisa — acessos às páginas vinculadas, taxa de becos sem saída e classificações, em comparação com um controle.
~36 s
handoff_link_edits
As edições de links organizadas por página como chamadas, com a verificação de aceitação declarada como um acesso ou uma contagem de links recebidos.
Que material de credibilidade as páginas realmente apresentam — autores, datas, fontes, números com denominadores, exemplos trabalhados, limites declarados — página a página.
~32 s
explain_disbelief
Por que um leitor não acredita em uma página factualmente correta — o número sem fonte, o limite não declarado ou a afirmação que só você faz.
~45 s
discover_unsourced_claims
Todas as afirmações nas páginas comercialmente importantes que não têm fonte, denominador ou data — listadas individualmente.
~35 s
decide_evidence_standard
A prova que cada classe de afirmação deve apresentar antes de poder ser publicada — decidida uma vez, com os padrões rejeitados e seus custos.
~29 s
plan_trust_upgrade
O trabalho ordenado que eleva as páginas ao padrão de evidências, começando pelas páginas nas quais a confiança realmente é depositada.
~30 s
draft_evidence_blocks
As próprias afirmações reescritas — cada uma com sua fonte, seu denominador, sua data e a limitação declarada ao lado.
~55 s
measure_trust
Um quadro de pontuação da credibilidade em cinco eixos — verificabilidade em primeiro lugar, porque é o único que um concorrente não consegue copiar em uma tarde.
~45 s
verify_claim_freshness
Se cada afirmação datada ou numérica ainda é verdadeira hoje — verificada novamente em relação à sua fonte, com as desatualizadas nomeadas individualmente.
~48 s
learn_trust_objections
O padrão recorrente de objeções em tudo o que os leitores questionaram — declarado como uma regra sobre o que esse público precisa ver comprovado.
Quem atualmente faz referência a este produto publicamente, o que diz e se a referência é um link, uma menção ou uma citação.
~42 s
explain_unlinkable_pages
Por que ninguém cria links para uma página — o que falta nela e que uma pessoa escrevendo sobre este assunto teria precisado.
~45 s
discover_link_targets
Lugares específicos que poderiam plausivelmente fazer referência a este produto — cada um com a página para a qual criaria um link e o motivo pelo qual se daria ao trabalho.
~51 s
decide_linkable_asset
O único recurso a criar para obter referências — dados, ferramenta, definição ou argumento — com as opções rejeitadas e o motivo pelo qual perdem.
~39 s
plan_outreach_sequence
O plano de divulgação em linhas ordenadas: quem será abordado, em que ordem, com o quê e qual é a condição para parar.
~42 s
draft_outreach_pitch
A própria mensagem, escrita para cada alvo — a que conteúdo dele se refere, o que oferece e qual é a única coisa que solicita.
~51 s
measure_linkability
Uma avaliação de quão referenciável é este corpus — fatos únicos, seções referenciáveis, formato citável, atualidade e permanência dos URLs.
~45 s
verify_mention_gain
Se novas referências realmente apareceram após o trabalho — pesquisadas novamente, comparadas com o conjunto anterior, com o tráfego de referência ao lado.
~42 s
handoff_pr_targets
A divulgação preparada para uma pessoa: alvo, página dela, mensagem redigida, solicitação e o que uma resposta significa.
De onde os leitores já vêm — países, idiomas, referências — e quão diferente é o comportamento de cada grupo depois que chega aqui.
~32 s
explain_market_stall
Por que um mercado que chega não converte — o idioma, o exemplo, a premissa de preço ou a prova ausente que o impede.
~42 s
discover_adjacent_markets
Públicos que este produto poderia atender, mas que não alcança de forma alguma — cada um com evidências de que a necessidade existe e o obstáculo que teria de ser superado.
~48 s
decide_next_market
Um mercado para entrar em seguida, com os demais rejeitados, e o custo contínuo da escolha declarado antes que alguém se comprometa.
~36 s
plan_market_entry
O plano de entrada: quais páginas vêm primeiro, o que precisa ser localizado além do idioma e o ponto de verificação que decide se devemos continuar.
~33 s
draft_market_landing
A página de destino do mercado, escrita em seu idioma, com seus exemplos, sua moeda e as provas que esse mercado exige.
~46 s
measure_market_readiness
Uma avaliação de quão pronta está a documentação para um mercado — cobertura, localização além do idioma, provas, capacidade de descoberta e manutenção.
~36 s
verify_market_traction
Se entrar no mercado mudou alguma coisa — chegadas, resultados e retornos desse mercado, em comparação com um controle e um período definido.
~36 s
learn_expansion_lessons
A regra por trás dos mercados que funcionaram aqui — o que foi feito para eles e não para os demais — com seus limites.
~32 s
A maioria aceita um request opcional, escrito com suas próprias palavras, que restringe a execução sem substituir o método, além das entradas tipadas necessárias à sua pergunta (path, path_prefix, pages, competitors, window_days). Uma carga útil que não cumpre seu próprio contrato é relatada como uma falha, com as violações listadas — nunca como uma resposta bem-sucedida com um resultado vazio, porque "nenhuma descoberta" é interpretado como "o site está em ordem".
Cinco ferramentas pertencem à família em uma classe de cobrança própria e mais barata, Probe: collect_page_text, collect_corpus_map, collect_assistant_questions, collect_traffic e collect_onsite_search. Elas devolvem as linhas normalizadas que uma ação teria lido, além de um bloco reproduce que identifica as chamadas exatas por trás de cada linha — não há nenhum modelo no caminho, portanto não há nada nelas para desacreditar. Compre uma quando quiser os números antes de decidir se vale a pena comprar a leitura deles. audit_geo também permanece da geração anterior: sua camada de evidências é código, e não um modelo, e ela responde se os mecanismos de resposta conseguem buscar suas páginas.
find_skill entrega o SKILL.md ao seu agente para execução. Essas ferramentas fazem o oposto: executam a skill no lado do Docsbook, no seu espaço de trabalho, com o conjunto completo de ferramentas administrativas para as quais a skill foi escrita — assim, um assistente sem outras ferramentas do Docsbook conectadas ainda consegue concluir o trabalho.
Cada chamada a run_docs_* retorna { run_id, state } imediatamente. Ela não retorna o resultado — o trabalho leva minutos, e um chamador que informa o início como resposta está informando um trabalho que ainda não aconteceu. Consulte get_agent_run usando o run_id retornado.
Ferramenta
Faturamento
Descrição
run_docs_analyze
Agente
Executa a skill docs-analyze: audita o site com base em números reais e informa o que está errado e quanto isso custa. Modo de auditoria declarado — as gravações são recusadas durante toda a execução, portanto funciona com um token somente leitura.
run_docs_create
Agente
Executa a skill docs-create: cria documentação a partir do seu site, de um repositório, de outra plataforma de documentação ou apenas do nome de um produto. Faz commit das páginas — requer um token de leitura e gravação.
run_docs_manage
Agente
Executa a skill docs-manage: reescreve páginas e configura o site de acordo com o manual de regras de escrita e operação do site. Requer um token de leitura e gravação.
run_docs_automate
Agente
Executa a skill docs-automate: configura proteções contra divergências, assinaturas de eventos, verificações em alterações recebidas, alertas e monitores contínuos. Requer um token de leitura e gravação.
get_agent_run
Leitura
Estado de uma execução (queued, running, succeeded, failed, canceled, expired), progresso em tempo real enquanto ela é executada e, quando é concluída com sucesso, o resultado completo: o relatório, cada ação realizada e o que mudou no site.
list_agent_runs
Leitura
Suas execuções recentes, da mais nova para a mais antiga. Use para verificar se o trabalho já está em execução antes de iniciar outro.
cancel_agent_run
Leitura
Interrompe uma execução que ainda não foi concluída. Isso não desfaz o que a execução já fez — as páginas que ela já confirmou permanecem confirmadas.
Uma execução pertence à conta que a iniciou: o run_id de outra conta é lido exatamente como um desconhecido. Uma execução enfileirada que não tenha começado dentro de algumas horas expira em vez de ser executada atrasada, porque uma auditoria responde a uma pergunta sobre o estado do site no momento em que foi feita. E uma execução é tentada uma única vez, nunca novamente — uma execução com falha pode já ter confirmado páginas, e uma segunda tentativa faria o commit delas duas vezes.
As ferramentas acima são executadas uma vez, mediante pedido. Estas duas ativam uma rota permanente que é executada por si própria — segundo uma agenda, quando ocorre um evento emitido por este espaço de trabalho ou quando são criados novos commits num repositório ligado — o mesmo catálogo que o separador Agents do painel de administração apresenta e ativa.
Ferramenta
Faturação
Descrição
find_agent
Leitura
Pesquisa o catálogo de rotas que este espaço de trabalho pode ativar, de acordo com o resultado pretendido ("manter a documentação sincronizada com o repositório", "traduzir", "monitorizar o tráfego"). Cada resultado inclui state — se este espaço de trabalho já a tem ativada e em que condições — para que possa distinguir entre "ninguém está a monitorizar o repositório" e "ativada, mas a falhar desde terça-feira". Chame-a antes de propor configurar algo manualmente: normalmente, a rota já existe.
enable_agent
Escrita
Ativa (ou desativa) um agente do catálogo de find_agent através do respetivo agent_key. O que o desperta é exatamente um de schedule (uma expressão cron, de hora a hora no máximo), on_event (algo que este espaço de trabalho emite) ou watch_source_id (um repositório GitHub ligado a partir de list_sources/connect_source — o agente é executado nos commits enviados para esse repositório). Ativar num repositório regista o commit atual, pelo que a primeira execução ocorre no próximo push, e não como uma repetição de todo o histórico. enabled: false desativa-o sem esquecer a forma como foi configurado. Requer um token de leitura e escrita.
