@usercase/mcp 0.2.3-next.0 → 0.2.3-next.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usercase/mcp",
-  "version": "0.2.3-next.0",
+  "version": "0.2.3-next.1",
   "description": "Virtual users that browse your website and tell you what they thought — an MCP server for Claude Code",
   "license": "UNLICENSED",
   "homepage": "https://usercase.io",

package/src/run/visit.js

@@ -47,14 +47,30 @@ const MAX_TIMES = { click: 4, scroll: 5, scroll_up: 5 };
  * 걸음마다 찍지 않는다. 영상(세션 리플레이)은 봇의 움직임이 드러나 쓰지 않기로 했다(10/21)
  *   no_change    눌렀는데 화면이 그대로
  *   left_unhappy 원하던 걸 못 이루고 떠남(leave, done=false) — 마지막 화면
- *   bounced      들어오자마자 뒤로
- *   card         질문 카드가 뜬 화면 — 카드는 걸음이 아니라 바로 앞 걸음에 붙인다(첫 걸음 전이면 다음 걸음)
+ *   covered      사이트의 무언가(팝업 등)가 덮어 못 누름 — 우리 카드·위젯이 덮은 것은 뺀다
+ *   error        화면이 깨짐 — 문서가 오류로 옴(4xx·5xx), 오류 문구뿐인 화면.
+ *                끝내 안 열리는 화면은 못 찍는다 — 불러오는 중에는 브라우저가 화면을 안 내준다(10/22 시험)
+ * 우리 카드(Usercase 질문 카드)는 찍지 않는다 — 사이트 문제가 아니다. 카드가 떠 있는 동안도 안 찍는다(10/22)
  * 누른 곳(box)은 사진에 그리지 않고 걸음에 비율(0~1)로 적는다. 대시보드가 위에 그린다
  */
 const MAX_SCREENS = 6;
 // 서버 앞 nginx 의 기본 본문 한도가 1MB 다 — base64 로 커지니 원본은 600KB 아래로
 const MAX_SCREEN_BYTES = 600 * 1024;
 
+/**
+ * 오류 문구뿐인 화면인가 — 404·"not found"·"application error" 등. 글이 짧은 화면만 본다(기사 속 "404" 는 아니다).
+ * 클라이언트에서 그리는 404(Next.js 등)는 문서가 200 으로 와서 상태로는 모른다
+ */
+async function errorScreen(page) {
+  return page
+    .evaluate(() => {
+      const t = ((document.body && document.body.innerText) || "").replace(/s+/g, " ").trim();
+      if (t.length > 600) return false;
+      return /(404|500|502|503)|not found|page (doesn.?t|does not|could not|cannot) (exist|be found)|application error|something went wrong|internal server error/i.test(t);
+    })
+    .catch(() => false);
+}
+
 /** 요소가 화면에서 차지한 곳(화면 비율). 화면 밖이거나 사라졌으면 null */
 async function boxOf(page, el) {
   const b = el ? await el.boundingBox().catch(() => null) : null;
@@ -70,13 +86,22 @@ async function boxOf(page, el) {
 }
 
 /**
- * 누르기 전후를 견줄 지문 — 주소, 페이지 전체 글(보이는 것만, 굴려도 같다), 누른 요소의 상태(색만 바뀌는 좋아요·토글).
+ * 누르기 전후를 견줄 지문 — 주소, 페이지 전체 글(보이는 것만, 굴려도 같다), 보이는 입력칸·그림, 누른 요소의 상태(색만 바뀌는 좋아요·토글).
+ * 입력칸은 글(innerText)에 안 잡힌다 — 검색 아이콘을 눌러 검색칸이 열렸는데 "그대로" 로 찍혔다(10/22 실험실 e4)
  * 글이 저절로 바뀌는 사이트(넘어가는 배너)에서는 "바뀌었다" 로 본다 — 그대로라고 잘못 찍는 것보다 낫다
  */
 async function clickPrint(page, el) {
   const doc = await page
     .evaluate(() => {
-      const t = (document.body && document.body.innerText) || "";
+      const shown = (n) => {
+        const r = n.getBoundingClientRect();
+        return r.width > 0 && r.height > 0 && getComputedStyle(n).visibility !== "hidden";
+      };
+      const extra = [...document.querySelectorAll("input,textarea,select,[contenteditable=true],img,video,iframe,canvas")]
+        .filter(shown)
+        .map((n) => [n.tagName, n.getAttribute("placeholder"), n.getAttribute("aria-label"), n.getAttribute("src")].join(":"))
+        .join("|");
+      const t = ((document.body && document.body.innerText) || "") + "|" + extra;
       let h = 5381;
       for (let i = 0; i < t.length; i++) h = ((h << 5) + h + t.charCodeAt(i)) | 0;
       return `${t.length}:${h}`;
@@ -353,6 +378,13 @@ class Visit {
     // 손은 방문 내내 이어진다 — 커서가 있던 자리에서 다음 곳으로 간다
     this.handState = { rhythm, mouse: null };
     this.steps = [];
+    /** 이번 조작으로 받은 문서의 상태 코드(본 탭의 화면 이동만). 조작마다 비운다 */
+    this.docStatus = null;
+    page.on("response", (res) => {
+      try {
+        if (res.request().isNavigationRequest() && res.frame() === page.mainFrame()) this.docStatus = res.status();
+      } catch {}
+    });
     /** 문제가 있던 순간의 화면 { step, image(JPEG) } — 방문이 끝나면 hub 가 서버로 올린다 */
     this.screens = [];
     this.history = [];
@@ -447,9 +479,6 @@ class Visit {
   async answer(decision) {
     const shown = this.pending;
     if (!shown) throw new Error("No card is showing");
-    // 첫 걸음 전에 뜬 카드(들어오자마자)는 붙일 걸음이 없다 — 찍어 두었다가 다음 걸음에 붙인다(10/22 실험실 w5)
-    if (this.steps.length) await this.shoot(this.steps[this.steps.length - 1], "card");
-    else this.early = { kind: "card", image: await this.snap() };
     const act = answer.toAction(decision, shown);
     // 카드를 읽고 정하는 시간. 닫는 건 금방, 쓰는 건 치는 만큼
     await sleep(act.kind === "close" ? 600 + Math.random() * 1800 : 1500 + Math.random() * 3000);
@@ -500,13 +529,6 @@ class Visit {
     const view = this.lastView || (await listControls(page));
     const item = view.items[decision.index];
     const record = { step: this.steps.length + 1, t: Date.now() - this.t0, path: view.path, action: decision.action, why: decision.why, label: item?.label ?? null };
-    if (this.early) {
-      if (this.early.image && this.screens.length < MAX_SCREENS) {
-        record.screen = { kind: this.early.kind, box: null };
-        this.screens.push({ step: record.step, image: this.early.image });
-      }
-      this.early = null;
-    }
     const times = Math.max(1, Math.min(MAX_TIMES[decision.action] || 1, Math.round(Number(decision.times) || 1)));
     if (times > 1) record.times = times;
     // 한 번에 할 수 있는 수보다 많이 달라고 했다. 말없이 줄이면 "사이트가 클릭을 삼킨다" 로 읽었다(10/20 실험실 p7: 15·20·30번이 다 4번)
@@ -517,6 +539,7 @@ class Visit {
     const externalBefore = this.external.length;
     this.fileWindow = null;
     this.lastAction = decision.action;
+    this.docStatus = null;
 
     if (decision.action === "leave") {
       record.done = !!decision.done;
@@ -556,10 +579,6 @@ class Visit {
       }
       await sleep(250);
     } else if (decision.action === "back") {
-      // 이 화면에 와서 한 걸음도 채 안 하고 돌아간다 — 들어오자마자 뒤로. 돌아가기 전 화면을 찍는다
-      let here = 0;
-      for (let i = this.steps.length - 1; i >= 0 && this.steps[i].path === view.path; i--) here++;
-      if (here <= 1) await this.shoot(record, "bounced");
       await page.goBack({ waitUntil: "domcontentloaded" }).catch(() => {});
       if ((await settle(page, before, net)).navTimeout) this.diag.push({ kind: "nav_timeout", action: "back" });
     } else if (decision.action === "type") {
@@ -660,9 +679,13 @@ class Visit {
             })
             .catch(() => {});
           // 사람 손이라 빗나갈 수 있다. 빈 곳을 누르면 아무 일도 안 일어난다 — 그게 헛클릭이다
+          let ours = false;
           const clicked = await hand
             .clickLikePerson(page, this.handState, el)
-            .catch((e) => ((record.skipped = e.human || humanClickError(e)), { missed: false }));
+            .catch((e) => ((record.skipped = e.human || humanClickError(e)), (ours = /eb-insight|eb-plugin/.test(String(e.message))), { missed: false }));
+          // 사이트의 무언가가 덮어 못 눌렀다. 우리 카드·위젯이 덮은 것은 사이트 탓이 아니다
+          if (record.skipped && /on top of it/.test(record.skipped) && !/survey card/.test(record.skipped) && !ours)
+            await this.shoot(record, "covered", await boxOf(page, el));
           if (clicked.missed) {
             record.missed = true;
             this.history.push("Your click landed just outside it and nothing happened.");
@@ -696,11 +719,6 @@ class Visit {
       // "다른 앱을 열려 했다" 고 알리면 방문자가 사이트 탓으로 적었다(10/22 실험실 q4)
       if (decision.action === "back") {
         record.backOut = true;
-        // 돌아가지 못했다 — 들어오자마자 뒤로(bounced)로 찍은 것은 무른다
-        if (record.screen && record.screen.kind === "bounced") {
-          delete record.screen;
-          this.screens = this.screens.filter((s) => s.step !== record.step);
-        }
       } else {
         record.openedApp = true;
         this.diag.push({ kind: "left_to_blank", action: decision.action, shape: null });
@@ -734,6 +752,15 @@ class Visit {
     if (this.fileWindow) record.fileWindow = fileWindowNote(this.fileWindow);
     await this.noteDiag(record, decision, diagEl);
 
+    // 화면이 깨졌다 — 오류로 온 문서, 오류 문구뿐인 화면. 바깥 사이트·앱·빈 페이지로 간 것은 뺀다
+    if (
+      !record.offsite &&
+      !record.openedApp &&
+      !record.backOut &&
+      ((this.docStatus && this.docStatus >= 400) || (page.url() !== before && (await errorScreen(page))))
+    )
+      await this.shoot(record, "error");
+
     // 눌렀는데 그대로. 우리 쪽 사정(빗나감·막은 요청·바깥 사이트·파일 창)으로 그대로인 것은 빼고, 같은 것은 한 번만
     if (
       probe &&
@@ -780,11 +807,14 @@ class Visit {
   }
 
   /**
-   * 지금 화면을 찍어 이 걸음에 붙인다(record.screen). 보이는 만큼만(뷰포트). 크면 한 번 더 작게, 그래도 크면 안 찍는다
+   * 문제가 있던 화면을 찍어 이 걸음에 붙인다(record.screen). 보이는 만큼만(뷰포트). 크면 한 번 더 작게, 그래도 크면 안 찍는다
    * 실패해도 방문은 그대로 간다
    */
   async shoot(record, kind, box = null) {
     if (!record || record.screen || this.screens.length >= MAX_SCREENS) return;
+    // 우리 카드가 떠 있다. 눌렀는데 그대로인 것도 카드가 가로챈 것일 수 있다 — 사이트 탓으로 찍지 않는다
+    const card = await readCard(this.page).catch(() => null);
+    if (card && card.visible) return;
     const image = await this.snap();
     if (!image) return;
     record.screen = { kind, box };