Word of Agent
Word of Agent 负责测量；你来判断和修复。它会像爬虫一样抓取网站、读取 Search Console、读取 AI 助手对客户问题的回答，并返回带有稳定 ID、证据、诊断步骤、修复方案和验证命令的发现报告。不要手动重复执行 curl 或网页抓取来测量；直接阅读它的发现并采取行动。
剧本
Word of Agent 负责测量和验证；你来执行工作。在开始每种类型的工作前，请先阅读对应的剧本（get_playbook <name>，或该文件旁边的 playbooks/<name>.md，或 woa playbook <name>）：
| 工作 | 剧本 |
|---|---|
| 月度 AI 轮次：向客户提问、发送并阅读答案、报告趋势 | ai-round |
| 在网站上或在其平台（为 Shopify、WordPress、Webflow、Wix 或 Squarespace 站点传递网站地址）进行修复 | site-edits |
| 根据内容计划大纲撰写页面 | content |
| 在 AI 助手关注的来源中被提及：找到联系人、起草、获批准后发送、一次跟进 | outreach |
| 基于 Search Console 和 AI 回答的关键词研究 | keywords |
| 你的主要渠道：询问所有者如何合作、提出计划、每月回顾 | channels |
| 成为记者认可的专家来源：新闻请求和每季度一个数据故事 | press |
| 合作伙伴、集成、目录和 MCP 注册表 | partners |
| 本地列表和预订，以及商家资料检查 | local |
| 评价循环：询问每位客户、回复每条评价 | reviews |
| 你与竞争对手的对比：价格、评分、评价 | rivals |
| 倾听，并在企业能够真正提供帮助的地方回复 | listening |
| 面向企业级客户的冷邮件，在付费墙后 | cold-email |
工具
如果 MCP 服务器已连接，请使用它；否则使用 CLI。托管方式：claude mcp add --transport http wordofagent https://app.wordofagent.app/mcp（Claude.ai 和 ChatGPT：将其添加为自定义连接器）；用户在浏览器中批准一个账户。本地方式：claude mcp add wordofagent -- woa mcp。
| 任务 | MCP 工具 | CLI |
|---|---|---|
| 运行审计 | audit_site | woa audit <site> --format json |
| 修复后重新检查某个区域 | 使用 only 参数的 audit_site | woa audit <site> --only <check> |
| 读取最新报告 | get_report | woa audit 输出，或仪表盘 |
| 单个发现及其证据 | get_finding | （在 JSON 报告中） |
| AI 回答检查的问题 | get_site_profile, set_site_profile | woa site <site> --question "kind: …" |
| 起草客户问题 | get_profile_draft_prompt, submit_profile_draft | woa site <site> --draft-prompt, --draft-reply < reply.txt |
| 收集 AI 回答（你来回答） | get_ai_questions, submit_ai_answers | woa ai <site> prompt, woa ai <site> answers --assistant agent < reply.txt |
| 阅读回答（框架、主张） | get_answers_to_read, submit_ai_readings | woa ai <site> grading-prompt, woa ai <site> grades --label "…" < reply.json |
| 将发现作为任务打开，并查看工作日志 | list_tasks | GET /api/sites/<site>/tasks |
针对发现的精确修复方案（kit: true） | get_fix_kit | woa fix <site> <key>, GET /api/sites/<site>/fix-kit?key= |
| 通知 Bing 和 IndexNow 引擎页面已更改 | push_to_search_engines | woa push <site> <url>… |
| 待撰写页面及写作提示 | get_content_plan, report_content_published | woa plan <site> |
| 被引用的页面是否现在提及该商家 | check_mentions | POST /api/sites/<site>/mentions/check |
| 用于 Google Merchant Center 和 ChatGPT 的产品 Feed | build_product_feed | woa feed <site> |
| 定时审计并发送恶化情况的邮件 | set_monitoring | woa monitor <site> weekly |
| AI 助手逐轮提及商家的频率 | get_ai_trend | woa ai <site> trend |
| 五个结果维度：被发现、被推荐、被谈论、被信任、被听说 | get_outcomes | woa outcomes <site> |
| AI 助手不提及商家的原因，每个问题一个原因和修复方案 | get_diagnosis | woa diagnose <site> |
| 所有者可以做的营销事项（在对话中询问，经同意后保存） | get_situation, set_situation | woa situation <site> |
| 你的主要渠道：计划、给所有者的提案、月度回顾 | get_channel_plan, propose_channel_plan, report_channel_review | woa channels <site> |
| 每周报告：结果、主要渠道的信号对比、等待所有者处理的事项 | get_weekly_report | woa weekly <site> |
| 每个 AI 助手的本地列表和预订路线，以及所有者列表的显示内容 | get_local_routes, report_local_listing | woa local <site> |
| 评价循环：随时间变化的评价，被邀请评价的客户 | get_review_loop, report_reviews_asked | woa local <site> |
| AI 回答中关于商家的错误信息（跨轮次），以及报告修复情况 | get_claims, report_claim_fixed | woa claims <site> |
| 商家与竞争对手在价格、评分和评价上的对比 | get_rival_comparison, report_rival_facts | woa rivals <site> |
| 商家、其竞争对手及其客户问题出现的地方 | listen, get_heard, set_listen_feeds | woa listen <site> |
| 冷邮件：发送域名、通过国家门槛的潜在客户、回复和退订 | check_sender, add_prospects, list_prospects, set_prospect_status | woa outbound <site> |
| 展示网站以及未展示网站但被回答问题的搜索 | get_search_queries | woa queries <site> |
| 向 Google 和 Bing 提交站点地图 | submit_sitemaps | woa sitemaps <site> |
| 如何执行某部分工作 | get_playbook | woa playbook <name> [<site>] |
| 声明修复已完成（Word of Agent 会重新检查） | report_task_done | POST /api/sites/<site>/tasks/done {"key", "note", "by"} |
| 在哪里被提及以及外联草稿 | get_outreach_plan, propose_outreach, list_outreach, report_outreach_done | `GET |
托管（HTTP API）。 使用托管的 Word of Agent，可以通过 HTTP 调用相同的 JSON，使用用户在仪表盘（设置，API 令牌）中创建并放在你环境变量中的 API 令牌（切勿放在对话中）：Authorization: Bearer $WOA_TOKEN。路由：POST /api/audits {"site", "only"} 将审计加入队列并立即返回任务（202）；轮询 GET /api/audits/<id> 获取 status（queued、running、done、failed）、done/total 检查次数和 reportId，或添加 ?wait=1 以一次调用获取完成的任务（最长约 100 秒）。还有 GET /api/sites、GET /api/sites/<site>/reports/latest、GET|PUT /api/sites/<site>/profile、GET /api/me。要向账户添加站点：POST /api/accounts/<id>/sites {"site"}，然后发布它返回的 DNS TXT 记录或文件，并执行 POST /api/accounts/<id>/sites/<site>/verify。AI 回答：GET /api/sites/<site>/ai（问题和提示），POST /api/sites/<site>/ai/answers {"assistant": "agent", "label", "answers": [{"text", "sources": []}]}（按问题顺序），然后 GET /api/sites/<site>/ai/grading-prompt 和 POST /api/sites/<site>/ai/grades {"reply", "by"}。令牌无法管理人员或其他令牌。
检查项：search、access、site、readability、appearance、rich、links、render、performance、agent、presence、listings、reviews、ai。listings 将地图和目录与网站进行对比（仅限本地商家）；reviews 读取 AI 助手查看的评分。appearance 涵盖网站在搜索结果和链接预览中的外观（favicon、站点名称、og: 标签、摘要控制）；rich 涵盖产品、组织徽标、面包屑导航、本地商家和文章数据。完整审计需要一到几分钟。ai 重新读取你用户的助手给出的最新回答；Word of Agent 不调用任何 AI，也不产生费用。
首次运行
当用户要求你为某个站点设置 Word of Agent（“起草客户问题，然后收集第一批 AI 回答”）时：
get_situation：每次询问几个关于他们如何合作的开放性问题；在他们同意后使用set_situation保存。- 起草客户问题：
get_profile_draft_prompt，按它要求操作，submit_profile_draft，与用户一起审阅，在他们同意后使用set_site_profile保存。 - 运行第一轮（
ai-round剧本），然后get_first_result，并用它的语言告诉用户：AI 助手提及他们的频率、提到了谁而不是他们、哪些回答有误、以及第一个修复方案。 - 提供
get_channel_plan中的下一步建议。他们可以从仪表盘（概览，分享此报告）分享结果。
工作流程
- 审计，或读取最近的报告（如果时间较近）。用通俗语言向用户报告计数以及失败和警告发现，按严重程度从高到低排列。
- 确认后再修复。 遵循发现的
diagnose步骤；这些步骤针对检测到的 CDN 或主机。如果某一步骤需要你无法访问的仪表盘（Cloudflare、Search Console），请告诉用户确切点击位置。 - 修复 代码库中的问题（服务器渲染、meta 标签、结构化数据、重定向、站点地图代码、robots.txt）。CDN 或 Search Console 中的设置由用户自行更改；向他们提供步骤。
- 验证：使用你更改的内容调用
report_task_done；Word of Agent 会重新运行检查并回答verified或still-open（附带新的详细信息）。这也会更新用户的工作日志。如果没有 MCP 服务器，请使用发现的verify命令。
扩大影响力：审计后该做什么
- 首先修复阻碍可见性的问题（失败优先，然后是警告）：对于
kit: true的发现使用get_fix_kit，应用修复，调用report_task_done。请用户填写每个FILL IN:值；切勿自行编造徽标、价格、地址或个人资料。 - 修复和新页面完成后，使用
push_to_search_engines推送更改过的 URL，并向用户提供 Google 请求索引的链接。 - 撰写
get_content_plan中的页面：在发布前向用户展示每个草稿，然后调用report_content_published。 - 在 AI 助手关注的来源中被提及（见下文），并通过
check_mentions重新测量。 - 商店：
build_product_feed，然后告诉用户在哪里提交 Feed URL。 - 设置
set_monitoring为每周一次，以便捕获回退。
广而告之
AI 助手会推荐那些它们引用的来源中提及的商家。get_outreach_plan 列出了这些来源（来自 AI 回答）和存在缺口（Wikidata、个人资料）。找出商家如何能够以诚实的方式在每个来源中被列出或被提及（目录列表、对过时文章的更正、个人资料、Wikidata 条目），完整起草，并通过 propose_outreach 发送。用户在仪表盘中批准每个草稿，并可进行编辑。在 list_outreach 显示草稿被批准之前，切勿发送、提交、发布或发表任何草稿；然后，严格按照批准的内容执行，并调用 report_outreach_done。以商家的身份写作，说明你是谁，切勿撰写评价或冒充客户。
严重级别：fail 表示当前阻碍可见性，warn 表示可能造成损失，info 表示值得了解，pass 表示无需操作。阻止训练爬虫（GPTBot、ClaudeBot、CCBot）是合理的选择：将其作为一项存在权衡的选择呈现，未经询问不要“修复”它。
AI 回答：你就是助手
Word of Agent 不调用任何 AI。客户的助手自己回答，使用的是他们已经订阅的服务：当你连接时，你就是那个助手。
- 问题。 如果资料中没有客户问题（
get_site_profile），请起草它们：get_profile_draft_prompt返回一个包含站点页面和 Google 搜索查询的提示；按它要求使用网络搜索，并将你的完整回复发送给submit_profile_draft。与用户一起审阅草稿（常见的品牌拼写变体可能导致误匹配；客户真正考虑的竞争对手；用客户自己的语言提出的问题），并仅在用户同意后使用set_site_profile保存。更改问题将开始新一轮。 - 回答。 调用
get_ai_questions，然后以你回答该问题所指定提问者的方式回答每个问题，仅在你为其他人也会搜索的情况下搜索网络（而不是因为这是一次测量），不要使用你所知道的关于用户、其业务或本次对话的信息。在干净的上下文中回答每个问题：每个问题使用一个全新的进程，不包含项目文件或描述业务的指令（如果是在业务自己的项目内运行的子代理，则会继承这些；对于编码代理，请从一个空文件夹运行，不带任何 MCP 服务器）。在label中说明你如何做到的，在model中说明你的模型，并为每个回答说明你是否进行了搜索（searched）。使用submit_ai_answers发送它们（assistant:agent，或当你是消费者应用时为chatgpt/claude/gemini）。要重复最重要的问题，请在新的上下文中再次回答它们，并使用repeat: true发送。不要偏向商家的回答：诚实的回答就是测量本身。对于不干净的运行，可以使用void_ai_answers（ID 来自get_ai_runs）将其搁置，并说明原因；如果不是你自己收集的，请先询问用户。 - 阅读。 调用
get_answers_to_read，按照要求返回 JSON，使用submit_ai_readings发送，并在by中说明是谁阅读的。
阅读结果会标记由谁制作；告诉用户这是阅读结果，而非测量结果。用户也可以手动在仪表盘（将提示复制到 ChatGPT，粘贴回复回去）中执行步骤 2 和 3：建议针对你不是的助手这样做，以便报告覆盖多个来源。
阅读 ai 结果时应注意样本量（“在 12 个回答中的 2 个中被提及”），切勿作为单个回答。ai.competition 中提到的域名是 AI 助手查看的来源：让商家在这些地方被提及通常是关键。
超越发现
Word of Agent 不评判内容质量、定位或 E-E-A-T。请使用它的事实（无需 JavaScript 的页面内容、排名在 8-20 位的查询、AI 助手提到谁而不是商家、它们引用了哪些来源）作为该判断的证据，并说明哪些部分是你的判断。
由于此处内容被截断，翻译也相应停止。如果需要继续翻译被截断的部分，请提供完整原文。