x-tweet-by-handle

Scrapes tweets from an X user profile timeline with pagination and normalized per-tweet data.

5.5k|269|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/browser-act/skills --skill x-tweet-by-handle
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: x-tweet-by-handle
Source: https://github.com/browser-act/skills/tree/main/solutions/social-listening/x-tweet-by-handle
Command: npx skills add https://github.com/browser-act/skills --skill x-tweet-by-handle

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Collecting tweets from a specific X (Twitter) account manually is slow and error-prone, especially when you need replies, media-only posts, or large paginated histories for research, monitoring, or competitor analysis.

Core Features & Use Cases

  • Timeline Mode Selection: Scrape a user's default tweets tab, tweets-and-replies tab, or media-only tab by handle.
  • Normalized Tweet Output: Returns structured JSON per tweet including text, author profile, engagement counts, hashtags, mentions, media, and pagination cursors.
  • Scroll-Based Pagination: Captures GraphQL responses (UserTweets, UserTweetsAndReplies, UserMedia) from network traffic and paginates via cursor until a target count or termination condition is reached.
  • Use Case: Track a competitor or KOL account by exporting their recent tweets and engagement metrics into a dataset for social listening analysis.

Quick Start

Scrape the latest 100 tweets from the X handle @NASA including engagement counts and media.

Frequently Asked Questions about x-tweet-by-handle

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

FAQPage Schema
How do I scrape all tweets from a Twitter user by handle?

Provide the X handle without @ and choose a mode: tweets, replies, or media. The Skill navigates to the profile, captures the UserTweets GraphQL response from network traffic, and paginates by scrolling until your target count is reached.

How to scrape only media tweets from an X account?

Use the media mode, which opens the profile's media tab and captures the UserMedia endpoint. X filters these server-side, so only tweets containing native photos or videos are returned; pure-text tweets are skipped.

Does scraping X tweets require being logged in?

Yes, an active logged-in X session in the browser is required. The Skill only reads data already visible to the logged-in user and never bypasses authentication; protected accounts return zero tweets unless the session follows them.

Why does tweet scraping stop or return empty pages?

Pagination terminates when a page returns zero tweets, the bottom cursor stops advancing, or the account is suspended or deleted. Sustained polling can also trigger X rate limits, so stay under roughly 150 timeline calls per 15-minute window per session.

What data fields are returned for each scraped tweet?

Each tweet includes id, URL, full text, created_at, language, engagement counts (likes, retweets, replies, quotes, bookmarks, views), hashtags, mentions, media with video variants, and a full author profile object with followers and verification status.