# Agent Instructions — CHIP.VN

Tài liệu này mô tả cách AI agent đọc và điều hướng cửa hàng CHIP.VN.
This document describes how AI agents can read and navigate the CHIP.VN online store.
(English summary at the end.)

## Cửa hàng

Túi xách, balo, ví & bóp, charm & móc khóa — thương hiệu CHIP.VN, Việt Nam.
Nội dung tiếng Việt, giá VND, giao hàng trong lãnh thổ Việt Nam.

## Đọc dữ liệu (không cần xác thực)

### Cấu trúc URL

| Loại trang | URL |
|---|---|
| Trang chủ | `/` |
| Danh mục (PLP) | `/{category-slug}` — ví dụ `/tui-deo-cheo`, `/balo`, `/vi-bop` |
| Sản phẩm (PDP) | `/{category-slug}/{product-slug}` |
| Bộ sưu tập | `/{slug}` như danh mục — ví dụ `/chipvn-new-arrival`; riêng `/collections/chio2nd` giữ tiền tố |
| Trang thông tin | `/gioi-thieu`, `/faqs`, `/doi-tra`, `/ho-tro`, `/lien-he`, `/he-thong-cua-hang` |
| Tìm kiếm | `/search?query={từ khóa}` |

- `GET /sitemap.xml` — toàn bộ URL đang sống. Nguồn đáng tin nhất để liệt kê sản phẩm.
- `GET /llms.txt` — bản tóm tắt máy-đọc-được của cửa hàng.
- URL sản phẩm cũ dạng `/products/{slug}` tự chuyển hướng 301 (một bước) về URL hiện hành — theo redirect là đủ, đừng tự suy đoán URL.

### Dữ liệu có cấu trúc

Mỗi trang sản phẩm nhúng JSON-LD trong HTML server-render đầu tiên (không cần chạy JavaScript):

- `Product` — tên, mô tả, ảnh, thương hiệu, khoảng giá (VND), tình trạng còn hàng.
- `BreadcrumbList` — vị trí sản phẩm trong cây danh mục.
- `Organization` — thông tin thương hiệu (mọi trang).

Đọc giá và tồn kho từ JSON-LD thay vì bóc màn hình: chuỗi văn bản trong HTML chứa cả catalogue i18n nên grep text thô sẽ sai.

## Quy tắc

- **Thanh toán cần con người duyệt.** Không có API checkout cho agent; việc đặt hàng đi qua giao diện web và phải do người mua thao tác/duyệt.
- **Tôn trọng robots.txt** — các đường `/cart`, `/checkout`, `/account`… là bề mặt phiên, không đọc được và không nên crawl.
- **Nhịp truy cập vừa phải.** Crawl sitemap ở tốc độ hợp lý; back off khi gặp 429/5xx.

## Liên hệ

- Email: happytohelp@chip.vn
- Trang liên hệ: `/lien-he`
- Hệ thống cửa hàng vật lý: `/he-thong-cua-hang`

---

## English summary

CHIP.VN is a Vietnamese handbag/backpack/wallet brand. Store content is Vietnamese; prices are VND; delivery within Vietnam only.

- **Enumerate products** via `GET /sitemap.xml`. Product URLs are `/{category-slug}/{product-slug}`; legacy `/products/{slug}` URLs 301-redirect in one hop.
- **Read structured data** from the server-rendered HTML: every product page embeds `Product` and `BreadcrumbList` JSON-LD (plus site-wide `Organization`) — no JavaScript needed. Prefer JSON-LD over scraping visible text (the HTML payload embeds the full i18n message catalogue, so raw text matching misleads).
- **No agent checkout API.** Purchases require a human completing the web checkout. Respect `robots.txt`; session surfaces (`/cart`, `/checkout`, `/account`) are not crawlable. Crawl politely and back off on 429/5xx.