mirror of
https://github.com/czlonkowski/n8n-mcp.git
synced 2026-01-29 22:12:05 +00:00
974a9fb349
- Updated n8n from 2.2.3 to 2.3.3 - Updated n8n-core from 2.2.2 to 2.3.2 - Updated n8n-workflow from 2.2.2 to 2.3.2 - Updated @n8n/n8n-nodes-langchain from 2.2.2 to 2.3.2 - Rebuilt node database with 537 nodes (434 from n8n-nodes-base, 103 from @n8n/n8n-nodes-langchain) - Updated README badge with new n8n version - Updated CHANGELOG with dependency changes Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
70 lines
5.3 KiB
JavaScript
70 lines
5.3 KiB
JavaScript
"use strict";
|
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
exports.searchNodesDoc = void 0;
|
|
exports.searchNodesDoc = {
|
|
name: 'search_nodes',
|
|
category: 'discovery',
|
|
essentials: {
|
|
description: 'Text search across node names and descriptions. Returns most relevant nodes first, with frequently-used nodes (HTTP Request, Webhook, Set, Code, Slack) prioritized in results. Searches all 800+ nodes including 300+ verified community nodes.',
|
|
keyParameters: ['query', 'mode', 'limit', 'source', 'includeExamples'],
|
|
example: 'search_nodes({query: "webhook"})',
|
|
performance: '<20ms even for complex queries',
|
|
tips: [
|
|
'OR mode (default): Matches any search word',
|
|
'AND mode: Requires all words present',
|
|
'FUZZY mode: Handles typos and spelling errors',
|
|
'Use quotes for exact phrases: "google sheets"',
|
|
'Use source="community" to search only community nodes',
|
|
'Use source="verified" for verified community nodes only'
|
|
]
|
|
},
|
|
full: {
|
|
description: 'Full-text search engine for n8n nodes using SQLite FTS5. Searches across node names, descriptions, and aliases. Results are ranked by relevance with commonly-used nodes given priority. Includes 500+ core nodes and 300+ community nodes. Common core nodes include: HTTP Request, Webhook, Set, Code, IF, Switch, Merge, SplitInBatches, Slack, Google Sheets. Community nodes include verified integrations like BrightData, ScrapingBee, CraftMyPDF, and more.',
|
|
parameters: {
|
|
query: { type: 'string', description: 'Search keywords. Use quotes for exact phrases like "google sheets"', required: true },
|
|
limit: { type: 'number', description: 'Maximum results to return. Default: 20, Max: 100', required: false },
|
|
mode: { type: 'string', description: 'Search mode: "OR" (any word matches, default), "AND" (all words required), "FUZZY" (typo-tolerant)', required: false },
|
|
source: { type: 'string', description: 'Filter by node source: "all" (default, everything), "core" (n8n base nodes only), "community" (community nodes only), "verified" (verified community nodes only)', required: false },
|
|
includeExamples: { type: 'boolean', description: 'Include top 2 real-world configuration examples from popular templates for each node. Default: false. Adds ~200-400 tokens per node.', required: false }
|
|
},
|
|
returns: 'Array of node objects sorted by relevance score. Each object contains: nodeType, displayName, description, category, relevance score. For community nodes, also includes: isCommunity (boolean), isVerified (boolean), authorName (string), npmDownloads (number). Common nodes appear first when relevance is similar.',
|
|
examples: [
|
|
'search_nodes({query: "webhook"}) - Returns Webhook node as top result',
|
|
'search_nodes({query: "database"}) - Returns MySQL, Postgres, MongoDB, Redis, etc.',
|
|
'search_nodes({query: "google sheets", mode: "AND"}) - Requires both words',
|
|
'search_nodes({query: "slak", mode: "FUZZY"}) - Finds Slack despite typo',
|
|
'search_nodes({query: "http api"}) - Finds HTTP Request, GraphQL, REST nodes',
|
|
'search_nodes({query: "transform data"}) - Finds Set, Code, Function, Item Lists nodes',
|
|
'search_nodes({query: "scraping", source: "community"}) - Find community scraping nodes',
|
|
'search_nodes({query: "pdf", source: "verified"}) - Find verified community PDF nodes',
|
|
'search_nodes({query: "brightdata"}) - Find BrightData community node',
|
|
'search_nodes({query: "slack", includeExamples: true}) - Get Slack with template examples'
|
|
],
|
|
useCases: [
|
|
'Finding nodes when you know partial names',
|
|
'Discovering nodes by functionality (e.g., "email", "database", "transform")',
|
|
'Handling user typos in node names',
|
|
'Finding all nodes related to a service (e.g., "google", "aws", "microsoft")',
|
|
'Discovering community integrations for specific services',
|
|
'Finding verified community nodes for enhanced trust'
|
|
],
|
|
performance: '<20ms for simple queries, <50ms for complex FUZZY searches. Uses FTS5 index for speed',
|
|
bestPractices: [
|
|
'Start with single keywords for broadest results',
|
|
'Use FUZZY mode when users might misspell node names',
|
|
'AND mode works best for 2-3 word searches',
|
|
'Combine with get_node after finding the right node',
|
|
'Use source="verified" when recommending community nodes for production',
|
|
'Check isVerified flag to ensure community node quality'
|
|
],
|
|
pitfalls: [
|
|
'AND mode searches all fields (name, description) not just node names',
|
|
'FUZZY mode with very short queries (1-2 chars) may return unexpected results',
|
|
'Exact matches in quotes are case-sensitive',
|
|
'Community nodes require npm installation (n8n npm install <package-name>)',
|
|
'Unverified community nodes (isVerified: false) may have limited support'
|
|
],
|
|
relatedTools: ['get_node to configure found nodes', 'search_templates to find workflow examples', 'validate_node to check configurations']
|
|
}
|
|
};
|
|
//# sourceMappingURL=search-nodes.js.map
|