Word of Agent은(는) 무엇을 하나요?
Word of Agent는 측정합니다. 사용자가 판단하고 수정합니다. 크롤러가 하는 방식으로 사이트를 가져오고, Search Console을 읽고, AI 어시스턴트가 고객의 질문에 제공하는 답변을 읽은 후, 안정적인 ID, 증거, 진단 단계, 수정 방법 및 확인 명령이 포함된 결과를 반환합니다. 수동으로 curl이나 웹 가져오기로 측정을 반복하지 말고, Word of Agent의 결과를 읽고 조치를 취하십시오.
플레이북
Word of Agent는 측정하고 확인합니다. 사용자가 작업을 수행합니다. 각 작업 유형을 시작하기 전에 해당 플레이북을 읽으십시오(get_playbook <이름>, 혹은 이 파일 옆의 playbooks/<이름>.md, 또는 woa playbook <이름>):
| 작업 | 플레이북 |
|---|---|
| 월간 AI 라운드: 고객에게 질문하고, 답변을 보내고 읽으며, 추세를 보고합니다. | ai-round |
| 사이트 플랫폼(Shopify, WordPress, Webflow, Wix 또는 Squarespace 가이드 참조)에서 사이트 수정 | site-edits |
| 콘텐츠 계획 브리프에서 페이지 작성 | content |
| 어시스턴트가 찾는 곳에 언급되기: 사람 찾기, 초안 작성, 승인 후 전송, 한 번의 후속 조치 | outreach |
| Search Console 및 AI 답변에서의 키워드 연구 | keywords |
| 주요 채널: 소유자에게 작업 가능한 방법을 묻고, 계획을 제안하며, 매달 검토합니다. | channels |
| 저널리스트를 위한 전문가 소스 되기: 보도 요청 및 분기별 데이터 스토리 | press |
| 파트너, 통합, 디렉토리 및 MCP 레지스트리 | partners |
| 로컬 리스팅 및 예약, 비즈니스 프로필 확인 | local |
| 리뷰 루프: 모든 고객에게 묻고, 모든 리뷰에 답변합니다. | reviews |
| 경쟁사와의 비교: 가격, 평점, 리뷰 | rivals |
| 경청하고, 비즈니스가 진정으로 도울 수 있는 곳에 답변합니다. | listening |
| B2B 기업을 위한 콜드 이메일 (게이트 뒤) | 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 <사이트> --format json |
| 수정 후 한 영역 재확인 | audit_site with only | woa audit <사이트> --only <검사> |
| 마지막 보고서 읽기 | get_report | woa audit 출력 또는 대시보드 |
| 증거가 포함된 하나의 결과 항목 | get_finding | (JSON 보고서 내) |
| AI 답변 확인용 질문 | get_site_profile, set_site_profile | woa site <사이트> --question "kind: …" |
| 고객 질문 초안 작성 | get_profile_draft_prompt, submit_profile_draft | woa site <사이트> --draft-prompt, --draft-reply < reply.txt |
| AI 답변 수집 (사용자가 답변) | get_ai_questions, submit_ai_answers | woa ai <사이트> prompt, woa ai <사이트> answers --assistant agent < reply.txt |
| 답변 읽기 (프레이밍, 주장) | get_answers_to_read, submit_ai_readings | woa ai <사이트> grading-prompt, woa ai <사이트> grades --label "…" < reply.json |
| 작업으로 결과 열기 및 작업 로그 | list_tasks | GET /api/sites/<사이트>/tasks |
결과 항목에 대한 정확한 수정 (kit: true) | get_fix_kit | woa fix <사이트> <키>, GET /api/sites/<사이트>/fix-kit?key= |
| Bing 및 IndexNow 엔진에 페이지 변경 알림 | push_to_search_engines | woa push <사이트> <url>… |
| 작성할 페이지 및 작성 프롬프트 | get_content_plan, report_content_published | woa plan <사이트> |
| 인용된 페이지가 현재 비즈니스를 명시하는지 확인 | check_mentions | POST /api/sites/<사이트>/mentions/check |
| Google Merchant Center 및 ChatGPT용 제품 피드 | build_product_feed | woa feed <사이트> |
| 악화된 항목에 대한 이메일이 포함된 예약 감사 | set_monitoring | woa monitor <사이트> weekly |
| 라운드별로 어시스턴트가 비즈니스를 언급한 빈도 | get_ai_trend | woa ai <사이트> trend |
| 다섯 가지 결과 라인: 발견됨, 추천됨, 언급됨, 신뢰됨, 알려짐 | get_outcomes | woa outcomes <사이트> |
| 어시스턴트가 비즈니스를 언급하지 않는 이유 (질문당 하나의 원인과 수정) | get_diagnosis | woa diagnose <사이트> |
| 소유자가 마케팅을 위해 할 수 있는 것 (대화 중 질문, 동의 후 저장) | get_situation, set_situation | woa situation <사이트> |
| 주요 채널: 계획, 소유자 승인을 위한 제안, 월간 검토 | get_channel_plan, propose_channel_plan, report_channel_review | woa channels <사이트> |
| 주간 보고서: 결과, 주요 채널 신호 대비 성과, 소유자 대기 항목 | get_weekly_report | woa weekly <사이트> |
| 어시스턴트별 로컬 리스팅 및 예약 경로, 소유자 리스팅 표시 내용 | get_local_routes, report_local_listing | woa local <사이트> |
| 리뷰 루프: 시간 경과에 따른 리뷰, 질문한 고객 | get_review_loop, report_reviews_asked | woa local <사이트> |
| 라운드 전체에서 비즈니스에 대해 잘못된 답변과 수정 보고 | get_claims, report_claim_fixed | woa claims <사이트> |
| 가격, 평점 및 리뷰에 대한 경쟁사와의 비교 | get_rival_comparison, report_rival_facts | woa rivals <사이트> |
| 비즈니스, 경쟁사 및 고객 질문이 나타나는 위치 | listen, get_heard, set_listen_feeds | woa listen <사이트> |
| 콜드 이메일: 발신 도메인, 국가 게이트를 통한 잠재 고객, 답장 및 수신 거부 | check_sender, add_prospects, list_prospects, set_prospect_status | woa outbound <사이트> |
| 사이트를 표시하는 검색어 및 사이트 없이 답변된 질문 | get_search_queries | woa queries <사이트> |
| Google 및 Bing에 사이트맵 제출 | submit_sitemaps | woa sitemaps <사이트> |
| 작업의 일부를 수행하는 방법 | get_playbook | woa playbook <이름> [<사이트>] |
| 수정 완료 표시 (Word of Agent 재확인) | report_task_done | POST /api/sites/<사이트>/tasks/done {"key", "note", "by"} |
| 멘션 받을 위치 및 아웃리치 초안 | get_outreach_plan, propose_outreach, list_outreach, report_outreach_done | `GET |
호스팅 (HTTP API). 호스팅된 Word of Agent를 사용하는 경우, 사용자가 대시보드(설정, API 토큰)에서 생성하여 환경 변수에 저장한 API 토큰으로 동일한 JSON을 HTTP를 통해 호출합니다. 절대 대화에 토큰을 포함하지 마십시오: Authorization: Bearer $WOA_TOKEN. 경로: POST /api/audits {"site", "only"}는 감사를 대기열에 넣고 즉시 작업을 반환합니다(202); status (queued, running, done, failed), 완료된 검사 수(done/total) 및 reportId를 위해 GET /api/audits/<id>를 폴링하거나, ?wait=1을 추가하여 완료된 작업을 한 번의 호출(약 100초 이내)로 가져옵니다. 또한 GET /api/sites, GET /api/sites/<사이트>/reports/latest, GET|PUT /api/sites/<사이트>/profile, GET /api/me도 있습니다. 계정에 사이트를 추가하려면: POST /api/accounts/<id>/sites {"site"}, 그런 다음 반환된 DNS TXT 레코드 또는 파일을 게시하고 POST /api/accounts/<id>/sites/<사이트>/verify를 호출합니다. AI 답변: GET /api/sites/<사이트>/ai (질문 및 프롬프트), 질문 순서대로 POST /api/sites/<사이트>/ai/answers {"assistant": "agent", "label", "answers": [{"text", "sources": []}]}, 그런 다음 GET /api/sites/<사이트>/ai/grading-prompt 및 POST /api/sites/<사이트>/ai/grades {"reply", "by"}. 토큰은 사람이나 다른 토큰을 관리할 수 없습니다.
검사 항목: search, access, site, readability, appearance, rich, links, render, performance, agent, presence, listings, reviews, ai. listings는 지도 및 디렉토리 정보를 사이트와 비교합니다(로컬 비즈니스만 해당). reviews는 어시스턴트가 찾는 곳에서 평점을 읽습니다. appearance는 검색 결과 및 링크 미리보기에서 사이트가 어떻게 보이는지(favicon, 사이트 이름, og: 태그, 스니펫 컨트롤)를 다룹니다. rich는 Product, Organization 로고, breadcrumb, LocalBusiness 및 Article 데이터를 다룹니다. 전체 감사는 1분에서 몇 분 정도 소요됩니다. 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로 결과를 가져와 사용자에게 Word of Agent의 언어로 알립니다: 어시스턴트가 비즈니스를 얼마나 자주 언급했는지, 대신 누구를 언급했는지, 무엇을 잘못 알았는지, 그리고 첫 번째 수정 사항을 알려줍니다. get_channel_plan에서 다음 단계를 제안합니다. 사용자는 대시보드(개요, 이 보고서 공유)에서 결과를 공유할 수 있습니다.
워크플로우
- 감사 또는 최근 보고서가 있는 경우 최신 보고서를 읽습니다. 가장 심각한 것부터 시작하여 일반 언어로 결과 수, 실패 및 경고 항목을 사용자에게 보고합니다.
- 수정 전 확인. 결과 항목의
diagnose단계를 따르십시오. 이는 감지된 CDN 또는 호스트에 따라 다릅니다. 접근할 수 없는 대시보드(Cloudflare, Search Console)가 필요한 단계가 있는 경우, 사용자에게 정확히 어디를 클릭해야 하는지 알려줍니다. - 수정은 원인이 코드베이스(서버 렌더링, 메타 태그, 구조화된 데이터, 리디렉션, 사이트맵 코드, 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를 호출합니다.- 어시스턴트가 찾는 곳에 언급되도록 하고(아래 참조),
check_mentions로 재측정합니다. - 상점:
build_product_feed를 호출한 후, 사용자에게 피드 URL을 제출할 위치를 알려줍니다. set_monitoring을 주간으로 설정하여 회귀가 감지되도록 합니다.
입소문 내기
어시스턴트는 인용하는 출처에서 언급하는 비즈니스를 추천합니다. 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에 누가 읽었는지 명시하십시오.
판독값은 작성자를 표시합니다. 사용자에게 이것이 판독값이며 측정값이 아니라고 알리십시오. 사용자는 수동으로 2단계와 3단계를 대시보드에서 수행할 수도 있습니다(프롬프트를 ChatGPT에 복사하고, 답변을 붙여넣기): 사용자가 아닌 다른 어시스턴트의 경우 이를 제안하여 보고서가 하나 이상의 어시스턴트를 포함하도록 하십시오.
ai 결과는 표본 크기와 함께 읽으십시오 ("12개 답변 중 2개에서 언급됨"), 단일 답변으로 읽지 마십시오. ai.competition의 인용된 도메인은 어시스턴트가 찾는 곳입니다: 그곳에 비즈니스가 언급되도록 하는 것이 일반적인 방법입니다.
발견 항목 외의 것
Word of Agent는 콘텐츠 품질, 포지셔닝 또는 E-E-A-T를 판단하지 않습니다. 해당 판단의 증거로 Word of Agent의 사실(JavaScript 없이 페이지가 말하는 내용, 8~20위에 랭크된 쿼리, 대신 이름이 오르는 어시스턴트, 인용하는 출처)을 사용하고, 어떤 부분이 사용자의 판단인지 명시하십시오.
[원본이 잘린 상태: 계속되지 않음]