🏯 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. ```json { "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" } ] }