generate_post_ideas

Instructions

Implementation Reference

• src/social-media.ts:357-407 (handler)

  Core handler function that generates creative social media post ideas based on provided theme and products list. Uses templates for seasonal and product-focused content.

  generatePostIdeas(theme: string, products: string[]): string[] {
    const ideas: string[] = [];
  
    // Seasonal/theme-based ideas
    const seasonalTemplates = {
      'fall': [
        `🍂 Fall into creativity! Our ${products[0]} are perfect for capturing autumn's warm colors. What's your favorite season to paint?`,
        `Cozy up with some art this fall! ✨ Check out our ${products[0]} - perfect for your next masterpiece.`,
        `Fall art vibes 🎨 Featuring: ${products.join(', ')}. Come visit us and get inspired!`
      ],
      'winter': [
        `❄️ Winter creativity is in the air! Stay warm and paint with our ${products[0]}.`,
        `Snowy days call for indoor art projects! ☃️ We've got everything you need including ${products.join(' and ')}.`
      ],
      'spring': [
        `🌸 Spring into art! Fresh new ${products[0]} just arrived. Perfect for capturing the season's vibrant colors!`,
        `Bloom where you're planted 🌷 Create something beautiful with our ${products.join(', ')}.`
      ],
      'summer': [
        `☀️ Summer art fun! Beat the heat with a creative project using our ${products[0]}.`,
        `Sunshine and art supplies ☀️ The perfect summer combo! Featuring ${products.join(' and ')}.`
      ]
    };
  
    // Product-focused ideas
    const productTemplates = [
      `✨ New arrival alert! ${products[0]} now in stock. Limited quantities available!`,
      `Artist spotlight: ${products[0]} 🎨 Perfect for ${this.getProductUseCase(products[0])}. In store now!`,
      `Did you know? Our ${products[0]} are customer favorites! ⭐ Stop by and see why everyone loves them.`,
      `Weekend project idea: Try ${products[0]} for your next creation! 🖌️ Tag us in your finished work!`,
      `Behind the counter: We love our ${products[0]}! 💙 What's your go-to art supply?`
    ];
  
    // Engagement ideas
    const engagementTemplates = [
      `💭 Question for our creative community: What's your favorite medium to work with? (We love ${products[0]}!)`,
      `🎨 Share your progress! Drop a photo of what you're working on in the comments. Need supplies? We've got ${products.join(', ')} and more!`,
      `⭐ Customer appreciation post! Thank you for supporting our small business. Come see what's new - ${products[0]} just restocked!`
    ];
  
    // Select appropriate ideas based on theme
    const themeKey = theme.toLowerCase();
    if (themeKey in seasonalTemplates) {
      ideas.push(...(seasonalTemplates as any)[themeKey]);
    } else {
      ideas.push(...productTemplates.slice(0, 3));
    }
  
    ideas.push(...engagementTemplates.slice(0, 2));
  
    return ideas.slice(0, 5);

• src/index.ts:377-388 (schema)

  Tool schema definition including input schema with parameters theme (string, required), products (string, required), and optional count (number).

    name: 'generate_post_ideas',
    description: 'Generate creative post ideas based on products, themes, or seasons. Perfect for content planning.',
    inputSchema: {
      type: 'object',
      properties: {
        theme: { type: 'string', description: 'Theme or season: fall, winter, spring, summer, sale, new_arrival, etc.' },
        products: { type: 'string', description: 'Comma-separated product names to feature' },
        count: { type: 'number', description: 'Number of ideas to generate (default: 5)' },
      },
      required: ['theme', 'products'],
    },
  },

• src/index.ts:1141-1157 (registration)

  Registration and execution handler in the MCP server's CallToolRequestSchema switch statement. Parses arguments, calls the socialMediaManager.generatePostIdeas, formats and returns the result as MCP content.

  case 'generate_post_ideas': {
    const theme = String(args?.theme || '');
    const productsArg = String(args?.products || '');
    const count = Number(args?.count || 5);
    
    const products = productsArg.split(',').map(p => p.trim());
    const ideas = socialMediaManager.generatePostIdeas(theme, products);
  
    return {
      content: [{
        type: 'text',
        text: `💡 Post Ideas - ${theme}\n\n${ideas.slice(0, count).map((idea, i) =>
          `${i + 1}. ${idea}`
        ).join('\n\n')}\n\n✨ Pro tip: Customize these ideas with your store's personality and current promotions!`
      }]
    };
  }

• src/social-media.ts:450-470 (helper)

  Private helper method used by generatePostIdeas to map product names to descriptive use cases for more engaging post copy.

  private getProductUseCase(product: string): string {
    const useCases: { [key: string]: string } = {
      'paint': 'both beginners and professionals',
      'brush': 'detailed work and bold strokes',
      'canvas': 'your next masterpiece',
      'pencil': 'sketching and drawing',
      'watercolor': 'beautiful transparent effects',
      'acrylic': 'vibrant, versatile painting',
      'oil': 'rich, blendable colors',
      'easel': 'studio or plein air painting'
    };
  
    const lowerProduct = product.toLowerCase();
    for (const [key, useCase] of Object.entries(useCases)) {
      if (lowerProduct.includes(key)) {
        return useCase;
      }
    }
  
    return 'all your creative projects';
  }