🌿 iHerb Product Advisor

Want iHerb picks that match a real shopping context — not just another product dump? This actor turns a short wellness brief into ranked live iHerb recommendations with reasons.

Describe what you need (budget, form, preferences). The actor finds matching products on iHerb and returns a shortlist. Not medical advice.

💡 Perfect for...

• Shoppers: Turn “sinus season, vegan capsules under $30” into concrete product links.
• Health-tech / apps: Offer grounded iHerb suggestions from user context.
• 🤖 AI Agents: One structured input → ranked products with reasons.
• 🔗 Workflows: Pipe recommendations into n8n, Make, LangChain, CrewAI, etc.

✨ Why you'll love this scraper

• 🧠 Context → recommendations: Plain-language need in, ranked products out.
• 🛒 Live iHerb data: Suggestions come from real search / Health Topic listings (not invented SKUs).
• 🎯 Preferences-aware: Budget, capsules vs gummies, brand likes/dislikes, avoid-lists.
• ⚠️ Safety framing: Built-in disclaimer; wellness shopping aid only.

📦 What's inside the data?

Each run pushes:

1. run_meta — planned queries/topics, counts, disclaimer
2. recommendation rows — ranked products with reasons

Recommendation fields:

• Rank / fit: rank, match_score, reason, cautions
• Product: product_id, part_number, name, brand, price_usd, url, in_stock
• Provenance: source_query, type

🚀 Quick start

1. Write a context (what you need).
2. Optionally add preferences and set max_items.
3. Click Start — export CSV/JSON when done.

---

Tech details for developers 🧑‍💻

How it works

1. Interprets your context into iHerb search queries + Health Topic categories
2. Scrapes live listings
3. Ranks a shortlist from those candidates only (so product IDs stay real)

Inputs

Field	Description
context	Wellness shopping need (required)
preferences	Optional constraints
max_items	How many recommendations to return (default 5, max 30)

Input Example:

{
  "context": "Seasonal allergy sinus pressure; prefer vegan capsules under $30",
  "preferences": "Avoid melatonin; like California Gold Nutrition if possible",
  "max_items": 5
}

Output Example (recommendation row):

{
  "type": "recommendation",
  "rank": 1,
  "match_score": 88,
  "reason": "Sinus-oriented herbal capsule formula that fits a vegan capsule preference and typical allergy-season shopping intent.",
  "cautions": "Not a substitute for medical care if symptoms are severe or persistent.",
  "product_id": "49438",
  "name": "Redd Remedies, Adult Sinus Support™, 72 Vegan Capsules",
  "brand": "Redd Remedies",
  "price_usd": 37.97,
  "url": "https://www.iherb.com/pr/redd-remedies-adult-sinus-support-72-vegan-capsules/49438",
  "in_stock": true
}

Disclaimer: Supplements are not medicines. This actor does not diagnose, treat, or prescribe. Check labels, allergens, and interactions yourself or with a clinician.