Mã nguồn mở Kế thừa lõi vn-law-check Playwright

Đo lường bằng chứng Cookie & Tracker trên trình duyệt thật. Rà soát kỹ thuật trước khi đi vào hoạt động.

Quét tĩnh mã nguồn và quét động bằng trình duyệt thật (3 phiên desktop, thêm 1 phiên mobile) bổ sung cho nhau. Phát hiện network beacon và cookie bên thứ ba trước/sau khi khách nhấn Đồng ý. Không suy đoán — chỉ ghi nhận bằng chứng kỹ thuật.

Bắt đầu sử dụng Xem mã nguồn trên GitHub

Không kết luận pháp lý Bằng chứng có thể đối soát

vn-law-guard / scan

BẢN DEMO

1366 × 768

Lần truy cập đầu tiên

ĐANG KIỂM TRA NETWORK

$ python scripts/dynamic_scan.py https://example.vn

[00:00.00] Mở trang chủ · phiên mới

[00:00.41] Đang theo dõi request bên thứ ba…

[00:01.08] Cookie trước consent: 0

[00:01.12] Đang chờ lựa chọn của người dùng

DESKTOP 1366PX Chromium · 3 phases

Network request

Theo dõi thực tế

Trước / sau consent

Desktop

1366px

Mobile

390px

Cách đo lường

Tại sao quét tĩnh là chưa đủ?

Đọc mã nguồn giúp tìm dấu hiệu. Trình duyệt thật cho biết chính xác website làm gì khi tải và khi người dùng chọn.

01 / PHÂN TÍCH MÃ NGUỒN

Quét tĩnh · Static grep

Đọc chuỗi HTML và JavaScript trên mã nguồn.
Hữu ích để tìm dấu hiệu script và cấu hình được khai báo sẵn.
Không quan sát được tracker nạp muộn qua GTM, App Embeds hoặc React SPA.

Phân tích tệp · Không mô phỏng hành vi

02 / CHẠY TRÌNH DUYỆT

Quét động · VN Law Guard

Khởi chạy Chromium và mô phỏng lựa chọn của khách.
Ghi nhận request /collect, fbevents.js và cookie _ga, _fbp.
Phân biệt ping Consent Mode gcs=G100 với cookie được tạo.

Network · Cookie · 3 phiên desktop + 1 phiên mobile

Case study ẩn danh · Một website B2B

Một iframe YouTube. Cookie theo dõi trước khi khách đồng ý.

Video YouTube nhúng trên trang giới thiệu vẫn tải tài nguyên bên thứ ba và đặt cookie dù khách đã từ chối banner. So sánh trước và sau khi chuyển sang YouTube Facade.

CASE STUDY ẨN DANH

TỪ CHỐI CONSENT · TRƯỚC KHI SỬA MẪU LOG

Iframe tải dù khách đã từ chối.

YouTube iframe thông thường phát sinh request đến miền Google và cookie theo dõi trước khi khách xem video.

Request tới YouTube, Google 2 cookie theo dõi

NETWORK INSPECTOR AFTER: DECLINE

GET www.youtube.com/youtubei/v1/player 200 · third-party

SET VISITOR_INFO1_LIVE youtube.com · tracker

SET YSC youtube.com · tracker

GET google.com/s/… 200 · third-party

RÒ RỈ TRƯỚC CONSENT KHI TẢI TRANG

Log trên trang là bản rút gọn để minh họa, không phải kết quả quét trực tiếp. Tab “Sau khi sửa” là kết quả mong đợi khi áp dụng mẫu youtube-facade.html; hãy chạy lại dynamic_scan.py để xác nhận trên website của bạn.

Nền tảng hỗ trợ

Tìm đúng chỗ cần sửa.

Hướng dẫn khắc phục theo cách website được xây dựng — với đoạn mã tham khảo để đội ngũ kỹ thuật bắt đầu.

Customer Privacy API

Đồng bộ lựa chọn với pixel của cửa hàng.

Dùng cài đặt quyền riêng tư gốc của Shopify, giới hạn vùng Việt Nam và kiểm tra cách consent truyền tới ứng dụng cùng kênh quảng cáo.

Kiểm tra banner Customer Privacy theo thị trường
Đối soát trạng thái consent với pixel và Google Ads
Rà soát Shopify App Embeds nạp tracker động

Hướng dẫn: references/platforms/shopify.md

shopify-consent-mode.liquid TRÍCH ĐOẠN

gtag('consent', 'default', {
  analytics_storage: 'denied', ad_storage: 'denied', …
});
document.addEventListener('visitorConsentCollected', function (e) {
  apply(e.detail.analyticsAllowed, e.detail.marketingAllowed);
});

Trích đoạn rút gọn — cần điều chỉnh và đo lại theo cấu hình thực tế. Xem mẫu đầy đủ

WooCommerce · plugin consent

Rà cấu hình, không chỉ nhìn giao diện banner.

Đối chiếu cài đặt Complianz hoặc CookieYes với request thực tế; ưu tiên trì hoãn video nhúng và form thông tin khách hàng.

Kiểm tra quy tắc chặn trước consent
Trì hoãn iframe và mã bên thứ ba
Rà checkbox trên form tư vấn, báo giá

Hướng dẫn: references/platforms/wordpress-woocommerce.md

youtube-facade.html TRÍCH ĐOẠN

<div class="yt-facade" data-id="VIDEO_ID">
  <button type="button" aria-label="Phát video">▶</button>
</div>

Trích đoạn rút gọn — cần điều chỉnh và đo lại theo cấu hình thực tế. Xem mẫu đầy đủ

Next.js · PHP · Laravel · HTML tĩnh

Tích hợp gọn, phù hợp với luồng hiện có.

Mẫu consent nhẹ để đội phát triển ghép vào ứng dụng và kiểm tra rằng form báo giá chỉ lưu thông tin sau khi có lựa chọn rõ ràng.

Không phụ thuộc thư viện giao diện nặng
Đồng bộ lựa chọn với các script theo dõi
Đối chiếu trạng thái và request sau sửa

Hướng dẫn: references/platforms/custom-code.md

generic-consent-mode.html TRÍCH ĐOẠN

gtag('consent', 'default', {
  ad_storage: 'denied', ad_user_data: 'denied',
  ad_personalization: 'denied', analytics_storage: 'denied'
});
// GA4/GTM/Pixel chỉ được nạp sau khi khách bấm Chấp nhận

Trích đoạn rút gọn — cần điều chỉnh và đo lại theo cấu hình thực tế. Xem mẫu đầy đủ

Cách bắt đầu

Tự chạy, hoặc nhờ người rà giúp.

Công cụ miễn phí theo giấy phép MIT. Cần Python 3.10+ và Git; chạy được trên Windows, macOS, Linux.

A / TỰ LÀM · LẬP TRÌNH VIÊN, AGENCY

Cài đặt và quét một website

git clone https://github.com/gonostudy305/vn-law-guard.git
cd vn-law-guard
python -m pip install -r requirements.txt
python -m playwright install chromium
python scripts/dynamic_scan.py https://example.vn --out ./report

Thêm --lang en để có báo cáo tiếng Anh. Dùng như AI skill cho Claude Code hoặc Antigravity: xem README.

Mở README trên GitHub

B / CẦN NGƯỜI LÀM GIÚP · CHỦ DOANH NGHIỆP

Rà soát và sửa giúp, có báo cáo bằng chứng

Chạy bộ quét trên website của bạn và giải thích kết quả bằng ngôn ngữ dễ hiểu.
Sửa theme, banner cookie hoặc video nhúng khi bạn đồng ý, rồi đo lại để đối chiếu.
Bàn giao hồ sơ kỹ thuật để pháp chế hoặc luật sư xem tiếp.

Xem dịch vụ cho doanh nghiệp

Mã nguồn mở & ghi nhận upstream

Checklist pháp lý trong thư mục references/law/ giữ nguyên từ dự án vn-law-check của tác giả mhfed, theo giấy phép MIT. Cập nhật từ upstream bằng scripts/sync_upstream.sh.