Instagram Marketing Generator

Overview

Transform any product URL into scroll-stopping Instagram content. Extract product details via SkillBoss API Hub, analyze brand positioning, and generate platform-native marketing assets that drive engagement and conversions.

Quick Start

1. Input: Provide product URL
2. Extract: Use scripts/extract_product.py to fetch product details via SkillBoss API Hub (requires SKILLBOSS_API_KEY)
3. Generate: Apply Instagram content frameworks from references/
4. Deliver: Output ready-to-post content package

Content Frameworks

Framework Selection Guide

Choose based on product type and brand personality:

Core Content Elements

Every Instagram post package includes:

1. Image/Video Brief

• Visual style (aesthetic direction)
• Composition guidelines
• Text overlay suggestions (optional)
• Product angle recommendations
• Background/props guidance

2. Caption Structure

HOOK → [First line - stops the scroll]
  |
  ├── BODY → [Value proposition, benefits, story]
  |
  └── CTA → [Clear action: link, DM, save, share]

Caption Length Guide:

• Feed posts: 138-150 characters (optimal engagement)
• Carousel: 150-200 characters
• Educational: Up to 300 characters

3. Hashtag Strategy (30 max)

• 3-5 branded/niche tags (high relevance)
• 10-15 trend tags (moderate volume)
• 5-10 broad tags (max reach)
• Mix of: #branded #descriptive #trend #location #emotion

See references/HASHTAG_STRATEGY.md for detailed hashtag optimization.

Product Information Extraction

Script Usage

SKILLBOSS_API_KEY=your_key python3 scripts/extract_product.py \x3Curl>

The script uses SkillBoss API Hub (https://api.heybossai.com/v1/pilot) to:

1. Scrape the product page via the scraping capability
2. Extract structured product data via the chat capability (auto-routed LLM)

Extracted fields:

• Product name
• Price/value proposition
• Key features (3-5)
• Target audience
• Unique selling proposition
• Platform (Amazon/Shopify/Taobao/JD/Generic)
• Suggested content type

Manual Extraction Fallback

If script fails, extract manually:

1. Visit product URL
2. Identify: name, price, features, benefits
3. Note brand visual style
4. Capture 3-5 product angles

Content Generation Workflow

Step 1: Analyze Product & Audience

PRODUCT → [What is it? What problem does it solve?]
  |
  ├── TARGET AUDIENCE → [Who needs this? Why?]
  |
  ├── BRAND TONE → [Luxury? Playful? Minimal? Bold?]
  |
  └── PLATFORM FIT → [Feed post, Story, Reel, Carousel?]

Key Questions:

• What emotion should the user feel?
• What's the "scroll-stopping" moment?
• What's the post-purchase transformation?

Step 2: Choose Content Format

Feed Post (Single Image)

• Best for: Product showcases, announcements
• Visual: High-quality product shot, clean background
• Caption: Punchy hook + benefits + CTA

Carousel (Swipe-able)

• Best for: Features, tutorials, transformations
• Structure: 5-10 slides
  1. Hook slide 2-4. Feature/benefit slides
  2. CTA slide

Story (15-60 sec)

• Best for: Flash sales, polls, Q&A, behind-scenes
• Elements: Interactive stickers, tap-through links

Reel (15-90 sec video)

• Best for: Demos, unboxing, transformations
• Hook: First 1 second critical
• Music: Trending audio boost

Step 3: Generate Content Package

Output format (see templates/OUTPUT_TEMPLATE.md):

## Instagram Content Package

### Post Type: [Feed/Carousel/Story/Reel]

### Image/Video Brief
[Visual direction + composition]

### Caption
[Hook + Body + CTA]

### Hashtags
[30 optimized hashtags]

### Posting Strategy
[Time, frequency, cross-post suggestions]

Instagram Style Guidelines

Visual Principles

1. Consistency First

   • Cohesive color palette (3-5 colors max)
   • Consistent filter/preset
   • Recognizable brand aesthetic

2. Quality Over Quantity

   • High-resolution images (1080x1080 or 1080x1350)
   • Good lighting (natural preferred)
   • Clean composition (rule of thirds)

3. Native Feel

   • Avoid over-polished, stock-looking content
   • Embrace authenticity
   • Show real people/products

Caption Best Practices

✅ DO:

• Start with a hook (question, bold statement, emotion)
• Write conversationally (like talking to a friend)
• Use line breaks for readability
• Include clear CTA
• Add 3-5 relevant hashtags

❌ DON'T:

• Write paragraphs longer than 3 lines
• Use excessive emojis (1-3 max)
• Overuse hashtags (30 max, quality > quantity)
• Sound robotic or overly promotional
• Include "link in bio" more than once

Engagement Triggers

Embed these in content:

• Questions: "Which color would you choose?"
• Opinions: "Yes or No?"
• Saves: "Save this for later"
• Shares: "Tag someone who needs this"
• CTAs: "Link in bio to shop"

Content Templates

Template 1: Problem-Solution

Hook: Tired of [problem]?
Body: Meet [product]. It [benefit 1], [benefit 2], and [benefit 3].
CTA: Shop now → link in bio

Template 2: Transformation

Hook: Before → After
Body: How [product] transformed [situation].
CTA: See the difference → link in bio

Template 3: Social Proof

Hook: ⭐⭐⭐⭐⭐ "Review quote"
Body: Join [number]+ happy customers.
CTA: Try it risk-free → link in bio

Template 4: Educational

Hook: 5 things you didn't know about [product/category]
Body: [Value-packed tips]
CTA: Save this post + follow for more

Template 5: Limited Time

Hook: 🚨 Only [number] left!
Body: [Product] at [price] for [timeframe].
CTA: Don't miss out → link in bio

Advanced: Multi-Post Series

For product launches or campaigns, create 3-5 post series:

Series Structure

1. Teaser (2-3 days before)

   • Build anticipation
   • "Something big coming"

2. Launch (Day 1)

   • Product reveal
   • Key features

3. Deep Dive (Day 2-3)

   • Benefits, use cases
   • Social proof

4. Urgency (Day 4-5)

   • Limited availability
   • Last chance

See references/CAMPAIGN_STRATEGY.md for complete campaign planning.

References

Detailed Guides

• references/FASHION.md - Fashion & beauty content
• references/TECH.md - Tech & gadgets content
• references/HASHTAG_STRATEGY.md - Hashtag optimization
• references/CAMPAIGN_STRATEGY.md - Multi-post campaigns
• references/ENGAGEMENT_TACTICS.md - Comment management & growth

Templates

• templates/CAROUSEL_TEMPLATE.md - Swipe-able post structure
• templates/STORY_TEMPLATE.md - Interactive story framework
• templates/REEL_TEMPLATE.md - Video script structure
• templates/OUTPUT_TEMPLATE.md - Final content format

Tips

• Always match content to brand voice
• Test different hook styles
• Analyze competitor posts for inspiration
• Repurpose content across formats (feed → story → reel)
• Save high-performing posts as templates
• Time posts for peak audience hours
• Engage with comments within 1 hour
• Use Instagram Insights to optimize