n8n-nodes-bluesky

n8n community node for posting to Bluesky (ATProto).

Features

• Post to Bluesky with text
• Automatic link and mention parsing - Links and @mentions are automatically detected and parsed using ATProto's RichText API
• Upload images (up to 4 per post)
• Reply to posts
• Manual rich text facets (optional, overrides auto-parsing)
• Credential testing to verify connection

Installation

npm install n8n-nodes-bluesky

Credentials

1. Go to https://bsky.app/settings/app-passwords
2. Create a new app password
3. Use your Bluesky handle (e.g., username.bsky.social) and the app password in the credentials

Usage

1. Add the Bluesky node to your workflow
2. Configure credentials with your handle and app password
3. Enter the text you want to post
4. Links and mentions (@username) are automatically detected and parsed
5. Optionally:
   • Add images (comma-separated binary property names)
   • Add reply URI to reply to a post
   • Provide manual facets (overrides auto-parsing)
   • Disable auto-parsing if you want plain text only

Development

GitHub Actions

This repository includes GitHub Actions for:

• Automated npm publishing: Publishes to npm when version changes
• Integration tests: Runs tests against the Bluesky API

Setup for npm Publishing

To enable automated publishing, you need to create an npm Automation Token (not a regular token):

1. Go to https://www.npmjs.com/settings/YOUR_USERNAME/tokens
2. Click "Generate New Token"
3. Select "Automation" token type (this type doesn't require 2FA/OTP)
4. Copy the token
5. Add it as a GitHub secret named NPM_TOKEN in your repository settings

Important: Use an Automation token, not a regular token. Automation tokens don't require 2FA/OTP codes, making them perfect for CI/CD.

Development

GitHub Actions

This repository includes GitHub Actions for:

• Automated npm publishing: Publishes to npm when version changes
• Integration tests: Runs tests against the Bluesky API

Setup for npm Publishing

To enable automated publishing, you need to create an npm Automation Token (not a regular token):

1. Go to https://www.npmjs.com/settings/YOUR_USERNAME/tokens
2. Click "Generate New Token"
3. Select "Automation" token type (this type doesn't require 2FA/OTP)
4. Copy the token
5. Add it as a GitHub secret named NPM_TOKEN in your repository settings

Important: Use an Automation token, not a regular token. Automation tokens don't require 2FA/OTP codes, making them perfect for CI/CD.

License

MIT