version: "1.0.0" name: snoonu description: Add grocery items to cart via Snoonu delivery platform in Qatar. Use when user wants to order groceries from Monoprix, Lulu, or other Snoonu stores. Searches products, selects best matches, and adds to cart via browser automation. allowed-tools: Read, Bash, mcp__playwriter__execute, mcp__playwriter__reset

Snoonu Grocery Shopping

Add items to cart from Snoonu (Qatar's delivery platform) using browser automation.

Quick Start

1. Open Snoonu store in browser (e.g., https://snoonu.com/groceries/monoprix)
2. Search via API to get product candidates with IDs/names/prices
3. Agent reviews results - pick exact match, not first result
4. Add via UI click - navigate to product, click Add button

Store IDs

Workflow

Step 1: Search for Products

Use the search API to get candidates:

// In Playwriter - search via page context
const results = await page.evaluate(async (term) => {
  const res = await fetch('https://admin.snoonu.com/api/search/suggest_in_merchant_with_subcategory', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ term, language: 'en', menu_id: 504231 })
  });
  const data = await res.json();
  return data.data?.product_view_models?.slice(0, 5).map(p => ({
    id: p.product_id,
    name: p.name,
    price: p.price,
    inStock: p.is_instock
  }));
}, 'red onion');

Step 2: Select Best Product

Review results and pick the exact match:

See [selection-guide.md](selection-guide.md) for detailed criteria.

Step 3: Add to Cart

Navigate and click Add button via JS (avoids timeouts):

// Search in store UI
await page.locator('input[placeholder*="Search"]').fill('melon rock 1kg');
await page.locator('input[placeholder*="Search"]').press('Enter');
await page.waitForTimeout(2000);
// Click exact product
await page.locator('text="Melon Rock 1Kg"').first().click();
await page.waitForTimeout(1000);
// Add via JS click
await page.evaluate(() => {
  const btn = Array.from(document.querySelectorAll('button'))
    .find(b => b.textContent?.trim() === 'Add');
  if (btn) btn.click();
});

Key Principles

• Agent selects items - Don't use algorithms, review results yourself
• Be specific - Search "baladna greek yoghurt" not "yoghurt"
• UI automation works - API cart sync has session issues
• JS clicks - Use page.evaluate() to avoid Playwright timeouts

Reference Files

• api-reference.md - Full API endpoints and headers
• selection-guide.md - Product selection criteria
• automation.md - Complete UI automation patterns

Common Items