🏯 KURA: Context-aware Ads Agent

Turn Any User Mood into Shoppable Creatives.

"Kura (倉 / 蔵) means 'storehouse' in Japanese — a quiet repository where valuable things are kept."

Kura works invisibly in the background, acting as a storehouse of contextual logic. It organizes user scenarios, matches them with products, and generates high-quality ad creatives automatically.

---

🌟 The Mission: Context-Aware Ads

Every year, countless brilliant products fail—not because they're bad, but because their ads never reach the right people. Small companies burn budget on broad targeting; customers are overwhelmed by generic noise.

Kura was built to change that.

• For Consumers: Ads become enjoyable, serendipitous discoveries.
• For Startups: Customer acquisition becomes efficient and predictable.

We believe discovery shouldn't be a privilege. It should be a system anyone can access.

---

🎮 Live Produdct Demo: See Kura in Action

We built and hosted a Mock Search Engine to visualize the potential of this Actor. Imagine a user searching normally, but seamlessly discovering highly relevant Kura-generated ads mixed into the results.

👉 Try the Live Visualizer (apify-hack.vercel.app)

(Type anything like "south Californian style patio" or "home office" to see the ads appear)

Landing Page	Ads Result

---

🧭 What This Actor Does

Kura is an API-first creative engine that runs inside Apify. It transforms a simple text prompt (a mood, scenario, or vibe) into a fully structured, ready-to-run ad campaign.

It supports two powerful workflows:

1. 🔍 Context → Discovery (Platform Mode)

• Input: A mood/scenario (e.g., "User searching for random ideas").
• Process: Kura uses GPT-4o to brainstorm relevant products, searches Amazon to find the best matches, and uses Fal.ai to render them into the scene.
• Output: A list of curated products + highly relevant lifestyle ad images.

2. 🎨 Products → Creative Gen (Brand Mode)

• Input: A mood/scenario + Your specific Amazon Product URLs.
• Process: Kura skips the brainstorming, scrapes your exact product (extracting high-res images), and places your product into the new scenario.
• Output: Multiple variations of your product in the target context.

What This Actor Is For

1. Large Commerce & Retail Platforms
2. Adtech startup & Marketing Agency
3. Small, Mid-size & Independent E-commerce
4. Creator Commerce

---

🛠️ Technology Stack

This Actor is a "Glue Code" masterpiece, orchestrating top-tier AI models:

1. Brain: OpenAI GPT-4o (for semantic understanding and product recommendation).
2. Eyes: Amazon Search Scraper (for retrieving real-time product metadata and high-res white-background images).
3. Hands: Fal.ai (Nano Banana/Gemini) (for instruction-based image editing and seamless background synthesis).
4. Body: Apify Actor (for serverless execution and parallel processing).

---

📥 Input Parameters

Kura automatically detects your intent based on the input.

Field	Type	Description
Scenario / Mood	String	(Required) Describe the context, vibe, or user mood. Example: "Some living room decor idea." or "Cozy winter gaming night".
Amazon Product URLs	Array	(Optional) • Leave empty to let AI discover products for you. • Paste links to generate creatives for specific items.

---

📤 Output Structure

The Actor outputs a clean JSON dataset ready for your frontend or ad manager.

{
  "scenario_input": "A cozy Christmas living room",
  "mode_used": "GENERATED_IDEAS",
  "timestamp": "2025-12-06T20:10:00.000Z",
  "recommendations": [
    {
      "keyword_or_title": "Red Knitted Throw Blanket",
      "status": "success",
      "amazon": {
        "title": "Bourina Textured Throw Blanket...",
        "price": "$18.99",
        "url": "https://www.amazon.com/dp/B01N2Y6L...",
        "image": "https://m.media-amazon.com/images/I/81xQ-k-y-xL._AC_SL1500_.jpg"
      },
      "generated_image": "https://fal.media/files/monkey/generated-result.png"
    }
  ]
}