search-tweets

Search X tweets by keyword, hashtag, or filters and export results.

177|17|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/Xquik-dev/x-twitter-scraper --skill search-tweets
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: search-tweets
Source: https://github.com/Xquik-dev/x-twitter-scraper/tree/main/skills/search-tweets
Command: npx skills add https://github.com/Xquik-dev/x-twitter-scraper --skill search-tweets

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables AI agents to search X (Twitter) for tweets matching a keyword, phrase, hashtag, from-user, date range, language, or engagement filters, and returns tweet IDs, text, authors, metrics, and timestamps for downstream processing.

Core Features & Use Cases

  • Live search: paginate small result sets for real-time monitoring.
  • Bulk extraction: retrieve up to 1,000 tweets per job with optional export formats (CSV/JSON/MD) and status tracking.
  • Flexible query syntax: supports standard operators like from:, to:, #tag, lang:, since:, until:, min_faves:, min_retweets:, and filter:media/verified.

Quick Start

Provide a query and choose either live search or bulk extraction to begin retrieving tweets immediately.

Frequently Asked Questions about search-tweets

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search tweets by keyword and extract the results in bulk?▼

Live tweet search provides small, paginated result sets for real-time monitoring, returning tweet IDs, text, authors, metrics, and timestamps directly from the current X platform feed.

Can I filter Twitter search results by date range, language, and minimum retweets?▼

Yes, you can filter Twitter search results by date range, language, minimum retweets, and minimum favorites using standard query operators like since:, until:, lang:, min_retweets:, and min_faves: within your search query string.

What query syntax is supported for searching tweets from a specific user or hashtag?▼

Searching tweets from a specific user or hashtag supports standard query syntax including from:, to:, #tag, filter:media, and filter:verified operators to refine results by author, mention, topic, or content type.

How do I export extracted tweets to CSV or JSON after a bulk extraction job completes?▼

Bulk tweet extraction has a known limitation of supporting a maximum of 1,000 tweets per job, requiring multiple jobs or paginated live search for larger data extraction requirements.