Etsy SEO Generator

Instructions

Implementation Reference

• mcp-server.js:422-472 (handler)

  The core handler function `generateEtsySEO` that validates credentials, constructs a signed payload, calls the Seerxo API, and returns the generated Etsy SEO content (title, description, tags, suggested price, usage).

  async function generateEtsySEO(productName, category = '') {
    if (!userEmail) {
      throw new Error('Email is not set. Run "seerxo configure" first.');
    }
    if (!apiKeyHeader || !apiKeySecret) {
      throw new Error('API key is not set. Run "seerxo configure" first.');
    }
  
    try {
      const payload = {
        product_name: productName,
        category: category || '',
        email: userEmail,
      };
  
      const { signature, timestamp } = generateSignature(payload);
  
      const response = await fetch(getApiEndpoint(), {
        method: 'POST',
        headers: {
          'Content-Type': 'application/json',
          'User-Agent': `seerxo/${clientVersion}`,
          'X-MCP-Signature': signature,
          'X-MCP-Timestamp': timestamp.toString(),
          'X-MCP-Version': clientVersion,
          'X-MCP-API-Key': apiKeyHeader,
        },
        body: JSON.stringify(payload),
      });
  
      if (!response.ok) {
        const error = await response.json().catch(() => ({}));
        throw new Error(
          error.error || error.message || `API error: ${response.status}`
        );
      }
  
      const data = await response.json();
  
      if (!data.success) {
        throw new Error(data.error || 'Content generation failed');
      }
  
      return {
        ...data.data,
        usage: data.usage,
      };
    } catch (error) {
      throw new Error(error.message || 'Failed to generate Etsy SEO content');
    }
  }

• mcp-server.js:832-845 (schema)

  Input schema for the tool defining required 'product_name' (string) and optional 'category' (string).

  inputSchema: {
    type: 'object',
    properties: {
      product_name: {
        type: 'string',
        description: 'Name of the product to optimize.',
      },
      category: {
        type: 'string',
        description: 'Optional category (e.g., "Home & Living")',
      },
    },
    required: ['product_name'],
  },

• mcp-server.js:823-851 (registration)

  Registration of the tool in the MCP 'tools/list' RPC method response, including name, description, and input schema.

  } else if (request.method === 'tools/list') {
    const response = {
      jsonrpc: '2.0',
      id: request.id,
      result: {
        tools: [
          {
            name: 'generate_etsy_seo',
            description: 'Generate SEO-optimized Etsy product listings.',
            inputSchema: {
              type: 'object',
              properties: {
                product_name: {
                  type: 'string',
                  description: 'Name of the product to optimize.',
                },
                category: {
                  type: 'string',
                  description: 'Optional category (e.g., "Home & Living")',
                },
              },
              required: ['product_name'],
            },
          },
        ],
      },
    };
  
    console.log(JSON.stringify(response));

• mcp-server.js:852-883 (registration)

  MCP 'tools/call' handler that checks the tool name 'generate_etsy_seo', invokes the handler, formats the result as rich text content with usage info, and responds.

  } else if (request.method === 'tools/call') {
    const { name, arguments: toolArgs } = request.params;
  
    if (name === 'generate_etsy_seo') {
      const result = await generateEtsySEO(
        toolArgs.product_name,
        toolArgs.category || ''
      );
  
      const usageInfo = result.usage
        ? `\n\n---\n**Usage:** ${result.usage.current}/${result.usage.limit} generations used (${result.usage.remaining} remaining)`
        : '';
  
      const response = {
        jsonrpc: '2.0',
        id: request.id,
        result: {
          content: [
            {
              type: 'text',
              text: `# Etsy SEO Results for "${toolArgs.product_name}"\n\n## 📝 SEO Title\n${result.title}\n\n## 📄 Product Description\n${result.description}\n\n## 🏷️ Tags (15)\n${result.tags.join(
                ', '
              )}\n\n## 💰 Suggested Price\n${
                result.suggested_price_range
              }${usageInfo}`,
            },
          ],
        },
      };
  
      console.log(JSON.stringify(response));
    } else {

• mcp-server.js:412-420 (helper)

  Helper function that generates the HMAC-SHA256 signature and timestamp for authenticating API requests using the API key secret.

  function generateSignature(payload) {
    const timestamp = Date.now().toString();
    const message = JSON.stringify(payload) + timestamp;
    const signature = crypto
      .createHmac('sha256', apiKeySecret || '')
      .update(message)
      .digest('hex');
    return { signature, timestamp };
  }