n8n community node for posting to Bluesky (ATProto)
npm install @boxingoctopus/n8n-nodes-blueskyn8n community node for posting to Bluesky (ATProto).
- 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
``bash`
npm install n8n-nodes-bluesky
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
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
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.
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.
MIT