n8n-mcp/dist/mcp/tool-docs/templates/search-templates.js

"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
exports.searchTemplatesDoc = void 0;
exports.searchTemplatesDoc = {
    name: 'search_templates',
    category: 'templates',
    essentials: {
        description: 'Unified template search with multiple modes: keyword search, by node types, by task type, or by metadata. 2,700+ templates available.',
        keyParameters: ['searchMode', 'query', 'nodeTypes', 'task', 'limit'],
        example: 'search_templates({searchMode: "by_task", task: "webhook_processing"})',
        performance: 'Fast (<100ms) - FTS5 full-text search',
        tips: [
            'searchMode="keyword" (default): Search by name/description',
            'searchMode="by_nodes": Find templates using specific nodes',
            'searchMode="by_task": Get curated templates for common tasks',
            'searchMode="by_metadata": Filter by complexity, services, audience'
        ]
    },
    full: {
        description: `**Search Modes:**
- keyword (default): Full-text search across template names and descriptions
- by_nodes: Find templates that use specific node types
- by_task: Get curated templates for predefined task categories
- by_metadata: Filter by complexity, setup time, required services, or target audience

**Available Task Types (for searchMode="by_task"):**
ai_automation, data_sync, webhook_processing, email_automation, slack_integration, data_transformation, file_processing, scheduling, api_integration, database_operations`,
        parameters: {
            searchMode: {
                type: 'string',
                required: false,
                description: 'Search mode: "keyword" (default), "by_nodes", "by_task", "by_metadata"'
            },
            query: {
                type: 'string',
                required: false,
                description: 'For searchMode=keyword: Search keywords (e.g., "chatbot", "automation")'
            },
            nodeTypes: {
                type: 'array',
                required: false,
                description: 'For searchMode=by_nodes: Array of node types (e.g., ["n8n-nodes-base.httpRequest", "n8n-nodes-base.slack"])'
            },
            task: {
                type: 'string',
                required: false,
                description: 'For searchMode=by_task: Task type (ai_automation, data_sync, webhook_processing, email_automation, slack_integration, data_transformation, file_processing, scheduling, api_integration, database_operations)'
            },
            complexity: {
                type: 'string',
                required: false,
                description: 'For searchMode=by_metadata: Filter by complexity ("simple", "medium", "complex")'
            },
            maxSetupMinutes: {
                type: 'number',
                required: false,
                description: 'For searchMode=by_metadata: Maximum setup time in minutes (5-480)'
            },
            minSetupMinutes: {
                type: 'number',
                required: false,
                description: 'For searchMode=by_metadata: Minimum setup time in minutes (5-480)'
            },
            requiredService: {
                type: 'string',
                required: false,
                description: 'For searchMode=by_metadata: Filter by required service (e.g., "openai", "slack", "google")'
            },
            targetAudience: {
                type: 'string',
                required: false,
                description: 'For searchMode=by_metadata: Filter by target audience (e.g., "developers", "marketers")'
            },
            category: {
                type: 'string',
                required: false,
                description: 'For searchMode=by_metadata: Filter by category (e.g., "automation", "integration")'
            },
            fields: {
                type: 'array',
                required: false,
                description: 'For searchMode=keyword: Fields to include (id, name, description, author, nodes, views, created, url, metadata)'
            },
            limit: {
                type: 'number',
                required: false,
                description: 'Maximum results (default 20, max 100)'
            },
            offset: {
                type: 'number',
                required: false,
                description: 'Pagination offset (default 0)'
            }
        },
        returns: `Returns an object containing:
- templates: Array of matching templates
  - id: Template ID for get_template()
  - name: Template name
  - description: What the workflow does
  - author: Creator information
  - nodes: Array of node types used
  - views: Popularity metric
  - created: Creation date
  - url: Link to template
  - metadata: AI-generated metadata (complexity, services, etc.)
- totalFound: Total matching templates
- searchMode: The mode used`,
        examples: [
            '// Keyword search (default)\nsearch_templates({query: "chatbot"})',
            '// Find templates using specific nodes\nsearch_templates({searchMode: "by_nodes", nodeTypes: ["n8n-nodes-base.httpRequest", "n8n-nodes-base.slack"]})',
            '// Get templates for a task type\nsearch_templates({searchMode: "by_task", task: "webhook_processing"})',
            '// Filter by metadata\nsearch_templates({searchMode: "by_metadata", complexity: "simple", requiredService: "openai"})',
            '// Combine metadata filters\nsearch_templates({searchMode: "by_metadata", maxSetupMinutes: 30, targetAudience: "developers"})'
        ],
        useCases: [
            'Find workflows by business purpose (keyword search)',
            'Find templates using specific integrations (by_nodes)',
            'Get pre-built solutions for common tasks (by_task)',
            'Filter by complexity for team skill level (by_metadata)',
            'Find templates requiring specific services (by_metadata)'
        ],
        performance: `Fast performance across all modes:
- keyword: <50ms with FTS5 indexing
- by_nodes: <100ms with indexed lookups
- by_task: <50ms from curated cache
- by_metadata: <100ms with filtered queries`,
        bestPractices: [
            'Use searchMode="by_task" for common automation patterns',
            'Use searchMode="by_nodes" when you know which integrations you need',
            'Use searchMode="keyword" for general discovery',
            'Combine by_metadata filters for precise matching',
            'Use get_template(id) to get the full workflow JSON'
        ],
        pitfalls: [
            'searchMode="keyword" searches names/descriptions, not node types',
            'by_nodes requires full node type with prefix (n8n-nodes-base.xxx)',
            'by_metadata filters may return fewer results',
            'Not all templates have complete metadata'
        ],
        relatedTools: ['get_template', 'search_nodes', 'validate_workflow']
    }
};
//# sourceMappingURL=search-templates.js.map