bewinxed/agent-skills/snoonu-com

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