⚡ XActions
🎯 Agent Skills

Timeline Viewing & Scraping

Browser console scripts for viewing, switching, and collecting posts from your X timeline.

Script Selection

Goal File Navigate to
Switch timeline, auto-scroll, export posts src/timelineViewer.js x.com/home
Scrape timeline posts into structured data src/timelineScraper.js x.com/home

Quick Start

  1. Go to x.com/home
  2. Open DevTools (F12) → Console
  3. Paste src/timelineViewer.js → Enter
  4. JSON file auto-downloads when complete

Configuration (timelineViewer.js)

const CONFIG = {
  timeline: 'for-you',       // 'for-you' or 'following'
  autoSwitch: true,           // Automatically switch to selected timeline
  collectPosts: true,         // Scroll and collect posts
  maxPosts: 100,              // Max posts to collect
  exportData: true,           // Auto-download JSON when done
  scrollDelay: 2000,          // ms between scroll actions
  delayBetweenActions: 1500, // ms between UI actions
  maxScrollRetries: 8,        // Empty scrolls before stopping
};

Available Functions

// timelineViewer.js
XActions.switchTo('for-you')     // Switch to For You timeline
XActions.switchTo('following')   // Switch to Following timeline
XActions.collect()               // Start collecting posts
XActions.export()                // Export collected posts as JSON
XActions.abort()                 // Stop collection

// timelineScraper.js
XActions.scrape({ maxPosts: 200 }) // Scrape with custom limit
XActions.results()                  // Get collected results
XActions.download()                 // Download as JSON

Output Data Structure

Each collected post includes:

  • Tweet ID, author, handle, avatar
  • Tweet text, timestamp
  • Likes, retweets, replies, views counts
  • Media URLs (if any)
  • Is retweet / is quote tweet

Notes

  • Timeline data is only what's visible/scrolled in your browser session
  • for-you content is personalized; following shows only accounts you follow
  • Increase maxPosts for deeper scrapes (slower, more scroll rounds)
  • Different from twitter-scraping which targets specific profiles, not your feed
  • twitter-scraping — Scrape a specific user's profile or tweet history
  • analytics-insights — Analyze engagement metrics on your timeline
  • discovery-explore — Find trending content beyond your timeline

⚡ Free and open source

No API keys, no monthly fees, no signup. Star the repo if it saved you a subscription.

View on GitHub