📦 NPM for N8N Nodes — NPM工具

Core Mental 模型

Every n8n node follows one pattern:

getInputData()  →  loop items  →  do stuff  →  push to returnData  →  return [returnData]

Two file types do all the work:

• 节点 file (nodes/MyNode/MyNode.节点.ts) — UI fields + execute logic
• Credential file (credentials/MyApi.credentials.ts) — auth definition

Everything else is project plumbing.

Project Structure

n8n-nodes-yourservice/
├── package.json              ← CRITICAL: must have n8n section + correct keyword
├── tsconfig.json
├── .eslintrc.js
├── gulpfile.js               ← copies SVG icons to dist/
├── index.js                  ← optional explicit entry point
├── nodes/
│   └── YourService/
│       ├── YourService.node.ts
│       ├── YourService.node.json   ← optional: codex metadata
│       └── yourservice.svg
├── credentials/
│   └── YourServiceApi.credentials.ts
└── dist/                     ← compiled output (never edit manually)

什么 到 读取 和 当...时

This skill has focused reference files. Load only what you need:

节点 Types (pick one)

Credentials (pick 什么 matches auth)

Concepts (加载 当...时 topic comes up)

Project Setup & Publishing

Quick-开始 Pattern (复制 第一个)

// nodes/YourService/YourService.node.ts
import {
  IExecuteFunctions,
  INodeExecutionData,
  INodeType,
  INodeTypeDescription,
  NodeOperationError,
} from 'n8n-workflow';
export class YourService implements INodeType {
  description: INodeTypeDescription = {
    displayName: 'Your Service',
    name: 'yourService',
    icon: 'file:yourservice.svg',
    group: ['transform'],
    version: 1,
    description: 'Interact with Your Service API',
    defaults: { name: 'Your Service' },
    inputs: ['main'],
    outputs: ['main'],
    credentials: [{ name: 'yourServiceApi', required: true }],
    properties: [
      {
        displayName: 'Endpoint',
        name: 'endpoint',
        type: 'string',
        default: '/users',
        required: true,
      },
    ],
  };
  async execute(this: IExecuteFunctions): Promise {
    const items = this.getInputData();
    const returnData: INodeExecutionData[] = [];
    const credentials = await this.getCredentials('yourServiceApi');
    for (let i = 0; i < items.length; i++) {
      try {
        const endpoint = this.getNodeParameter('endpoint', i) as string;
        const response = await this.helpers.httpRequest({
          method: 'GET',
          url: https://api.yourservice.com${endpoint},
          headers: {
            Authorization: Bearer ${credentials.apiToken},
          },
        });
        returnData.push({ json: response, pairedItem: { item: i } });
      } catch (error) {
        if (this.continueOnFail()) {
          returnData.push({ json: { error: error.message }, pairedItem: { item: i } });
          continue;
        }
        throw new NodeOperationError(this.getNode(), error, { itemIndex: i });
      }
    }
    return [returnData];
  }
}

Essential APIs Cheat Sheet

// Input
const items = this.getInputData();
// Parameters
this.getNodeParameter('name', i) as string
this.getNodeParameter('count', i, 0) as number
this.getNodeParameter('options', i, {}) as IDataObject
// Credentials
const creds = await this.getCredentials('myCredentialName');
// HTTP
await this.helpers.httpRequest({ method, url, headers, qs, body })
// Error handling
this.continueOnFail()
throw new NodeOperationError(this.getNode(), message, { itemIndex: i })
throw new NodeApiError(this.getNode(), error)   // for API-level HTTP errors
// Output
returnData.push({ json: data, pairedItem: { item: i } })
return [returnData];

Pre-发布 Checklist

• [ ] keywords 在...中 包.json includes "n8n-community-节点-包"
• [ ] n8n.nodes 和 n8n.credentials arrays point 到 dist/ .js paths
• [ ] 节点 name camelCase; displayName human-readable
• [ ] Credential name exactly matches 字符串 passed 到 getCredentials('...')
• [ ] Every returnData.推送() includes pairedItem: { item: i }
• [ ] continueOnFail() handled 在...中 所有 try/catch blocks
• [ ] SVG icon exists 在...中 nodes/YourService/ 和 referenced 作为 'file:yourservice.svg'
• [ ] npm run build succeeds (否 TypeScript errors)
• [ ] npm run lint passes (必填 对于 community submission)
• [ ] Tested locally 通过 npm 链接
• [ ] Version bumped 在...中 包.json 之前 发布