n8n-nodes-twitter-scraper

n8n-nodes-twitter-scraper

This is an n8n community node. It lets you use Twitter (X) in your n8n workflows without requiring the official API.

Twitter is a social media platform where users post and interact with messages known as "tweets". This node allows you to interact with Twitter through web scraping techniques, avoiding Twitter API restrictions and costs.

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Compatibility
Usage
Resources
Version history

Installation

Follow the installation guide in the n8n community nodes documentation.

pnpm i n8n-nodes-twitter-scraper

Alternatively, you can install it directly from the n8n UI:

Operations

This node provides operations for two resources: Tweets and Users.

Tweet Operations

• Create: Create, quote, or reply to a tweet
• Delete: Delete a tweet
• Upload Media: Upload media and return a media ID for use in tweets
• Retweet: Retweet a tweet
• Unretweet: Unretweet a tweet
• Like: Like a tweet
• Unlike: Unlike a tweet
• Search: Search for tweets, with options for filtering by date, user, and more

User Operations

• Get User: Get user details by username
• Get Timeline: Get a user's timeline by username

Credentials

This node uses the Rettiwt-API under the hood, which requires an API key. The API key is used for authentication with Twitter's web interface, not the official API.

To obtain the API key check out the Rettiwt-API documentation.

Compatibility

• Minimum n8n version: Latest regular release
• Requires Node.js v18.10 or later
• Compatible with both n8n desktop and cloud environments

Resources

• n8n community nodes documentation
• Rettiwt-API documentation
• Project repository

Version history

Check out the commit history for version details.

Development

Prerequisites

• Node.js version 18.10 or later
• pnpm (for package management)
• n8n (for testing)

Install n8n

npm install -g n8n

Setup for Development

• Clone the repository

git clone https://github.com/AlejandroAkbal/n8n-nodes-twitter-scraper.git
cd n8n-nodes-twitter-scraper

• Install dependencies

pnpm install

• Build the project

pnpm build

Local Development Workflow

• Start the development build

rm -rf ./dist

pnpm build

• Link to your local n8n installation for testing

pnpm link --global

mkdir -p ~/.n8n/custom/n8n-nodes-twitter-scraper

cd ~/.n8n/custom/n8n-nodes-twitter-scraper

pnpm link n8n-nodes-twitter-scraper

• Start n8n with your linked node

n8n start

Publishing

• Update the version in package.json
• Build the project

pnpm build

• Publish to npm

pnpm publish

Merging from upstream

To merge changes from the upstream n8n-nodes-starter repository:

# Add the upstream repository as a remote
git remote add upstream https://github.com/n8n-io/n8n-nodes-starter.git

# Fetch the changes from the upstream repository
git fetch upstream

# Merge the changes from the upstream master branch
git merge upstream/master --allow-unrelated-histories

# Resolve any merge conflicts and commit the changes