Word of Agent
Word of Agent 負責測量；你負責判斷與修復。它會像爬蟲一樣抓取網站、讀取 Search Console、讀取 AI 助手對客戶問題的回答，並回傳具有穩定 ID、證據、診斷步驟、修復方案及驗證命令的發現結果。請勿用手動 curl 或網頁抓取重複其測量；請閱讀其發現結果並採取行動。
Playbook
Word of Agent 負責測量與驗證；你負責執行。在進行每項工作前，請先閱讀其 playbook（get_playbook <name>，或此檔案旁的 playbooks/<name>.md，或 woa playbook <name>）：
| 工作 | Playbook |
|---|---|
| 每月 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 |
| 針對 B2B 商家，在付費牆後的冷郵件 | cold-email |
工具
如果 MCP 伺服器已連線，請使用 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 |
| 修復後重新檢查某個領域 | audit_site 搭配 only | 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> |
| 跨多輪回答中關於商家的錯誤資訊，以及回報修復 | 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> |
| 提交 Sitemap 給 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 涵蓋 Product、Organization logo、breadcrumb、LocalBusiness 與 Article 資料。完整的審計需要一至幾分鐘。ai 會重新讀取你的使用者的 AI 助手所提供的最新回答；Word of Agent 不呼叫任何 AI，也不花費任何成本。
首次執行
當使用者要求你為某個網站設定 Word of Agent 時（「草擬我的客戶問題，然後收集第一批 AI 回答」）：
get_situation：詢問關於他們如何合作的開放式問題，一次問幾個；經他們同意後以set_situation儲存。- 草擬客戶問題：
get_profile_draft_prompt，執行其要求，submit_profile_draft，與使用者一同審閱，經他們同意後set_site_profile。 - 執行第一輪（
ai-roundplaybook），然後get_first_result，並以報告中的語言告訴使用者：AI 助手提及他們的頻率、誰取代了他們、哪裡說錯了以及第一個修復方案。 - 從
get_channel_plan提供後續步驟。他們可以從儀表板（總覽、分享此報告）分享結果。
工作流程
- 審計，或如果最近的報告還算新，則讀取最新報告。向使用者報告計數以及失敗與警告的發現項目，使用平白的語言，從最嚴重的開始。
- 確認後再修復。 遵循發現項目的
diagnose步驟；這些步驟是針對偵測到的 CDN 或主機而設。如果某個步驟需要你無法觸及的儀表板（Cloudflare、Search Console），請確切告訴使用者點擊哪裡。 - 修復 在程式碼庫中（當原因存在於伺服器端渲染、meta 標籤、結構化資料、重定向、sitemap 程式碼、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:值，請詢問使用者；切勿憑空捏造標誌、價格、地址或個人檔案。 - 修復與新增頁面後，使用變更後的 URL 執行
push_to_search_engines，並提供使用者在 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 回答：你就是 AI 助手
Word of Agent 不呼叫任何 AI。客戶自己的 AI 助手會回答，使用的是他們已支付的訂閱方案：當你連線時，你就是那個 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中說明是誰閱讀的。
閱讀結果會標示閱讀者身分；告知使用者這是閱讀結果，而非測量結果。使用者也可以在儀表板中手動執行步驟 2 和 3（將提示複製到 ChatGPT，再將回覆貼回去）：建議他們對你無法作為的 AI 助手執行此操作，以便報告能涵蓋多個來源。
使用樣本大小閱讀 ai 結果（「在 12 個回答中被提及 2 次」），而不是作為單一回答。ai.competition 中的引用網域是 AI 助手查看的地方：讓商家在這些地方被提及通常是成功的方法。
超越發現結果
Word of Agent 不判斷內容品質、定位或 E-E-A-T。使用它的事實（沒有 JavaScript 的頁面說了什麼、哪些查詢排名在 8–20 名、AI 助手改提了誰、它們引用了哪些來源）作為判斷的證據，並說明哪些部分是你的判斷。
限制
Word of Agent 只能檢查公開可存取的頁面。它無法閱讀需要登入或付費牆的內容。它無法修改網站、提交變更或代表使用者採取直接行動（除了透過已整合的搜尋引擎 API 之外）。審計結果的有效性取決於提供的資訊是否準確且完整。使用者應始終將自動化發現結果與手動驗證相結合。