Kizuna - AI Marketing Partner for Small Businesses

postman notebook - https://www.postman.com/csnqwerty/notebook/xLYmRK3waV6o/kizuna-postman-hackathon-postman-flows-actions

Inspiration

Small businesses often struggle to maintain a consistent brand identity across their marketing materials due to lack of time, budget, and design expertise. We wanted to create a tool that acts as an intelligent creative partner, instantly understanding a brand's unique "DNA" and generating on-brand marketing assets automatically.

What it does

Kizuna is an AI-powered marketing tool that helps small businesses create on-brand social media campaigns and marketing assets quickly.

Key Functionality:

• Instant Brand Analysis: Users simply enter their website URL, and Kizuna analyzes the "Brand DNA" — including brand values, aesthetics, tone of voice, and business overview.
• Asset Extraction: It automatically extracts key brand assets like logos, color palettes, and fonts directly from the website.
• Campaign Generation: Using the established Brand DNA, Kizuna generates tailored marketing campaigns and creative assets that look and sound exactly like the brand.

How we built it

We built Kizuna using a modern tech stack focused on speed and AI integration:

• Frontend: Next.js for a responsive and dynamic user interface.
• AI Analysis: Google Gemini for deep semantic understanding of website content and image analysis.
• Content Management: Sanity is the backbone of our content infrastructure. We use Sanity to structure and store:
  • Business Profiles: Storing the analyzed Brand DNA, colors, and fonts.
  • Campaigns & Creatives: Managing the generated marketing assets and their versions.
  • Sanity Schemas: We defined custom schemas for business, campaign, creative, and textStyle to ensure structured and queryable data. This allows us to maintain a "Single Source of Truth" for every business's brand identity.
• Postman Workflow: We leveraged Postman Flows to orchestrate complex API interactions for brand analysis.
  • Font Analysis Flow: A dedicated flow that processes font URLs and text DOM to identify brand-specific typography.
  • Logo Analysis Flow: A flow designed to extract and validate the main brand logo from page metadata.
  • Color Palette Flow: A flow that analyzes screenshots to extract the dominant color palette.
  • Note: We used Postman to visually map out these logic flows and integrate them as API endpoints.

Challenges we ran into

• Postman Workflow Actions: Figuring out the correct actions and data passing within Postman Flows was a learning curve, especially ensuring the inputs matched exactly what the flow expected.
• Sanity Integration: We hit a last-minute bug with our Sanity schema definitions (admittedly our fault!) that caused some data to not persist correctly, but we managed to debug and fix it just in time.
• CORS Issues: We faced significant CORS (Cross-Origin Resource Sharing) errors when trying to fetch resources from analyzed websites, requiring us to implement robust proxy handling.

Accomplishments that we're proud of

• Successfully integrating Postman Flows to handle specific parts of our backend logic visually.
• Building a robust Sanity schema that effectively models a brand's entire identity, making it reusable for future campaigns.
• The "Magic" moment when the AI correctly identifies a brand's abstract values and tone just from scanning their landing page.

What we learned

• Structured Content is King: Using Sanity taught us the importance of defining clear content models early on. It made connecting our AI outputs to our frontend UI seamless.
• Visual API Design: Working with Postman Flows showed us a new way to think about API logic—visually chaining steps rather than just writing code.
• AI Context: Providing the right context (like screenshots + DOM structure) is crucial for getting accurate results from LLMs like Gemini.

What's next for Kizuna

• Expanding the "Brand DNA" analysis to include social media profiles.
• Adding a "Brand Editor" to allow users to fine-tune their analyzed identity in Sanity Studio.
• Direct integration with social platforms for one-click publishing of generated campaigns.

Built With

• postman
• python
• react
• sanity
• typescript