📦 marketing — 技能工具

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

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

Content Frameworks

Framework Selection Guide

Choose based on product type and brand personality:

Product Type	Recommended Framework	Reference
Fashion/Beauty	Aesthetic + Lifestyle	FASHION.md
Tech/Gadgets	Feature-First + Demo	TECH.md
Food/Beverage	Sensory + Lifestyle	LIFESTYLE.md
Home/Decor	Transformation + Tips	HOME.md
Services	Trust + Results	SERVICE.md

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 

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

• Scrape the product page via the scraping capability
• 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:

• Visit product URL
• Identify: name, price, features, benefits
• Note brand visual style
• 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 5. 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

• Consistency First

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

• Quality Over Quantity

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

• 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

• Teaser (2-3 days before)

- Build anticipation - "Something big coming"

• Launch (Day 1)

- Product reveal - Key features

• Deep Dive (Day 2-3)

- Benefits, use cases - Social proof

• 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