@robinpath/twitter

Twitter/X module for RobinPath.

Why use this module?

The twitter module lets you:

• Create a new tweet
• Delete a tweet by ID
• Get a single tweet by ID with optional expansions and fields
• Get multiple tweets by IDs
• Get tweets from a user's timeline

All functions are callable directly from RobinPath scripts with a simple, consistent API.

Installation

robinpath add @robinpath/twitter

Quick Start

1. Set up credentials

twitter.setToken "AAAA...your-bearer-token"

2. Create a new tweet

twitter.createTweet "Hello from RobinPath!"

Available Functions

| Function | Description | |----------|-------------| | twitter.setToken | Store a Bearer token for X/Twitter API v2 authentication | | twitter.createTweet | Create a new tweet | | twitter.deleteTweet | Delete a tweet by ID | | twitter.getTweet | Get a single tweet by ID with optional expansions and fields | | twitter.getTweets | Get multiple tweets by IDs | | twitter.getUserTimeline | Get tweets from a user's timeline | | twitter.getMentions | Get tweets mentioning a user | | twitter.searchRecent | Search recent tweets (last 7 days) with a query | | twitter.getUser | Get a user by username | | twitter.getUserById | Get a user by their ID | | twitter.getMe | Get the authenticated user's profile | | twitter.getFollowers | Get followers of a user | | twitter.getFollowing | Get users that a user is following | | twitter.follow | Follow a user (uses authenticated user as source) | | twitter.unfollow | Unfollow a user | | twitter.like | Like a tweet (uses authenticated user) | | twitter.unlike | Unlike a tweet (uses authenticated user) | | twitter.getLikedTweets | Get tweets liked by a user | | twitter.retweet | Retweet a tweet (uses authenticated user) | | twitter.unretweet | Undo a retweet (uses authenticated user) | | twitter.getRetweeters | Get users who retweeted a tweet | | twitter.bookmark | Bookmark a tweet (uses authenticated user) | | twitter.removeBookmark | Remove a bookmarked tweet (uses authenticated user) | | twitter.getBookmarks | Get the authenticated user's bookmarked tweets | | twitter.createList | Create a new list | | twitter.deleteList | Delete a list | | twitter.addListMember | Add a user to a list | | twitter.removeListMember | Remove a user from a list | | twitter.getListTweets | Get tweets from a list | | twitter.sendDm | Send a direct message to a user | | twitter.getDmEvents | Get direct message events |

Examples

Create a new tweet

twitter.createTweet "Hello from RobinPath!"

Delete a tweet by ID

twitter.deleteTweet "1234567890"

Get a single tweet by ID with optional expansions and fields

twitter.getTweet "1234567890" {"tweet.fields": "created_at,public_metrics"}

Integration with RobinPath

import { RobinPath } from "@wiredwp/robinpath";
import Module from "@robinpath/twitter";

const rp = new RobinPath();
rp.registerModule(Module.name, Module.functions);
rp.registerModuleMeta(Module.name, Module.functionMetadata);

const result = await rp.executeScript(`
  twitter.setToken "AAAA...your-bearer-token"
  twitter.createTweet "Hello from RobinPath!"
`);

Full API Reference

See MODULE.md for complete documentation including all parameters, return types, error handling, and advanced examples.

Related Modules

• @robinpath/facebook — Facebook module for complementary functionality
• @robinpath/instagram — Instagram module for complementary functionality
• @robinpath/linkedin — LinkedIn module for complementary functionality
• @robinpath/tiktok — TikTok module for complementary functionality
• @robinpath/pinterest — Pinterest module for complementary functionality

License

MIT