Recipe Web Searcher

public.recipe_ingredients

Lưu nguyên liệu theo recipe:

• recipe_id, name, normalized_name
• quantity, unit, optional, sort_order

public.recipe_steps

Lưu các bước nấu:

• recipe_id, step_number, instruction, estimated_minutes

Không có cột ingredients hay instructions trực tiếp trong bảng recipes.

Quy trình thực hiện

Bước 1 — Làm rõ yêu cầu

Thu thập:

• Tên món/từ khóa (bắt buộc)
• Ẩm thực/vùng miền (tùy chọn)
• Ràng buộc (chay, ít calo, dị ứng...) (tùy chọn)
• Số kết quả mong muốn (mặc định 3)

Bước 2 — Tìm kiếm

Query gợi ý:

"{tên món} recipe"
"{tên món} công thức nấu ăn"
"{tên món} {ẩm thực} recipe ingredients instructions"

Fallback:

"best {tên món} recipe site:cookpad.com OR site:dienmayxanh.com OR site:allrecipes.com"

Nguồn ưu tiên: cookpad, dienmayxanh/vao-bep, cooky, allrecipes, serious eats, budgetbytes.

Bước 3 — Fetch và trích lọc

Mỗi candidate cần cố gắng trích các field:

• title (required)
• description (optional)
• ingredients (required)
• steps (required)
• prepTimeMinutes (optional)
• cookTimeMinutes (optional)
• servings (optional)
• sourceUrl (required)
• imageUrl (optional)
• tags (optional)

Bước 4 — Chuẩn hoá payload

Payload trao cho orchestrator nên theo format app-level (camelCase):

{
  "title": "Phở bò Hà Nội",
  "description": "Công thức phở bò truyền thống",
  "sourceUrl": "https://example.com/pho-bo",
  "imageUrl": "https://example.com/pho-bo.jpg",
  "cookTimeMinutes": 240,
  "prepTimeMinutes": 30,
  "servings": 6,
  "difficulty": "medium",
  "visibility": "private",
  "source": "user",
  "tags": ["món việt", "món nước", "thịt bò"],
  "ingredients": [
    { "name": "xương bò", "quantity": 1.5, "unit": "kg", "optional": false },
    { "name": "gừng", "quantity": 1, "unit": "nhánh", "optional": false }
  ],
  "steps": [
    { "instruction": "Chần xương bò", "estimatedMinutes": 15 },
    { "instruction": "Ninh nước dùng", "estimatedMinutes": 180 }
  ]
}

Rules:

• sourceUrl phải là URL gốc bài công thức.
• ingredients[].name bắt buộc, giữ thứ tự xuất hiện.
• steps[].instruction bắt buộc, giữ thứ tự bước.
• difficulty nếu không chắc: dùng easy.
• tags luôn là tiếng Việt, viết thường, không trộn tiếng Anh.
• Nếu nguồn gốc dùng tag tiếng Anh thì phải dịch nghĩa sang tiếng Việt trước khi lưu.
• Ưu tiên tag ngắn, rõ nghĩa theo ngữ cảnh món ăn (ví dụ: món nước, chiên, hải sản, ăn sáng).
• Không bịa dữ liệu khi nguồn không có.

Bước 5 — Xác nhận user trước khi lưu

Luôn tóm tắt:

📋 Công thức: {title}
🔗 Nguồn: {sourceUrl}
🥬 Nguyên liệu: {n} mục
🧾 Các bước: {m} bước
⏱️ Thời gian: chuẩn bị {prepTimeMinutes} phút, nấu {cookTimeMinutes} phút
🍽️ Khẩu phần: {servings}

Hỏi rõ: “Bạn muốn lưu công thức này vào hệ thống không?”

Bước 6 — Delegate cho orchestrator

Khi user đồng ý, chuyển payload cho openclaw-food-system-orchestrator với yêu cầu ghi multi-table:

1. Insert recipes.
2. Insert recipe_ingredients theo recipe_id vừa tạo.
3. Insert recipe_steps theo recipe_id vừa tạo.

Kèm nhắc orchestrator:

• Dùng source_url từ payload sourceUrl.
• Dùng apply_migration nếu phải đổi schema.
• Dùng execute_sql cho DML.

Error Handling