{
  "schema_version": "1.0",
  "name": "Trang Vàng Doanh Nghiệp",
  "description": "Danh bạ doanh nghiệp Việt Nam: tìm theo tên hoặc mã số thuế (MST), hồ sơ công ty, AI Score. Đọc danh bạ công khai không cần key; dữ liệu riêng của doanh nghiệp cần key tv_ak_.",
  "url": "https://trangvangdoanhnghiep.vn",
  "base_url": "https://trangvangdoanhnghiep.vn/api/agent/v1",
  "docs": "https://trangvangdoanhnghiep.vn/api/agent/v1/docs",
  "openapi": "https://trangvangdoanhnghiep.vn/api/agent/v1/openapi.json",
  "mcp": { "url": "https://trangvangdoanhnghiep.vn/api/agent/mcp", "transport": "streamable-http" },
  "llms_txt": "https://trangvangdoanhnghiep.vn/llms.txt",
  "auth": {
    "type": "api_key",
    "header": "Authorization: Bearer <key>",
    "alt_header": "X-API-Key",
    "key_prefix": "tv_ak_",
    "required_for": ["agent:read", "agent:write"],
    "optional_for": ["public"],
    "get_key": "https://trangvangdoanhnghiep.vn/settings?tab=ai-connect",
    "note": "Key do người dùng tạo ở Thiết lập → Kết nối AI. Không xin mật khẩu."
  },
  "scopes": {
    "public": "Đọc danh bạ (không cần key)",
    "agent:read": "Đọc hồ sơ và đề xuất của doanh nghiệp gắn với key",
    "agent:write": "Gửi đề xuất sửa hồ sơ (dry_run + Idempotency-Key)"
  },
  "rate_limits": { "public": "2 requests/second per IP (burst 20)", "key": "120 requests/minute per key" },
  "first_calls": ["GET /me", "GET /overview"],
  "contact": "https://trangvangdoanhnghiep.vn/lien-he"
}