n8n-nodes-postwire 0.1.0

package/LICENSE.md

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 PostWire
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.

package/README.md

@@ -0,0 +1,71 @@
+# n8n-nodes-postwire
+
+Publish one idea to every social network from n8n — with **a different post written for each one**, not the same text pasted everywhere.
+
+[PostWire](https://postwire.io) handles the part that usually stops an n8n workflow: TikTok, Instagram and YouTube all require an approved developer app, and TikTok's App Review asks for a demo video of the integration you cannot build until you are approved. PostWire already holds those approvals, so connecting an account is a single OAuth click.
+
+## What the node does
+
+| Operation | What it does |
+|---|---|
+| **Write a Post per Network** | One idea in, a native draft out per network — correct length, hashtag conventions, an SEO title and tags for YouTube, a hook-first caption for TikTok, link-in-comment for LinkedIn. Does not publish. |
+| **Publish** | Sends to every selected network in one call. |
+| **Write and Publish** | Both, in one node. |
+| **Schedule** | Queues a post for later, and validates it **now** — so a missing video surfaces while you are watching, not at 7am tomorrow. |
+| **Get Account** | Plan, posts used this month, connected accounts. |
+
+Networks: TikTok · Instagram · YouTube · LinkedIn · X · Facebook · Reddit · Bluesky · Mastodon · Telegram · Discord.
+
+## Install
+
+**n8n Cloud** — Settings → Community nodes → Install → `n8n-nodes-postwire`
+
+**Self-hosted** — Settings → Community nodes → Install, or:
+
+```bash
+npm install n8n-nodes-postwire
+```
+
+## Credentials
+
+1. Get a free API key at [postwire.io/dashboard.html](https://postwire.io/dashboard.html) and connect the accounts you want to post to.
+2. In n8n, create a **PostWire API** credential and paste the key.
+3. Press **Test** — it calls `/api/me` and returns your plan and connected accounts, so a wrong key fails now rather than at publish time.
+
+Free plan: one brand with every network it connects, 30 posts a month, no card.
+
+## Nothing half-publishes
+
+The most common way a cross-posting workflow goes wrong is a partial send: you ask for four networks and two go out. This node checks before anything is published — that each network is connected, that the caption is inside that platform's character limit, and that video networks actually have a video. If any of them would fail, the whole call is refused and the error tells you which one and what to change.
+
+The node also validates media in the editor, so `youtube will not accept a post without a video` appears before you run the workflow rather than after.
+
+## Output
+
+**Publish** returns one n8n item per network, so you can wire a Filter or IF node straight onto the failures:
+
+```json
+{ "ok": true,  "platform": "x",       "id": "1934…", "url": "https://x.com/…" }
+{ "ok": false, "platform": "youtube", "error": "youtube needs a video…", "code": "media_required" }
+```
+
+**Write a Post per Network** returns `{ drafts: { "<platform>": { text, title?, tags? } } }`.
+
+## Pricing
+
+Priced per **brand** — one business with all of its networks — not per channel or per social account. Adding a fifth network to a brand never changes the bill.
+
+| | Brands | Posts/month | |
+|---|---|---|---|
+| Free | 1 | 30 | no card |
+| Starter | 3 | 300 | $9/mo |
+| Pro | 10 | 2,000 | $29/mo |
+| Agency | 50 | 15,000 | $99/mo |
+
+## Also available
+
+A REST API and a hosted MCP server (`https://postwire.io/api/mcp`) for AI agents in Claude, Cursor or VS Code. See [postwire.io/mcp](https://postwire.io/mcp/).
+
+## License
+
+MIT

package/credentials/PostWireApi.credentials.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostWireApi = void 0;
+
+// PostWire authenticates with a single bearer key. The `test` block below is what makes n8n's
+// "Test connection" button meaningful: /api/me returns the plan, the month's usage and the
+// connected accounts, so a wrong key fails immediately instead of at publish time.
+class PostWireApi {
+  constructor() {
+    this.name = 'postWireApi';
+    this.displayName = 'PostWire API';
+    this.documentationUrl = 'https://postwire.io/mcp/';
+    this.properties = [
+      {
+        displayName: 'API Key',
+        name: 'apiKey',
+        type: 'string',
+        typeOptions: { password: true },
+        default: '',
+        required: true,
+        placeholder: 'pw_live_...',
+        description:
+          'Your PostWire API key. Get one free at https://postwire.io/dashboard.html — the free plan covers one brand, every network it connects, and 30 posts a month, with no card.',
+      },
+    ];
+    this.authenticate = {
+      type: 'generic',
+      properties: {
+        headers: {
+          Authorization: '=Bearer {{$credentials.apiKey}}',
+          'X-PostWire-Source': 'n8n',
+        },
+      },
+    };
+    this.test = {
+      request: {
+        baseURL: 'https://postwire.io',
+        url: '/api/me',
+        method: 'GET',
+      },
+    };
+  }
+}
+exports.PostWireApi = PostWireApi;

package/credentials/postwire.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24"><rect width="24" height="24" rx="5" fill="#0b0e14"/><path d="M6 17V7h4.6a3.2 3.2 0 0 1 0 6.4H8.4" stroke="#3ea6ff" stroke-width="2.1" fill="none" stroke-linecap="round" stroke-linejoin="round"/><circle cx="16.6" cy="15.4" r="1.7" fill="#3ea6ff"/></svg>

package/index.js

@@ -0,0 +1 @@
+module.exports = {};

package/nodes/PostWire/PostWire.node.js

@@ -0,0 +1,296 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostWire = void 0;
+
+const { NodeOperationError } = require("n8n-workflow");
+
+const BASE = "https://postwire.io";
+
+// Every network PostWire can publish to. `mediaNeed` mirrors the server's own rule so the node can
+// warn in the editor rather than letting the call fail — TikTok and YouTube refuse a post with no
+// video, and Instagram refuses one with no media at all.
+const PLATFORMS = [
+  { name: "TikTok", value: "tiktok", mediaNeed: "video" },
+  { name: "Instagram", value: "instagram", mediaNeed: "any" },
+  { name: "YouTube", value: "youtube", mediaNeed: "video" },
+  { name: "LinkedIn", value: "linkedin", mediaNeed: null },
+  { name: "X (Twitter)", value: "x", mediaNeed: null },
+  { name: "Facebook", value: "facebook", mediaNeed: null },
+  { name: "Reddit", value: "reddit", mediaNeed: null },
+  { name: "Bluesky", value: "bluesky", mediaNeed: null },
+  { name: "Mastodon", value: "mastodon", mediaNeed: null },
+  { name: "Telegram", value: "telegram", mediaNeed: null },
+  { name: "Discord", value: "discord", mediaNeed: null },
+];
+
+class PostWire {
+  constructor() {
+    this.description = {
+      displayName: "PostWire",
+      name: "postWire",
+      icon: "file:postwire.svg",
+      group: ["output"],
+      version: 1,
+      subtitle: '={{$parameter["operation"]}}',
+      description: "Publish one idea natively to every social network",
+      defaults: { name: "PostWire" },
+      inputs: ["main"],
+      outputs: ["main"],
+      credentials: [{ name: "postWireApi", required: true }],
+      requestDefaults: {
+        baseURL: BASE,
+        headers: { "Content-Type": "application/json" },
+      },
+      properties: [
+        {
+          displayName: "Operation",
+          name: "operation",
+          type: "options",
+          noDataExpression: true,
+          options: [
+            {
+              name: "Write a Post per Network",
+              value: "generate",
+              description:
+                "One prompt in, a native draft out for each network — right length, hashtags and format per platform. Does not publish.",
+              action: "Write a native post for each network",
+            },
+            {
+              name: "Publish",
+              value: "publish",
+              description: "Publish to one or more networks in a single call",
+              action: "Publish to social networks",
+            },
+            {
+              name: "Write and Publish",
+              value: "generateAndPublish",
+              description: "Write a native draft per network, then publish them",
+              action: "Write and publish in one step",
+            },
+            {
+              name: "Schedule",
+              value: "schedule",
+              description: "Queue a post for a later time",
+              action: "Schedule a post",
+            },
+            {
+              name: "Get Account",
+              value: "me",
+              description: "Plan, usage this month and connected accounts",
+              action: "Get the PostWire account",
+            },
+          ],
+          default: "generateAndPublish",
+        },
+
+        {
+          displayName: "Networks",
+          name: "platforms",
+          type: "multiOptions",
+          options: PLATFORMS.map((p) => ({ name: p.name, value: p.value })),
+          default: ["x", "linkedin"],
+          required: true,
+          description:
+            "Connect these in the PostWire dashboard first. TikTok, Instagram and YouTube are one OAuth click — PostWire carries the platform approvals, so there is no app review on your side.",
+          displayOptions: { show: { operation: ["generate", "publish", "generateAndPublish", "schedule"] } },
+        },
+
+        {
+          displayName: "Idea",
+          name: "prompt",
+          type: "string",
+          typeOptions: { rows: 3 },
+          default: "",
+          required: true,
+          placeholder: "We shipped scheduling today — one idea, a native post per network",
+          description: "What you want to say. More detail gives a better draft.",
+          displayOptions: { show: { operation: ["generate", "generateAndPublish"] } },
+        },
+
+        {
+          displayName: "Text",
+          name: "text",
+          type: "string",
+          typeOptions: { rows: 3 },
+          default: "",
+          description: "Posted exactly as written to every selected network",
+          displayOptions: { show: { operation: ["publish", "schedule"] } },
+        },
+
+        {
+          displayName: "Media URL",
+          name: "mediaUrl",
+          type: "string",
+          default: "",
+          placeholder: "https://example.com/clip.mp4",
+          description:
+            "A direct link to an .mp4 or an image. TikTok and YouTube will not accept a post without a video, and Instagram needs a photo or a video. A Google Drive share link does not work — it returns a web page, not a file.",
+          displayOptions: { show: { operation: ["generate", "publish", "generateAndPublish", "schedule"] } },
+        },
+
+        {
+          displayName: "Publish At",
+          name: "runAt",
+          type: "dateTime",
+          default: "",
+          required: true,
+          description: "When to publish. PostWire validates the post now, so a missing video is caught here rather than at 7am tomorrow.",
+          displayOptions: { show: { operation: ["schedule"] } },
+        },
+
+        {
+          displayName: "Options",
+          name: "options",
+          type: "collection",
+          placeholder: "Add option",
+          default: {},
+          displayOptions: { show: { operation: ["generate", "publish", "generateAndPublish", "schedule"] } },
+          options: [
+            {
+              displayName: "Title (YouTube)",
+              name: "title",
+              type: "string",
+              default: "",
+              description: "Overrides the generated YouTube title",
+            },
+            {
+              displayName: "Brand",
+              name: "brandId",
+              type: "string",
+              default: "",
+              description: "Publish as a specific brand. Leave empty for your only brand.",
+            },
+            {
+              displayName: "Visibility",
+              name: "privacy",
+              type: "options",
+              options: [
+                { name: "Public", value: "public" },
+                { name: "Private", value: "private" },
+                { name: "Unlisted", value: "unlisted" },
+              ],
+              default: "public",
+              description: "Used by TikTok and YouTube",
+            },
+            {
+              displayName: "Brand Voice",
+              name: "brandVoice",
+              type: "string",
+              default: "",
+              description: "A sentence describing how you want to sound, applied to every generated draft",
+            },
+          ],
+        },
+      ],
+    };
+  }
+
+  async execute() {
+    const items = this.getInputData();
+    const out = [];
+
+    for (let i = 0; i < items.length; i++) {
+      try {
+        const operation = this.getNodeParameter("operation", i);
+
+        if (operation === "me") {
+          const me = await this.helpers.httpRequestWithAuthentication.call(this, "postWireApi", {
+            method: "GET",
+            url: `${BASE}/api/me`,
+            json: true,
+          });
+          out.push({ json: me, pairedItem: { item: i } });
+          continue;
+        }
+
+        const platforms = this.getNodeParameter("platforms", i);
+        const opts = this.getNodeParameter("options", i, {});
+        const mediaUrl = (this.getNodeParameter("mediaUrl", i, "") || "").trim();
+
+        if (!platforms || !platforms.length) {
+          throw new NodeOperationError(this.getNode(), "Pick at least one network.", { itemIndex: i });
+        }
+
+        // Media rules, checked before the request so the message names the fix rather than the symptom.
+        const isVideo = /\.(mp4|mov|webm|m3u8|avi|mkv|m4v)(\?|$)/i.test(mediaUrl);
+        const blocked = platforms.filter((p) => {
+          const need = (PLATFORMS.find((x) => x.value === p) || {}).mediaNeed;
+          if (!need) return false;
+          if (need === "video") return !isVideo;
+          return !mediaUrl;
+        });
+        if (blocked.length) {
+          throw new NodeOperationError(
+            this.getNode(),
+            `${blocked.join(" and ")} will not accept a post without ${blocked.some((p) => (PLATFORMS.find((x) => x.value === p) || {}).mediaNeed === "video") ? "a video" : "an image or video"}. Set Media URL to a direct file link, or remove ${blocked.length > 1 ? "those networks" : "that network"} from the list.`,
+            { itemIndex: i },
+          );
+        }
+
+        const photo_url = mediaUrl && !isVideo ? mediaUrl : undefined;
+        const video_url = isVideo ? mediaUrl : undefined;
+
+        let per_platform;
+        if (operation === "generate" || operation === "generateAndPublish") {
+          const prompt = this.getNodeParameter("prompt", i);
+          const gen = await this.helpers.httpRequestWithAuthentication.call(this, "postWireApi", {
+            method: "POST",
+            url: `${BASE}/api/generate`,
+            body: { prompt, platforms, media_url: mediaUrl || undefined, brand_voice: opts.brandVoice || undefined },
+            json: true,
+          });
+          per_platform = gen.drafts;
+          if (operation === "generate") {
+            out.push({ json: gen, pairedItem: { item: i } });
+            continue;
+          }
+        }
+
+        const body = {
+          platforms,
+          per_platform,
+          text: per_platform ? undefined : this.getNodeParameter("text", i, ""),
+          photo_url,
+          video_url,
+          title: opts.title || undefined,
+          privacy: opts.privacy || undefined,
+          brand_id: opts.brandId || undefined,
+        };
+
+        if (operation === "schedule") {
+          const runAt = this.getNodeParameter("runAt", i);
+          const r = await this.helpers.httpRequestWithAuthentication.call(this, "postWireApi", {
+            method: "POST",
+            url: `${BASE}/api/schedule`,
+            body: { ...body, run_at: runAt },
+            json: true,
+          });
+          out.push({ json: r, pairedItem: { item: i } });
+          continue;
+        }
+
+        const r = await this.helpers.httpRequestWithAuthentication.call(this, "postWireApi", {
+          method: "POST",
+          url: `${BASE}/api/post`,
+          body,
+          json: true,
+        });
+
+        // One n8n item per network, so a Filter or IF node downstream can act on the failures alone
+        // instead of unpacking an array by hand.
+        for (const res of r.results || [r]) {
+          out.push({ json: res, pairedItem: { item: i } });
+        }
+      } catch (error) {
+        if (this.continueOnFail()) {
+          out.push({ json: { error: error.message }, pairedItem: { item: i } });
+          continue;
+        }
+        throw error;
+      }
+    }
+
+    return [out];
+  }
+}
+exports.PostWire = PostWire;

package/nodes/PostWire/postwire.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24"><rect width="24" height="24" rx="5" fill="#0b0e14"/><path d="M6 17V7h4.6a3.2 3.2 0 0 1 0 6.4H8.4" stroke="#3ea6ff" stroke-width="2.1" fill="none" stroke-linecap="round" stroke-linejoin="round"/><circle cx="16.6" cy="15.4" r="1.7" fill="#3ea6ff"/></svg>

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "n8n-nodes-postwire",
+  "version": "0.1.0",
+  "description": "Publish one idea natively to TikTok, Instagram, YouTube, LinkedIn, X, Bluesky, Mastodon, Telegram, Discord and Reddit from n8n — a different post written for each network, via PostWire.",
+  "keywords": [
+    "n8n-community-node-package",
+    "postwire",
+    "social media",
+    "tiktok",
+    "instagram",
+    "youtube",
+    "linkedin",
+    "cross-posting",
+    "scheduling"
+  ],
+  "license": "MIT",
+  "homepage": "https://postwire.io",
+  "author": { "name": "PostWire", "email": "privacy@postwire.io" },
+  "repository": { "type": "git", "url": "git+https://github.com/Perufitlife/n8n-nodes-postwire.git" },
+  "main": "index.js",
+  "scripts": {
+    "prepublishOnly": "node -e \"require('./nodes/PostWire/PostWire.node.js');require('./credentials/PostWireApi.credentials.js');console.log('load check ok')\""
+  },
+  "files": ["index.js", "nodes", "credentials", "LICENSE.md", "README.md"],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": ["credentials/PostWireApi.credentials.js"],
+    "nodes": ["nodes/PostWire/PostWire.node.js"]
+  },
+  "peerDependencies": { "n8n-workflow": "*" },
+  "engines": { "node": ">=18.10" }
+}