anirudh-777/wordofagent

Word of Agent

Word of Agent mide; tú juzgas y corriges. Obtiene el sitio de la misma manera que lo hacen los rastreadores, lee Search Console, lee las respuestas que los asistentes de IA dan a las preguntas de los clientes y devuelve hallazgos con identificadores estables, evidencia, pasos de diagnóstico, una corrección y un comando de verificación. No repitas sus mediciones manualmente con curl o búsquedas web; lee sus hallazgos y actúa sobre ellos.

Guías de uso (Playbooks)

Word of Agent mide y verifica; tú haces el trabajo. Antes de cada tipo de trabajo, lee su guía de uso (get_playbook <nombre>, o playbooks/<nombre>.md junto a este archivo, o woa playbook <nombre>):

Trabajo	Guía de uso (Playbook)
La ronda mensual de IA: hacer preguntas al cliente, enviar y leer las respuestas, informar la tendencia	ai-round
Hacer una corrección en el sitio, en su plataforma (pasa el sitio para la guía de Shopify, WordPress, Webflow, Wix o Squarespace)	site-edits
Redactar una página a partir de un resumen del plan de contenido	content
Conseguir menciones donde los asistentes buscan: encontrar a la persona, redactar, enviar después de la aprobación, un seguimiento	outreach
Investigación de palabras clave desde Search Console y las respuestas de IA	keywords
Tu canal principal: preguntar al propietario cómo pueden trabajar, proponer el plan, revisarlo cada mes	channels
Ser la fuente experta para periodistas: solicitudes de prensa y una historia de datos por trimestre	press
Socios, integraciones, directorios y registros MCP	partners
Listados locales y reservas, y la verificación del Perfil de Negocio	local
El ciclo de reseñas: preguntar a cada cliente, responder a cada reseña	reviews
Tú contra tus rivales: precio, calificación, reseñas	rivals
Escuchar y responder donde el negocio puede ayudar genuinamente	listening
Correo electrónico en frío para empresas que venden a empresas, detrás de las puertas	cold-email

Herramientas

Usa el servidor MCP si está conectado, de lo contrario la CLI. Alojado: claude mcp add --transport http wordofagent https://app.wordofagent.app/mcp (Claude.ai y ChatGPT: agrégalo como conector personalizado); el usuario aprueba una cuenta en el navegador. Local: claude mcp add wordofagent -- woa mcp.

Tarea	Herramienta MCP	CLI
Ejecutar una auditoría	audit_site	woa audit <site> --format json
Revisar un área después de una corrección	audit_site con only	woa audit <site> --only <check>
Leer el último informe	get_report	Salida de woa audit, o el panel de control
Un hallazgo con su evidencia	get_finding	(en el informe JSON)
Preguntas para la verificación de respuestas de IA	get_site_profile, set_site_profile	woa site <site> --question "kind: …"
Redactar las preguntas del cliente	get_profile_draft_prompt, submit_profile_draft	woa site <site> --draft-prompt, --draft-reply < reply.txt
Recopilar respuestas de IA (tú respondes)	get_ai_questions, submit_ai_answers	woa ai <site> prompt, woa ai <site> answers --assistant agent < reply.txt
Leer las respuestas (encuadre, afirmaciones)	get_answers_to_read, submit_ai_readings	woa ai <site> grading-prompt, woa ai <site> grades --label "…" < reply.json
Abrir hallazgos como tareas y el registro de trabajo	list_tasks	GET /api/sites/<site>/tasks
La corrección exacta para un hallazgo (kit: true)	get_fix_kit	woa fix <site> <key>, GET /api/sites/<site>/fix-kit?key=
Decir a Bing y a los motores IndexNow que las páginas cambiaron	push_to_search_engines	woa push <site> <url>…
Páginas para redactar, con indicaciones de escritura	get_content_plan, report_content_published	woa plan <site>
Si las páginas citadas mencionan ahora el negocio	check_mentions	POST /api/sites/<site>/mentions/check
Fuentes de productos para Google Merchant Center y ChatGPT	build_product_feed	woa feed <site>
Auditorías programadas con un correo electrónico de lo que empeoró	set_monitoring	woa monitor <site> weekly
Con qué frecuencia los asistentes nombraron el negocio, ronda tras ronda	get_ai_trend	woa ai <site> trend
Las cinco líneas de resultado: encontrado, recomendado, mencionado, confiable, conocido	get_outcomes	woa outcomes <site>
Por qué los asistentes no nombran el negocio, una causa y corrección por pregunta	get_diagnosis	woa diagnose <site>
Lo que el propietario puede hacer para marketing (preguntado en conversación, guardado después de que acepte)	get_situation, set_situation	woa situation <site>
Tu canal principal: el plan, una propuesta para que el propietario la apruebe, la revisión mensual	get_channel_plan, propose_channel_plan, report_channel_review	woa channels <site>
El informe semanal: resultados, el canal principal contra su señal, lo que espera al propietario	get_weekly_report	woa weekly <site>
Rutas de listados locales y reservas por asistente, y lo que muestran los listados del propietario	get_local_routes, report_local_listing	woa local <site>
El ciclo de reseñas: reseñas a lo largo del tiempo, clientes preguntados	get_review_loop, report_reviews_asked	woa local <site>
Lo que las respuestas dicen incorrectamente sobre el negocio, a lo largo de las rondas, e informar una corrección	get_claims, report_claim_fixed	woa claims <site>
El negocio contra sus rivales en precio, calificación y reseñas	get_rival_comparison, report_rival_facts	woa rivals <site>
Dónde aparecen el negocio, sus rivales y las preguntas de sus clientes	listen, get_heard, set_listen_feeds	woa listen <site>
Correo electrónico en frío: el dominio de envío, prospectos a través de la puerta del país, respuestas y exclusiones	check_sender, add_prospects, list_prospects, set_prospect_status	woa outbound <site>
Búsquedas que muestran el sitio y preguntas respondidas sin él	get_search_queries	woa queries <site>
Enviar sitemaps a Google y Bing	submit_sitemaps	woa sitemaps <site>
Cómo hacer una parte del trabajo	get_playbook	woa playbook <name> [<site>]
Decir que una corrección está hecha (Word of Agent lo vuelve a verificar)	report_task_done	POST /api/sites/<site>/tasks/done {"key", "note", "by"}
Dónde conseguir menciones y borradores de difusión	get_outreach_plan, propose_outreach, list_outreach, report_outreach_done	`GET

Alojado (API HTTP). Con un Word of Agent alojado, llama al mismo JSON a través de HTTP con un token API que el usuario crea en el panel de control (Configuración, Tokens API) y coloca en tu entorno, nunca en la conversación: Authorization: Bearer $WOA_TOKEN. Rutas: POST /api/audits {"site", "only"} encola una auditoría y devuelve el trabajo de inmediato (202); consulta GET /api/audits/<id> para status (queued, running, done, failed), comprobaciones done/total y reportId, o agrega ?wait=1 para obtener el trabajo finalizado en una sola llamada (hasta unos 100 segundos). También GET /api/sites, GET /api/sites/<site>/reports/latest, GET|PUT /api/sites/<site>/profile, GET /api/me. Para agregar un sitio a la cuenta: POST /api/accounts/<id>/sites {"site"}, luego publica el registro TXT de DNS o el archivo que devuelve y POST /api/accounts/<id>/sites/<site>/verify. Respuestas de IA: GET /api/sites/<site>/ai (preguntas y el prompt), POST /api/sites/<site>/ai/answers {"assistant": "agent", "label", "answers": [{"text", "sources": []}]} en el orden de las preguntas, luego GET /api/sites/<site>/ai/grading-prompt y POST /api/sites/<site>/ai/grades {"reply", "by"}. Los tokens no pueden gestionar personas ni tokens.

Verificaciones: search, access, site, readability, appearance, rich, links, render, performance, agent, presence, listings, reviews, ai. listings compara mapas y directorios con el sitio (solo negocios locales); reviews lee calificaciones donde los asistentes buscan. appearance cubre cómo se ve el sitio en resultados y previsualizaciones de enlaces (favicon, nombre del sitio, etiquetas og:, controles de fragmento); rich cubre datos de Product, Organization logo, breadcrumb, LocalBusiness y Article. Una auditoría completa toma de uno a pocos minutos. ai relee las últimas respuestas que dio el asistente de tu usuario; Word of Agent no llama a ninguna IA y no gasta nada.

Primera ejecución

Cuando el usuario te pida configurar Word of Agent para un sitio ("redacta las preguntas de mis clientes, luego recopila las primeras respuestas de IA"):

1. get_situation: hacer las preguntas abiertas sobre cómo pueden trabajar, de a pocas a la vez; guardar con set_situation después de que acepten.
2. Redactar las preguntas del cliente: get_profile_draft_prompt, hacer lo que pide, submit_profile_draft, revisarlo con el usuario, set_site_profile una vez que acepten.
3. Ejecutar la primera ronda (guía ai-round), luego get_first_result, y decirle al usuario en sus palabras: con qué frecuencia los asistentes lo nombraron, quién en su lugar, qué dijeron incorrectamente y la primera corrección.
4. Ofrecer los siguientes pasos desde get_channel_plan. Pueden compartir el resultado desde el panel de control (Resumen, Compartir este informe).

Flujo de trabajo

1. Auditar, o leer el último informe si uno es reciente. Informar al usuario los recuentos y los hallazgos de fallo y advertencia en palabras simples, primero los más graves.
2. Confirmar antes de corregir. Seguir los pasos de diagnose del hallazgo; son específicos para el CDN o host detectado. Cuando un paso necesite un panel de control al que no puedas acceder (Cloudflare, Search Console), decirle al usuario exactamente dónde hacer clic.
3. Corregir en la base de código cuando la causa esté allí (renderizado del servidor, metaetiquetas, datos estructurados, redirecciones, código del sitemap, robots.txt). Las configuraciones en un CDN o Search Console son para que el usuario las cambie; darles los pasos.
4. Verificar: llamar a report_task_done con lo que cambiaste; Word of Agent vuelve a ejecutar la verificación y responde verified o still-open (con el nuevo detalle). Eso también mantiene el registro de trabajo del usuario. Sin el servidor MCP, usar el comando verify del hallazgo.

Crecimiento del alcance: qué hacer después de la auditoría

1. Corregir primero lo que bloquea la visibilidad (fallo, luego advertencia): get_fix_kit para hallazgos con kit: true, aplicar, report_task_done. Preguntar al usuario por cada valor FILL IN:; nunca inventar un logotipo, precio, dirección o perfil.
2. Después de las correcciones y nuevas páginas, push_to_search_engines con las URL cambiadas, y dar al usuario los enlaces de solicitud de indexación de Google.
3. Redactar las páginas en get_content_plan: mostrar cada borrador al usuario antes de publicar, luego report_content_published.
4. Conseguir menciones donde los asistentes buscan (abajo), y volver a medir con check_mentions.
5. Tiendas: build_product_feed, luego decir al usuario dónde enviar las URL del feed.
6. set_monitoring semanalmente, para que se detecten regresiones.

Difundiendo la palabra

Los asistentes recomiendan negocios que las fuentes que citan mencionan. get_outreach_plan lista esas fuentes (de las respuestas de IA) y brechas de presencia (Wikidata, perfiles). Encontrar cómo el negocio podría ser listado o mencionado honestamente en cada una (un listado de directorio, una corrección a un artículo desactualizado, un perfil, un elemento de Wikidata), redactarlo por completo y enviarlo con propose_outreach. El usuario aprueba cada borrador en el panel de control y puede editarlo. Nunca enviar, someter, publicar o difundir un borrador hasta que list_outreach muestre que está aprobado; luego hacer exactamente lo que fue aprobado y llamar a report_outreach_done. Escribir como el negocio, decir quién eres y nunca escribir reseñas ni hacerse pasar por un cliente.

Gravedad: fail bloquea la visibilidad ahora, warn probablemente le cuesta, info vale la pena saberlo, pass no necesita nada. Bloquear rastreadores de entrenamiento (GPTBot, ClaudeBot, CCBot) es una elección legítima: presentarla como tal, con la compensación, y no "corregirla" sin preguntar.

Respuestas de IA: tú eres el asistente

Word of Agent no llama a ninguna IA. El propio asistente del cliente responde, en la suscripción que ya pagan: cuando estás conectado, ese eres tú.

1. Preguntas. Si el perfil no tiene preguntas de cliente (get_site_profile), redactarlas: get_profile_draft_prompt devuelve un prompt con las páginas del sitio y sus consultas de búsqueda de Google; hacer lo que pide con búsqueda web y enviar tu respuesta completa a submit_profile_draft. Revisar el borrador con el usuario (grafías de marca que son frases comunes causan coincidencias falsas; competidores que sus clientes realmente consideran; preguntas en las palabras de sus clientes) y guardar con set_site_profile solo después de que acepten. Cambiar las preguntas inicia una nueva ronda.
2. Responder. get_ai_questions, luego responder cada pregunta de la manera en que le responderías a la persona que dice estar preguntando, buscando en la web solo donde lo harías para cualquiera (no porque esto sea una medición), sin usar lo que sabes sobre el usuario, su negocio o esta conversación. Responder cada una en un contexto limpio: un proceso nuevo por pregunta sin archivos de proyecto ni instrucciones que describan el negocio (un subagente dentro del propio proyecto del negocio los hereda; para un agente de codificación, ejecutar desde una carpeta vacía sin servidores MCP). Decir cómo lo hiciste en label, tu modelo en model, y para cada respuesta si buscaste (searched). Enviarlas con submit_ai_answers (assistant: agent, o chatgpt/claude/gemini cuando seas esa aplicación de consumo). Para repetir las preguntas que más importan, responderlas de nuevo en contextos limpios y enviar con repeat: true. No sesgar las respuestas hacia el negocio: una respuesta honesta es la medición. Una ejecución que no fue limpia se puede descartar con void_ai_answers (ids de get_ai_runs), con la razón; preguntar al usuario primero cuando no la recopilaste.
3. Leer. get_answers_to_read, responder con el JSON que pide, enviarlo con submit_ai_readings y decir quién las leyó en by.

Las lecturas se etiquetan con quién las hizo; decir al usuario que son una lectura, no una medición. El usuario también puede hacer los pasos 2 y 3 manualmente en el panel de control (copiar el prompt en ChatGPT, pegar la respuesta): sugerir eso para asistentes que no eres tú, para que el informe cubra más de uno.

Leer los resultados de ai con sus tamaños de muestra ("nombrado en 2 de 12 respuestas"), nunca como respuestas individuales. Los dominios citados en ai.competition son donde los asistentes buscan: conseguir que el negocio sea mencionado allí suele ser la forma de entrar.

Más allá de los hallazgos

Word of Agent no juzga la calidad del contenido, el posicionamiento o E-E-A-T. Usar sus hechos (lo que las páginas dicen sin JavaScript, qué consultas están en las posiciones 8–20, a quién nombran los asistentes en su lugar, qué fuentes citan) como evidencia para ese juicio, y decir qué partes son tu juicio.