sonpiaz/bto-skills/bto-page-quality

/bto-page-quality

Một câu hỏi: site có tốt không, và với ai? Trả lời bằng nhiều nguồn — không một tab duy nhất.

Bốn bẫy đã từng gây kết luận sai

1. Headless browser chiếm p75 trang ít traffic. PostHog/Web Vitals có thể báo LCP 20–30s trong khi PageSpeed mobile ~99. Mẫu hai cụm: nhanh hoặc >10s, không giữa — thường là bot Linux desktop (FCP = LCP). Lọc LCP ≥ 10s trước khi tin tab RUM thô.

2. Operator không phải thị trường. /admin với vài chục sample có thể là một người. Loại path admin/internal khỏi báo cáo công khai.

3. Một lần chạy Lighthouse mobile không phải đo. Cùng code, cùng ngày, delta hàng trăm ms là bình thường. Mobile: median ≥3 lần; spread nhỏ hơn delta mới là delta. Spread = 0 có thể là cache PSI — so across reports, không trong một report.

4. CrUX thiếu quốc gia ≠ "ổn ở đó". Chỉ có đủ traffic Chrome thật mới publish. Không có row = chưa đủ data, không phải nhanh.

Năm nguồn — mỗi nguồn trả lời một câu

CrUX API không có country; BigQuery country_summary có — ~1.5 GB/scan, lag ~2 tháng. Dùng sizing reach, không chỉ speed.

Script đo trong repo (khuyến nghị)

Tạo một lệnh (ví dụ npm run quality:page hoặc script trong scripts/) gom nguồn:

# Ví dụ shape — thay bằng repo bạn
bun run quality:page                  # full (~ vài phút nếu có PSI)
bun run quality:page --skip=lab       # bỏ Lighthouse
bun run quality:page --only=rum
bun run quality:page --json
bun run quality:page --days=7

Secret đọc từ env (CRUX_API_KEY, analytics key, GSC service account JSON). Script fail loudly khi thiếu nguồn — không in zero giả.

Sửa cái script tìm ra

Trang logged-in quan trọng hơn landing nếu khách trả tiền dùng dashboard hàng ngày. Cả hai trên list thì ưu tiên app/authenticated trước marketing.

Cache HTML ở edge + App Router RSC dễ gãy: một URL, hai body (vary: rsc). Cache rule match nhầm → client navigation nhận HTML document. Trước khi cache HTML: verify RSC vẫn bypass; có rollback snapshot; không overwrite snapshot rollback.

Rank tốt, CTR thấp → xem QUERY trước title. Brand query (tên bạn + api) tự nhiên CTR thấp ở page phụ. Chỉ sửa title khi query là intent không-brand. Loại site: search tự gây impression.

Byte weight là lever bạn kiểm soát. Budget ảnh (KB, max width), guard SSR payload trong CI.

Gap thường gặp (ưu tiên theo giá trị/giờ)

Workflow tuần: cron GitHub Actions chạy report vào summary; cần secret trong repo settings.

Email / alert nên skim hàng tháng

Search Console (indexing, structured data), analytics weekly digest, deploy fail platform, host crash, DB security advisor, DMARC XML — bổ sung những gì API không expose.

Mở rộng skill

Thêm nguồn chỉ khi trả lời câu hỏi mà năm nguồn trên không trả lời được. Ngưỡng đổi thì đổi trong script kèm lý do đo được.

Rule of three: lần thứ ba viết ad-hoc query CWV/GSC cho cùng câu hỏi → đưa vào script/skill.