capturelisted

# capture — 개인용 검색·AI 가시성 Capture 엔진 측정하고, 캐고, 갭을 찾고, 리포트를 뱉는다. 콘텐츠 제작은 스코프 밖. 수집은 scripts/가, 판단은 Claude가, 기억은 SQLite(Brain)가, 출력은 로컬 HTML이 맡는다. ## 철칙 (Brain-first) 1. **즉흥 금지.** 순위·노출·인용·키워드에 대한 모든 주장은 Brain 조회 결과를 근거로 한다. 조회는 `python scripts/db.py sql "SELECT ..."` (읽기 전용). 데이터가 없으면 "없다"고 말하고 수집을 제안한다. Brain 근거는 `gsc_snapshots`(기간 합계)만이 아니다 — 날짜별 추이는 `gsc_daily`, 디바이스·국가 분해는 `gsc_breakdown`, 색인 상태는 `gsc_index_status` 에 있다. "언제부터 떨어졌나"·"모바일만 나쁜가"·"색인은 됐나"는 합계 스냅샷으로는 답이 안 나온다 — 이 세 테이블을 조회해서 답한다. (예외: `scripts/gsc_query.py` 로 서치콘솔을 직접 조회한 결과도 근거로 인정 — 원본 데이터라 Brain 스냅샷보다 신선하다. 어느 쪽 근거인지는 밝힌다.) **두 경로의 숫자는 원래 다르다 — 섞어서 비교하지 마라.** | | 즉석 조회 (`gsc_query.py`) | Brain (`collect_gsc.py`) | |---|---|---| | 데이터 상태 | `all` — 미확정 포함 (GSC 대시보드와 같은 값) | `final` — 확정만 | | 창 끝 | 오늘 | 오늘 − 3일 | | 쓰임 | 지금 이 순간을 묻는 즉석 질문 | 스냅샷끼리 비교·결정적 스코어링 | 같은 "지난 28일"이 두 경로에서 다른 값으로 나오는 건 **버그가 아니라 설계다**. 구글은 최근 2~3일 수치를 나중에 채워 넣는다 — 즉석 답은 그걸 보여줘야 쓸모가 있고, Δ 비교는 그걸 빼야 거짓이 안 된다. 그래서 **즉석 조회 수치와 Brain 수치를 빼서 증감을 말하면 안 된다**. 증감은 Brain 안에서만, 즉석 현황은 gsc_query 로. 2. **비용 고지.** 외부 API를 부르는 작업(collect_ai)은 실행 전 반드시 `--dry-run`으로 호출 수를 보여주고 사용자 확인을 받는다. 3. **리포트는 Next Actions로 끝난다.** 분석 없이 빈 액션으로 리포트를 내보내지 않는다. 4. 데이터 해석 규칙(비결정성, GSC 구멍, 노이즈 임계값)은 `references/scoring.md` 4절을 따른다. ## 답변 형식 (채팅으로 나가는 모든 말) 한 줄 결론 → 근거 표 → **다음 한 걸음 하나** → 접어 둔 "안 한 것". 정본은 `../setup/references/reply-format.md` — 작업을 끝내고 보고하기 전에 그 뼈대를 따른다. 근거는 Brain 조회 결과여야 하고(철칙 1), 다음 걸음의