Build an AI Instagram Content Generator: 5-Agent System with Code

You are a Lead Market Analyst at a premier digital marketing firm. 

You specialize in dissecting online business landscapes and identifying 
market opportunities. Your goal is to conduct comprehensive analysis of 
products and competitors, providing in-depth insights to guide marketing 
strategies.

Given a product website and details, analyze:

1. Unique features and benefits
2. Market positioning and appeal
3. Key selling points
4. Competitive advantages
5. Recommendations for enhancement

Focus on details that will inform marketing strategy. Current year: 2025.

You are the Chief Marketing Strategist at a leading digital marketing 
agency, known for crafting bespoke strategies that drive success. 
Your goal is to synthesize insights from product analysis to formulate 
innovative marketing strategies.

Based on market analysis, create:

1. Target audience profile
2. Campaign themes and angles
3. Messaging strategy
4. Content direction for social media
5. Competitive differentiation approach

Your strategy should resonate with the target audience and leverage 
product strengths against competitors.

You are a Creative Content Creator at a top-tier digital marketing agency. 
You excel in crafting narratives that resonate with audiences on social media. 
Your expertise lies in turning marketing strategies into engaging stories that 
capture attention and inspire action.

Create Instagram ad copy that is:

- Punchy and captivating
- Concise (appropriate for Instagram)
- Aligned with marketing strategy
- Highlighting unique selling points
- Action-oriented (encourages engagement)

Deliver 3 variations of ad copy that inform, excite, and persuade.

You are a Senior Photographer at a leading digital marketing agency. 
You are an expert at conceptualizing photographs that inspire and engage. 
Your goal is to create detailed descriptions of photographs that capture 
emotions and convey compelling messages for Instagram ads.

Given the ad copy and product details, imagine and describe the perfect 
photograph. Focus on:

- Emotional impact
- Visual composition
- Lighting and atmosphere
- Subject positioning
- Technical specifications (4k, wide shot, close-up, etc.)

Important: Create evocative imagery that suggests the product's benefits 
without showing the actual product directly.

Example descriptions:

- "A sunlit mountain peak at golden hour, with a lone adventurer standing 
  triumphantly on the summit, arms raised, backlit by warm orange rays, 
  professional wide shot, 4k, crisp details"

- "Close-up of hands typing on a laptop in a cozy coffee shop, soft natural 
  window light, shallow depth of field with blurred background conversations, 
  warm color grading, 4k, professional photography"

Provide 3 distinct photograph concepts, each with a detailed paragraph description.

You are the Chief Creative Director of a leading digital marketing agency 
specialized in product branding. Your role is to oversee your team's work 
to ensure it's the best possible and aligned with product goals.

Review the photograph concepts from your team. Evaluate:

1. Alignment with brand strategy
2. Emotional impact and engagement potential
3. Technical quality of the concept
4. Instagram platform suitability
5. Differentiation from competitors

You can:

- Approve concepts that meet standards
- Request clarifications or modifications
- Delegate follow-up work for improvements
- Provide specific feedback for refinement

Deliver 3 final approved photograph descriptions that are publication-ready.

class BrowserTools:

    @staticmethod
    def scrape_and_summarize_website(website_url):
        """
        Scrape a website and return a summarized version of its content
        
        Steps:
        1. Fetch the webpage HTML (using requests or browser automation)
        2. Parse HTML content (BeautifulSoup, Cheerio, etc.)
        3. Extract main content (remove navigation, ads, footers)
        4. Clean and structure the text
        5. Optionally: Use LLM to summarize lengthy content
        6. Return structured summary
        """
        # Implementation details
        pass

class SearchTools:

    @staticmethod
    def search_internet(query):
        """
        Perform a web search and return relevant results
        
        Steps:
        1. Call search API (SerpAPI, Google Custom Search, etc.)
        2. Parse search results
        3. Extract titles, URLs, snippets
        4. Optionally: Fetch and summarize top results
        5. Return structured search results
        """
        # Implementation details
        pass
    
    @staticmethod
    def search_instagram(query):
        """
        Search Instagram for trending content and hashtags
        
        Steps:
        1. Use Instagram API or unofficial methods
        2. Search for hashtags, profiles, or content
        3. Extract engagement metrics
        4. Identify trending topics
        5. Return insights about Instagram trends
        """
        # Implementation details
        pass

def create_product_analysis_task(product_website, product_details):
    return {
        "description": f"""
        Analyze the given product website: {product_website}
        Additional details: {product_details}
        
        Focus on identifying:

        - Unique features and benefits
        - Overall brand narrative
        - Key selling points
        - Market appeal factors
        - Positioning opportunities
        
        Your final report should clearly articulate the product's 
        strengths and provide suggestions for marketing positioning.
        Emphasize aspects that make the product stand out.
        
        Attention to detail is crucial for comprehensive analysis.
        """,
        "agent": "Lead Market Analyst",
        "expected_output": "Detailed product analysis report"
    }

def create_competitor_analysis_task(product_website, product_details):
    return {
        "description": f"""
        Research competitors of: {product_website}
        Additional details: {product_details}
        
        Identify the top 3-5 competitors and analyze:

        - Marketing strategies
        - Market positioning
        - Customer perception
        - Strengths and weaknesses
        - Content approaches
        
        Your final report MUST include:

        1. Complete context about {product_website}
        2. Detailed comparison with each competitor
        3. Opportunities for differentiation
        """,
        "agent": "Lead Market Analyst",
        "expected_output": "Comprehensive competitive analysis"
    }

def create_campaign_development_task(product_website, product_details):
    return {
        "description": f"""
        Create a targeted marketing campaign for: {product_website}
        Additional details: {product_details}
        
        Develop strategy and creative content ideas that:

        - Captivate and engage the target audience
        - Leverage product strengths
        - Differentiate from competitors
        - Align with Instagram best practices
        
        Your output will guide the creative team in content development.
        
        Provide:

        - Campaign theme and angle
        - Target audience insights
        - Messaging approach
        - Content direction
        - All relevant context about product and customer
        """,
        "agent": "Chief Marketing Strategist",
        "expected_output": "Complete campaign strategy document"
    }

def create_ad_copy_task():
    return {
        "description": """
        Craft engaging Instagram post copy based on the campaign strategy.
        
        The copy should be:

        - Punchy and captivating
        - Concise (optimal for Instagram)
        - Aligned with marketing strategy
        - Highlighting unique selling points
        - Action-oriented
        
        Focus on creating messages that resonate with the target audience.
        
        Your ad copy must:

        - Grab attention in the first line
        - Encourage action (visit, purchase, learn more)
        - Include relevant hashtags
        - Maintain brand voice
        
        Deliver 3 distinct variations of Instagram ad copy that inform, 
        excite, and persuade the audience.
        """,
        "agent": "Creative Content Creator",
        "expected_output": "3 Instagram ad copy variations"
    }

def create_photograph_task(ad_copy, product_website, product_details):
    return {
        "description": f"""
        Conceptualize the perfect photograph for this Instagram campaign.
        
        Ad copy context: {ad_copy}
        Product: {product_website}
        Details: {product_details}
        
        Imagine and describe the photograph in detail. Consider:

        - Emotional impact
        - Visual composition
        - Subject and setting
        - Lighting and atmosphere
        - Camera angle and framing
        - Technical specifications
        
        Important: Create evocative imagery that suggests the product's 
        value without showing the actual product directly.
        
        Examples of well-crafted descriptions:

        - "A modern workspace bathed in soft morning light, minimalist desk 
          with a single coffee cup, laptop barely visible, focus on the 
          peaceful productive atmosphere, shallow depth of field, warm tones, 
          4k, professional photography, wide shot"
          
        - "Close-up of weathered hands holding an old compass, background 
          blurred showing mountain peaks, golden hour lighting, sense of 
          adventure and guidance, 4k, crisp details, shallow depth of field"
        
        Provide 3 distinct photograph concepts with detailed paragraph 
        descriptions suitable for AI image generation or photographer briefing.
        """,
        "agent": "Senior Photographer",
        "expected_output": "3 detailed photograph concept descriptions"
    }

def create_photo_review_task(product_website, product_details):
    return {
        "description": f"""
        Review the photograph concepts from the Senior Photographer.
        
        Product: {product_website}
        Details: {product_details}
        
        Evaluate each concept for:

        - Alignment with brand and campaign goals
        - Emotional impact and engagement potential
        - Technical quality and feasibility
        - Instagram platform suitability
        - Differentiation from competitor content
        
        You can:

        - Approve concepts that meet high standards
        - Request clarifications or specific modifications
        - Delegate follow-up work for improvements
        - Provide actionable feedback
        
        Reference examples of quality descriptions:

        - "A modern workspace bathed in soft morning light..."
        - "Close-up of weathered hands holding an old compass..."
        
        Deliver 3 final approved photograph descriptions that are 
        ready for image generation or production.
        """,
        "agent": "Chief Creative Director",
        "expected_output": "3 approved final photograph descriptions"
    }

# Pseudo-code for orchestration logic
class InstagramContentWorkflow:

    def __init__(self, llm_provider, api_keys):
        self.llm = llm_provider
        self.agents = self.initialize_agents()
        self.tools = self.initialize_tools(api_keys)
        
    def initialize_agents(self):
        return {
            'market_analyst': self.create_agent(
                role='Lead Market Analyst',
                tools=['scrape_web', 'search_internet']
            ),
            'strategist': self.create_agent(
                role='Chief Marketing Strategist',
                tools=['scrape_web', 'search_internet', 'search_instagram']
            ),
            'creative': self.create_agent(
                role='Creative Content Creator',
                tools=['scrape_web', 'search_internet', 'search_instagram']
            ),
            'photographer': self.create_agent(
                role='Senior Photographer',
                tools=['scrape_web', 'search_internet', 'search_instagram']
            ),
            'director': self.create_agent(
                role='Chief Creative Director',
                tools=['scrape_web', 'search_internet', 'search_instagram'],
                allow_delegation=True
            )
        }
    
    def run(self, product_website, product_details):
        # CREW 1: Content Strategy Workflow
        print("Starting Content Strategy Workflow...")
        
        # Step 1: Market Analyst analyzes product
        product_analysis = self.execute_task(
            agent=self.agents['market_analyst'],
            task=create_product_analysis_task(product_website, product_details)
        )
        
        # Step 2: Market Analyst analyzes competitors
        competitor_analysis = self.execute_task(
            agent=self.agents['market_analyst'],
            task=create_competitor_analysis_task(product_website, product_details),
            context=[product_analysis]
        )
        
        # Step 3: Strategist develops campaign
        campaign_strategy = self.execute_task(
            agent=self.agents['strategist'],
            task=create_campaign_development_task(product_website, product_details),
            context=[product_analysis, competitor_analysis]
        )
        
        # Step 4: Creative writes ad copy
        ad_copy = self.execute_task(
            agent=self.agents['creative'],
            task=create_ad_copy_task(),
            context=[product_analysis, competitor_analysis, campaign_strategy]
        )
        
        print(f"Ad copy completed: {ad_copy}")
        
        # CREW 2: Visual Production Workflow
        print("Starting Visual Production Workflow...")
        
        # Step 5: Photographer conceptualizes photos
        photo_concepts = self.execute_task(
            agent=self.agents['photographer'],
            task=create_photograph_task(ad_copy, product_website, product_details),
            context=[ad_copy, campaign_strategy]
        )
        
        # Step 6: Director reviews and approves
        final_photos = self.execute_task(
            agent=self.agents['director'],
            task=create_photo_review_task(product_website, product_details),
            context=[photo_concepts, ad_copy, campaign_strategy]
        )
        
        return {
            'ad_copy': ad_copy,
            'photo_descriptions': final_photos,
            'strategy': campaign_strategy
        }
    
    def execute_task(self, agent, task, context=None):
        """Execute a single task with an agent"""
        # Build the prompt with task description and context
        prompt = self.build_prompt(task, context)
        
        # Allow agent to use tools as needed
        result = agent.execute(prompt, tools=agent.tools)
        
        return result

def main():
    print("=" * 50)
    print("Instagram Content Generator")
    print("=" * 50)
    
    # Gather user input
    product_website = input("\nProduct website URL: ")
    product_details = input("Additional details about your product/campaign: ")
    
    # Initialize workflow
    workflow = InstagramContentWorkflow(
        llm_provider=configure_llm(),
        api_keys=load_api_keys()
    )
    
    # Execute workflow
    print("\n🚀 Starting content generation...\n")
    results = workflow.run(product_website, product_details)
    
    # Display results
    print("\n" + "=" * 50)
    print("RESULTS")
    print("=" * 50)
    
    print("\n📝 Instagram Ad Copy Options:")
    print("-" * 50)
    print(results['ad_copy'])
    
    print("\n📸 Visual Concept Descriptions:")
    print("-" * 50)
    print(results['photo_descriptions'])
    
    print("\n✅ Content generation complete!")

# LLM Provider
OPENAI_API_KEY=your_openai_key_here
# OR for local models
OLLAMA_MODEL=llama3
OLLAMA_BASE_URL=http://localhost:11434

# Search APIs
SERP_API_KEY=your_serp_api_key
BROWSERLESS_API_KEY=your_browserless_key

# Optional: Instagram API
INSTAGRAM_API_KEY=your_instagram_key

import os
from dotenv import load_dotenv

def load_config():
    load_dotenv()
    
    return {
        'llm': {
            'provider': os.getenv('LLM_PROVIDER', 'openai'),
            'model': os.getenv('MODEL', 'gpt-4'),
            'api_key': os.getenv('OPENAI_API_KEY'),
            'temperature': float(os.getenv('TEMPERATURE', '0.7'))
        },
        'tools': {
            'serp_api_key': os.getenv('SERP_API_KEY'),
            'browserless_api_key': os.getenv('BROWSERLESS_API_KEY')
        }
    }

import asyncio

async def run_parallel_analysis(product_website, product_details):
    # Run product and competitor analysis simultaneously
    product_task = asyncio.create_task(
        analyze_product(product_website, product_details)
    )
    competitor_task = asyncio.create_task(
        analyze_competitors(product_website, product_details)
    )
    
    product_analysis, competitor_analysis = await asyncio.gather(
        product_task, competitor_task
    )
    
    return product_analysis, competitor_analysis

class ContextManager:
    def __init__(self, max_tokens=4000):
        self.max_tokens = max_tokens
        self.context_history = []
    
    def add_context(self, context_item):
        self.context_history.append(context_item)
    
    def get_relevant_context(self, task_type):
        # Implement logic to select most relevant context
        # based on task type and token limits
        relevant = self.filter_by_relevance(task_type)
        return self.truncate_to_fit(relevant, self.max_tokens)

def execute_with_retry(agent, task, max_retries=3):
    for attempt in range(max_retries):
        try:
            result = agent.execute(task)
            if validate_result(result):
                return result
        except Exception as e:
            if attempt == max_retries - 1:
                raise
            print(f"Retry {attempt + 1}/{max_retries} after error: {e}")
            time.sleep(2 ** attempt)  # Exponential backoff

def test_market_analyst():
    agent = create_market_analyst_agent()
    result = agent.execute(
        create_product_analysis_task(
            "https://example.com",
            "Test product details"
        )
    )
    assert len(result) > 100  # Ensure substantial output
    assert "unique features" in result.lower()

def test_full_workflow():
    workflow = InstagramContentWorkflow(llm_provider, api_keys)
    results = workflow.run(
        "https://testproduct.com",
        "A revolutionary new gadget"
    )
    
    assert 'ad_copy' in results
    assert 'photo_descriptions' in results
    assert len(results['ad_copy']) > 50