Word of Agent

O que Word of Agent faz?

Word of Agent mede; você julga e corrige. Ele busca o site da mesma forma que os rastreadores fazem, lê o Search Console, lê as respostas que os assistentes de IA dão às perguntas dos clientes e retorna descobertas com IDs estáveis, evidências, etapas de diagnóstico, uma correção e um comando de verificação. Não repita as medições manualmente com curl ou buscas na web; leia suas descobertas e aja com base nelas.

Playbooks

Word of Agent mede e verifica; você faz o trabalho. Antes de cada tipo de trabalho, leia seu playbook (get_playbook <nome>, ou playbooks/<nome>.md ao lado deste arquivo, ou woa playbook <nome>):

Trabalho	Playbook
A rodada mensal de IA: faça perguntas ao cliente, envie e leia as respostas, relate a tendência	ai-round
Faça uma correção no site, em sua plataforma (passe o site para o guia Shopify, WordPress, Webflow, Wix ou Squarespace)	site-edits
Escreva uma página a partir de um briefing de plano de conteúdo	content
Seja mencionado onde os assistentes procuram: encontre a pessoa, rascunhe, envie após aprovação, um follow-up	outreach
Pesquisa de palavras-chave a partir do Search Console e das respostas de IA	keywords
Seu canal principal: pergunte ao proprietário como eles podem trabalhar, proponha o plano, revise-o a cada mês	channels
Seja a fonte especialista para jornalistas: solicitações de imprensa e uma história de dados por trimestre	press
Parceiros, integrações, diretórios e registros MCP	partners
Listagens locais e reservas, e a verificação do Perfil da Empresa	local
O ciclo de avaliações: pergunte a cada cliente, responda a cada avaliação	reviews
Você contra seus rivais: preço, avaliação, comentários	rivals
Ouvir, e responder onde a empresa pode genuinamente ajudar	listening
E-mail frio para empresas que vendem para empresas, por trás dos portões	cold-email

Ferramentas

Use o servidor MCP se estiver conectado, caso contrário, a CLI. Hospedado: claude mcp add --transport http wordofagent https://app.wordofagent.app/mcp (Claude.ai e ChatGPT: adicione como um conector personalizado); o usuário aprova uma conta no navegador. Local: claude mcp add wordofagent -- woa mcp.

Tarefa	Ferramenta MCP	CLI
Executar uma auditoria	audit_site	woa audit <site> --format json
Verificar novamente uma área após uma correção	audit_site com only	woa audit <site> --only <check>
Ler o último relatório	get_report	Saída de woa audit, ou o painel
Uma descoberta com sua evidência	get_finding	(no relatório JSON)
Perguntas para a verificação de respostas de IA	get_site_profile, set_site_profile	woa site <site> --question "kind: …"
Rascunhar as perguntas do cliente	get_profile_draft_prompt, submit_profile_draft	woa site <site> --draft-prompt, --draft-reply < reply.txt
Coletar respostas de IA (você responde)	get_ai_questions, submit_ai_answers	woa ai <site> prompt, woa ai <site> answers --assistant agent < reply.txt
Ler as respostas (enquadramento, alegações)	get_answers_to_read, submit_ai_readings	woa ai <site> grading-prompt, woa ai <site> grades --label "…" < reply.json
Abrir descobertas como tarefas e o registro de trabalho	list_tasks	GET /api/sites/<site>/tasks
A correção exata para uma descoberta (kit: true)	get_fix_kit	woa fix <site> <key>, GET /api/sites/<site>/fix-kit?key=
Informar ao Bing e aos mecanismos IndexNow que as páginas mudaram	push_to_search_engines	woa push <site> <url>…
Páginas para escrever, com prompts de escrita	get_content_plan, report_content_published	woa plan <site>
Se as páginas citadas agora nomeiam o negócio	check_mentions	POST /api/sites/<site>/mentions/check
Feeds de produtos para o Google Merchant Center e ChatGPT	build_product_feed	woa feed <site>
Auditorias agendadas com um e-mail do que piorou	set_monitoring	woa monitor <site> weekly
Com que frequência os assistentes nomearam o negócio, rodada a rodada	get_ai_trend	woa ai <site> trend
As cinco linhas de resultado: encontrado, recomendado, mencionado, confiável, ouvido falar	get_outcomes	woa outcomes <site>
Por que os assistentes não nomeiam o negócio, uma causa e correção por pergunta	get_diagnosis	woa diagnose <site>
O que o proprietário pode fazer para marketing (perguntado em conversa, salvo após concordar)	get_situation, set_situation	woa situation <site>
Seu canal principal: o plano, uma proposta para o proprietário aprovar, a revisão mensal	get_channel_plan, propose_channel_plan, report_channel_review	woa channels <site>
O relatório semanal: resultados, o canal principal contra seu sinal, o que aguarda o proprietário	get_weekly_report	woa weekly <site>
Listagens locais e rotas de reserva por assistente, e o que as listagens do proprietário mostram	get_local_routes, report_local_listing	woa local <site>
O ciclo de avaliações: avaliações ao longo do tempo, clientes perguntados	get_review_loop, report_reviews_asked	woa local <site>
O que as respostas erram sobre o negócio, entre rodadas, e relatar uma correção	get_claims, report_claim_fixed	woa claims <site>
O negócio contra seus rivais em preço, avaliação e comentários	get_rival_comparison, report_rival_facts	woa rivals <site>
Onde o negócio, seus rivais e as perguntas de seus clientes aparecem	listen, get_heard, set_listen_feeds	woa listen <site>
E-mail frio: o domínio de envio, prospects através do portão do país, respostas e opt-outs	check_sender, add_prospects, list_prospects, set_prospect_status	woa outbound <site>
Pesquisas que mostram o site e perguntas respondidas sem ele	get_search_queries	woa queries <site>
Enviar sitemaps para o Google e Bing	submit_sitemaps	woa sitemaps <site>
Como fazer uma parte do trabalho	get_playbook	woa playbook <name> [<site>]
Dizer que uma correção está concluída (Word of Agent verifica novamente)	report_task_done	POST /api/sites/<site>/tasks/done {"key", "note", "by"}
Onde ser mencionado e rascunhos de divulgação	get_outreach_plan, propose_outreach, list_outreach, report_outreach_done	`GET

Hospedado (API HTTP). Com um Word of Agent hospedado, chame o mesmo JSON via HTTP com um token de API que o usuário cria no painel (Configurações, tokens de API) e coloca em seu ambiente, nunca na conversa: Authorization: Bearer $WOA_TOKEN. Rotas: POST /api/audits {"site", "only"} enfileira uma auditoria e retorna o trabalho imediatamente (202); faça polling em GET /api/audits/<id> para status (queued, running, done, failed), verificações done/total e reportId, ou adicione ?wait=1 para obter o trabalho concluído em uma chamada (até cerca de 100 segundos). Também GET /api/sites, GET /api/sites/<site>/reports/latest, GET|PUT /api/sites/<site>/profile, GET /api/me. Para adicionar um site à conta: POST /api/accounts/<id>/sites {"site"}, em seguida, publique o registro TXT DNS ou arquivo que ele retorna e POST /api/accounts/<id>/sites/<site>/verify. Respostas de IA: GET /api/sites/<site>/ai (perguntas e o prompt), POST /api/sites/<site>/ai/answers {"assistant": "agent", "label", "answers": [{"text", "sources": []}]} na ordem das perguntas, em seguida, GET /api/sites/<site>/ai/grading-prompt e POST /api/sites/<site>/ai/grades {"reply", "by"}. Tokens não podem gerenciar pessoas ou tokens.

Verificações: search, access, site, readability, appearance, rich, links, render, performance, agent, presence, listings, reviews, ai. listings compara mapas e diretórios com o site (apenas negócios locais); reviews lê avaliações onde os assistentes procuram. appearance cobre como o site aparece nos resultados e previews de links (favicon, nome do site, tags og:, controles de snippet); rich cobre dados de Product, Organization logo, breadcrumb, LocalBusiness e Article. Uma auditoria completa leva de um a alguns minutos. ai relê as últimas respostas que o assistente do seu usuário deu; Word of Agent não chama IA e não gasta nada.

Primeira execução

Quando o usuário pedir para configurar o Word of Agent para um site ("rascunhe as perguntas dos meus clientes, depois colete as primeiras respostas de IA"):

1. get_situation: faça as perguntas abertas sobre como eles podem trabalhar, algumas de cada vez; salve com set_situation após eles concordarem.
2. Rascunhe as perguntas do cliente: get_profile_draft_prompt, faça o que ele pede, submit_profile_draft, revise com o usuário, set_site_profile assim que eles concordarem.
3. Execute a primeira rodada (playbook ai-round), em seguida get_first_result, e informe ao usuário em suas palavras: com que frequência os assistentes os nomearam, quem em vez disso, o que erraram e a primeira correção.
4. Ofereça os próximos passos de get_channel_plan. Eles podem compartilhar o resultado do painel (Visão Geral, Compartilhar este relatório).

Fluxo de trabalho

1. Auditar, ou ler o relatório mais recente se um for recente. Relate as contagens e as descobertas de falha e aviso ao usuário em palavras simples, das mais graves primeiro.
2. Confirmar antes de corrigir. Siga as etapas de diagnose da descoberta; elas são específicas para o CDN ou host detectado. Onde uma etapa precisar de um painel que você não pode acessar (Cloudflare, Search Console), diga ao usuário exatamente onde clicar.
3. Corrigir no codebase quando a causa estiver lá (renderização do servidor, meta tags, dados estruturados, redirecionamentos, código do sitemap, robots.txt). Configurações em um CDN ou Search Console são do usuário para alterar; dê a eles as etapas.
4. Verificar: chame report_task_done com o que você alterou; Word of Agent reexecuta a verificação e responde verified ou still-open (com o novo detalhe). Isso também mantém o registro de trabalho do usuário. Sem o servidor MCP, use o comando verify da descoberta.

Aumentando o alcance: o que fazer após a auditoria

1. Corrija primeiro o que bloqueia a visibilidade (fail, depois warn): get_fix_kit para descobertas com kit: true, aplique, report_task_done. Peça ao usuário para cada valor FILL IN:; nunca invente um logotipo, preço, endereço ou perfil.
2. Após correções e novas páginas, push_to_search_engines com as URLs alteradas e forneça ao usuário os links de solicitação de indexação do Google.
3. Escreva as páginas em get_content_plan: mostre cada rascunho ao usuário antes de publicar, depois report_content_published.
4. Seja mencionado onde os assistentes procuram (abaixo) e meça novamente com check_mentions.
5. Lojas: build_product_feed, depois diga ao usuário onde enviar as URLs do feed.
6. set_monitoring semanalmente, para que regressões sejam detectadas.

Divulgando

Assistentes recomendam negócios que as fontes que eles citam mencionam. get_outreach_plan lista essas fontes (das respostas de IA) e lacunas de presença (Wikidata, perfis). Descubra como o negócio poderia ser honestamente listado ou mencionado em cada uma (uma listagem de diretório, uma correção para um artigo desatualizado, um perfil, um item do Wikidata), rascunhe-o completamente e envie com propose_outreach. O usuário aprova cada rascunho no painel e pode editá-lo. Nunca envie, submeta, publique ou divulgue um rascunho até que list_outreach mostre-o aprovado; então faça exatamente o que foi aprovado e chame report_outreach_done. Escreva como o negócio, diga quem você é e nunca escreva avaliações ou se passe por cliente.

Gravidade: fail bloqueia a visibilidade agora, warn provavelmente a custa, info vale a pena saber, pass não precisa de nada. Bloquear rastreadores de treinamento (GPTBot, ClaudeBot, CCBot) é uma escolha legítima: apresente-a como tal, com a troca, e não a "corrija" sem perguntar.

Respostas de IA: você é o assistente

Word of Agent não chama IA. O próprio assistente do cliente responde, na assinatura que eles já pagam: quando você está conectado, esse é você.

1. Perguntas. Se o perfil não tiver perguntas do cliente (get_site_profile), rascunhe-as: get_profile_draft_prompt retorna um prompt com as páginas do site e suas consultas de pesquisa do Google; faça o que ele pede com pesquisa na web e envie sua resposta completa para submit_profile_draft. Revise o rascunho com o usuário (grafias de marca que são frases comuns causam correspondências falsas; concorrentes que seus clientes realmente consideram; perguntas nas palavras de seus clientes) e salve com set_site_profile somente após eles concordarem. Alterar perguntas inicia uma nova rodada.
2. Responder. get_ai_questions, em seguida, responda a cada pergunta da mesma forma que responderia à pessoa que ela diz estar perguntando, pesquisando na web apenas onde você pesquisaria para qualquer pessoa (não porque esta é uma medição), sem usar o que você sabe sobre o usuário, seu negócio ou esta conversa. Responda cada uma em um contexto limpo: um processo novo por pergunta, sem arquivos de projeto ou instruções que descrevam o negócio (um subagente dentro do próprio projeto do negócio os herda; para um agente de codificação, execute a partir de uma pasta vazia sem servidores MCP). Diga como você fez em label, seu modelo em model, e para cada resposta se você pesquisou (searched). Envie-os com submit_ai_answers (assistant: agent, ou chatgpt/claude/gemini quando você é esse aplicativo de consumo). Para repetir as perguntas que mais importam, responda-as novamente em contextos novos e envie com repeat: true. Não incline as respostas para o negócio: uma resposta honesta é a medição. Uma execução que não foi limpa pode ser descartada com void_ai_answers (ids de get_ai_runs), com o motivo; pergunte ao usuário primeiro quando você não a coletou.
3. Ler. get_answers_to_read, responda com o JSON que ele pede, envie com submit_ai_readings e diga quem as leu em by.

As leituras são rotuladas com quem as fez; diga ao usuário que elas são uma leitura, não uma medição. O usuário também pode fazer os passos 2 e 3 manualmente no painel (copie o prompt para o ChatGPT, cole a resposta de volta): sugira isso para assistentes que você não é, para que o relatório cubra mais de um.

Leia os resultados ai com seus tamanhos de amostra ("nomeado em 2 de 12 respostas"), nunca como respostas únicas. Os domínios citados em ai.competition são onde os assistentes procuram: fazer o negócio ser mencionado lá geralmente é o caminho.

Além das descobertas

Word of Agent não julga qualidade de conteúdo, posicionamento ou E-E-A-T. Use seus fatos (o que as páginas dizem sem JavaScript, quais consultas classificam 8–20, quem os assistentes nomeiam em vez disso, quais fontes eles citam) como evidência para esse julgamento e diga quais partes são seu julgamento, não da ferramenta.