n8n-nodes-socialswarm

n8n-nodes-socialswarm

Turn any article, blog post, or block of text into ready-to-post X/Twitter thread variants — each built around a different hook (curiosity, challenge, story, stat, question). Powered by SocialSwarm.

What it does

Adds a SocialSwarm node with one operation — Generate Thread — that takes text or a URL and returns multiple thread variants as structured JSON, ready to schedule, post, or hand off to another node.

Installation

In n8n (self-hosted): Settings → Community Nodes → Install → n8n-nodes-socialswarm.

Manual: npm install n8n-nodes-socialswarm in your n8n custom nodes folder.

Credentials

You need a SocialSwarm API key. Subscribe to a plan on the developer portal to get one, then add it under Credentials → SocialSwarm API.

Node: Generate Thread

Field	Description
Source Type	Text (paste content) or URL (fetch and repurpose a page)
Source Text	The content to repurpose (shown for Text)
Source URL	The page to fetch (shown for URL)
Number of Variants	3 or 5 hook-varied thread variants

Output

{
  "variants": [
    {
      "hook": "curiosity",
      "tweetCount": 5,
      "tweets": [
        { "text": "Most people get this backwards. Here's why:", "charCount": 43 }
      ]
    }
  ],
  "meta": { "variantCount": 3 }
}

Example workflow

RSS → SocialSwarm → Buffer: trigger on a new blog post, generate 3 thread variants from its URL, and push the first variant to your scheduler. Content repurposing on autopilot.

Build & publish (maintainers)

npm install
npm run build          # compiles TS to dist/ (add nodes/SocialSwarm/socialswarm.svg first)
npm publish --access public

The node is declarative (routing-based, no execute()), so it's easy to extend — add operations by adding entries to the Operation options array.

Links

• Website: https://social-swarm.vercel.app
• API docs / portal: https://social-swarm-main-aa77a19.zuplo.site
• Gateway base URL: https://social-swarm-main-aa77a19.zuplo.app