x-search-quote

Package Information

Released: 5/29/2025
Downloads: 209 weekly / 209 monthly
Latest Version: 1.0.3
Author: winding_iv

Available Nodes

X
Interact with X (Twitter) API

Documentation

n8n-nodes-x-search-quote

n8n.io - Workflow Automation

An n8n community node for X (Twitter) search, quote, and AI-powered engagement automation.

Features

  • X Search: Search for tweets using advanced operators
  • Quote Tweets: Quote and reply to tweets with AI-generated content
  • User Lookup: Find and verify X user accounts
  • Rate Limiting: Built-in respect for X API rate limits
  • AI Integration: Works with various AI models for content generation

Installation

Follow the installation guide in the n8n community nodes documentation.

Community Nodes (Recommended)

  1. Go to Settings > Community Nodes in your n8n instance
  2. Select Install
  3. Enter n8n-nodes-x-search-quote
  4. Agree to the risks of using community nodes
  5. Select Install

Manual Installation

To get started with this community node:

# Install in your n8n root folder
npm install n8n-nodes-x-search-quote

For Docker users:

# In your n8n Docker setup
npm install n8n-nodes-x-search-quote

Configuration

X API Credentials

You'll need to set up X API credentials:

  1. Go to X Developer Portal
  2. Create a new app or use an existing one
  3. Generate API keys and tokens
  4. In n8n, create new X credentials with:
    • API Key
    • API Secret Key
    • Access Token
    • Access Token Secret

Node Operations

The X node supports several operations:

  • Search Tweets: Find tweets using X's search operators
  • Quote Tweet: Quote an existing tweet with your content
  • Reply to Tweet: Reply to a specific tweet
  • Get User by Username: Look up user information
  • Get Tweet: Retrieve specific tweet details

Usage Examples

Basic Tweet Search

{
  "operation": "searchTweets",
  "query": "n8n automation",
  "maxResults": 10
}

Quote a Tweet

{
  "operation": "quoteTweet",
  "tweetId": "1234567890",
  "text": "Great insights on automation! 🤖"
}

AI-Powered Engagement Workflow

Check out the included workflow example in /workflows/x-search-quote.json for a complete automation that:

  1. Searches for relevant tweets
  2. Uses AI to generate engaging responses
  3. Quotes or replies with rate limiting

Workflow Template

This package includes a sample workflow (x-search-quote.json) that demonstrates:

  • Scheduled tweet searching
  • AI-powered content generation
  • Automated engagement with rate limiting
  • User verification and filtering

Rate Limiting

The node includes built-in rate limiting to respect X's API limits:

  • Search: 300 requests per 15-minute window
  • Tweet operations: 300 requests per 15-minute window
  • User lookup: 300 requests per 15-minute window

Requirements

  • n8n version 0.174.0 or later
  • X API v2 access (Basic tier or higher)
  • Valid X Developer account

Resources

License

MIT

Support

For issues and feature requests, please use the GitHub issues page.

Contributing

Contributions are welcome! Please read our contributing guidelines before submitting PRs.

Note: This is a community-maintained node. Use at your own risk and ensure compliance with X's Terms of Service and API usage policies.

Discussion