[ PROMPT_NODE_28114 ]
N8N MCP Tools Expert Search Guide
[ SKILL_DOCUMENTATION ]
# 节点发现工具指南
查找和理解 n8n 节点的完整指南。
---
## search_nodes (从这里开始!)
**成功率**: 99.9% | **速度**: <20ms
**使用场景**: 当你知道要找什么时(关键词、服务、用例)
**语法**:
javascript
search_nodes({
query: "slack", // 必填: 搜索关键词
mode: "OR", // 选填: OR (默认), AND, FUZZY
limit: 20 // 选填: 最大结果数 (默认 20, 最大 100)
})
**返回**:
javascript
{
"query": "slack",
"results": [
{
"nodeType": "nodes-base.slack", // 用于搜索/验证工具
"workflowNodeType": "n8n-nodes-base.slack", // 用于工作流工具
"displayName": "Slack",
"description": "调用 Slack API",
"category": "output",
"relevance": "high"
}
]
}
**提示**:
- 常用搜索: webhook, http, database, email, slack, google, ai
- OR 模式 (默认): 匹配任意词
- AND 模式: 要求匹配所有词
- FUZZY 模式: 容错搜索 (查找 "slak" → Slack)
---
## get_node_essentials (推荐!)
**成功率**: 91.7% | **速度**: <10ms | **大小**: ~5KB
**使用场景**: 找到节点后需要配置详情时
**语法**:
javascript
get_node_essentials({
nodeType: "nodes-base.slack", // 必填: 短前缀格式
includeExamples: true // 选填: 获取真实模板配置
})
**返回**:
- 可用的操作和资源
- 核心属性 (最常用的 10-20 个)
- 元数据 (isAITool, isTrigger, hasCredentials)
- 来自模板的真实示例 (如果 includeExamples 为 true)
**为什么使用它**:
- 5KB vs 100KB+ (get_node_info)
- 91.7% 成功率 vs 80%
- <10ms vs 更慢
- 数据聚焦 (无信息过载)
---
## get_node_info (谨慎使用!)
**成功率**: 80% ⚠️ | **大小**: 100KB+
**使用场景**:
- 调试复杂配置
- 需要完整的属性架构
- 探索高级功能
**语法**:
javascript
get_node_info({
nodeType: "nodes-base.httpRequest"
})
**警告**: 20% 失败率!大多数情况下请改用 get_node_essentials。
**更好的替代方案**:
1. get_node_essentials - 操作列表
2. get_node_documentation - 可读文档
3. search_node_properties - 特定属性
---
## list_nodes (按分类浏览)
**成功率**: 99.6% | **速度**: <20ms
**使用场景**: 按分类探索或列出所有节点
**语法**:
javascript
list_nodes({
category: "trigger", // 选项