Crosspost

by Nicholas C. Zakas

If you find this useful, please consider supporting my work with a donation or nominate me for a GitHub Star.

Description

A utility for posting across multiple social networks at once.

Installation

npm install @humanwhocodes/crosspost

Usage

API Usage

The API is split into two parts:

1. The Client class that can be used to post the same message across multiple services.
2. A number of different strategy implementations, one for each service:
   • BlueskyStrategy
   • MastodonStrategy
   • TwitterStrategy
   • LinkedInStrategy
   • DiscordStrategy

Each strategy requires its own parameters that are specific to the service. If you only want to post to a particular service, you can just directly use the strategy for that service.

import {
	Client,
	TwitterStrategy,
	MastodonStrategy,
	BlueskyStrategy,
	LinkedInStrategy,
	DiscordStrategy,
} from "@humanwhocodes/crosspost";

// Note: Use an app password, not your login password!
const bluesky = new BlueskyStrategy({
	identifier: "me.you.social",
	password: "your-app-password",
	host: "you.social", // "bsky.social" for most people
});

// Note: Personal access token is required
const mastodon = new MastodonStrategy({
	accessToken: "your-access-token",
	host: "mastodon.host",
});

// Note: OAuth app is required
const twitter = new TwitterStrategy({
	accessTokenKey: "access-token-key",
	accessTokenSecret: "access-token-secret",
	apiConsumerKey: "api-consumer-key",
	apiConsumerSecret: "api-consumer-secret",
});

// Note: OAuth access token is required
const linkedin = new LinkedInStrategy({
	accessToken: "your-access-token",
});

// Note: Bot token and channel ID required
const discord = new DiscordStrategy({
	botToken: "your-bot-token",
	channelId: "your-channel-id",
});

// create a client that will post to all services
const client = new Client({
	strategies: [bluesky, mastodon, twitter, linkedin, discord],
});

// post to all three
await client.post("Hello world!");

CLI Usage

Crosspost also has a command line interface to allow for incorporation into CI systems.

Usage: crosspost [options] ["Message to post."]
--twitter, -t   Post to Twitter.
--mastodon, -m  Post to Mastodon.
--bluesky, -b   Post to Bluesky.
--linkedin, -l  Post to LinkedIn.
--discord, -d   Post to Discord.
--file, -f      The file to read the message from.
--help, -h      Show this message.

Example:

npx crosspost -t -m -b "Hello world!"

# or

npx @humanwhocodes/crosspost -t -m -b "Hello world!"

This posts the message "Hello world!" to Twitter, Mastodon, and Bluesky. You can choose to post to any combination by specifying the appropriate command line options.

You can also read the message from a file instead of from the command line:

npx crosspost -t -m -b -f message.txt

# or

npx @humanwhocodes/crosspost -t -m -b -f message.txt

Each strategy requires a set of environment variables in order to execute:

• Twitter
  • TWITTER_ACCESS_TOKEN_KEY
  • TWITTER_ACCESS_TOKEN_SECRET
  • TWITTER_API_CONSUMER_KEY
  • TWITTER_API_CONSUMER_SECRET
• Mastodon
  • MASTODON_ACCESS_TOKEN
  • MASTODON_HOST
• Bluesky
  • BLUESKY_HOST
  • BLUESKY_IDENTIFIER
  • BLUESKY_PASSWORD
• LinkedIn
  • LINKEDIN_ACCESS_TOKEN
• Discord
  • DISCORD_BOT_TOKEN
  • DISCORD_CHANNEL_ID

Tip: You can also load environment variables from a .env file in the current working directory by setting the environment variable CROSSPOST_DOTENV to 1.

Setting up Strategies

Each strategy uses the service's preferred way of posting messages, so you'll need to follow specific steps in order to enable API access.

Twitter

To enable posting on Twitter, you'll need to create a free developer account and an OAuth application. Follow these instructions.

Generally speaking, if you are creating an app to automate your own posts, you'll be able to use it for free so long as you're not posting a large number of times per day.

Note: The post uses the terms "app key" and "app secret" whereas the Twitter strategy here uses "API consumer key" and "API consumer secret". They are the same values.

Mastodon

To enable posting to Mastodon, you'll need to create a new application:

1. Log in to your Mastodon server.
2. Click on "Edit Profile".
3. Click on "Development".
4. Click "New Application".
5. Give your application a name.
6. Check off write:statuses for your scope.
7. Click "Submit".

This will generate a client key, client secret, and access token. You only need to use the access token when posting via the API.

Bluesky

Bluesky doesn't require an application for automated posts, only your identifier and an app password. To generate an app password:

1. Log in to your Bluesky account.
2. Click "Settings".
3. Click "Privacy and Security."
4. Click "App Passwords".
5. Click "Add App Password".
6. Name your app password and click "Next".
7. Copy the generated password and click "Done".

Important: Do not use your login password with the API.

LinkedIn

To enable posting to LinkedIn, follow these steps:

1. Go to LinkedIn Developers.
2. Click "Create app".
3. Fill in your application details.
4. Click "Create App" (yes, again).
5. Click on the "Settings" tab.
6. Next to "LinkedIn Page" click "Verify".
7. Go to the generated URL to link your page to your app.
8. Under "Available Products", request access to "Share on LinkedIn" and "Sign in with LinkedIn using OpenID Connect".
9. Go to OAuth 2.0 Tools and click "Create Token".
10. Select your app from the dropdown.
11. Check the box next to openid, profile and w_member_social scopes.
12. Click "Request Access Token".
13. Use your profile to grant access to your app by clicking "Allow".

Important: Tokens automatically expire after two months.

Discord

To enable posting to Discord, you'll need to create a bot and get its token:

1. Go to the Discord Developer Portal.
2. Click "New Application".
3. Give your application a name and click "Create".
4. Click "Installation" in the left sidebar.
5. Under "Install Link" select "None".
6. Click "Save Changes".
7. Click on "Bot" in the left sidebar.
8. Uncheck "Public Bot" to ensure no one else can add this bot.
9. Under "Text Permissions" check "Send Messages".
10. Click "Save Changes".
11. Click "Reset Token" and copy the bot token that appears.

To add the bot to your server:

1. In the Developer Portal, click on "OAuth2" in the left sidebar.
2. Under "OAuth2 URL Generator", check "bot".
3. Under "Bot Permissions", check "Send Messages" under "Text Permissions".
4. Copy the generated URL and open it in your browser.
5. Select your server and authorize the bot.

To get your channel ID:

1. Enable Developer Mode in Discord (User Settings > Advanced > Developer Mode).
2. Right-click the channel you want to post to.
3. Click "Copy Channel ID".

Note: By default your application will only be able to send messages to public channels. To send messages to private channels, you'll have to give your application the necessary permissions.

License

Copyright 2024-2025 Nicholas C. Zakas

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.