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.