ReddRadar
Agent skill
timeline-viewing
Switch between For You / Following timelines, auto-scroll and collect posts, scrape timeline data, and export as JSON. Use when users want to browse, collect, or export tweets from their X timeline.
Install this agent skill to your Project
npx add-skill https://github.com/nirholas/XActions/tree/main/skills/timeline-viewing
Metadata
Additional technical details for this skill
- author
- nichxbt
- version
- 1.0
SKILL.md
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
- Go to
x.com/home - Open DevTools (F12) → Console
- Paste
src/timelineViewer.js→ Enter - 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-youcontent is personalized;followingshows only accounts you follow- Increase
maxPostsfor deeper scrapes (slower, more scroll rounds) - Different from
twitter-scrapingwhich targets specific profiles, not your feed
Related Skills
- 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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
nirholas/XActions
articles-longform
Compose, preview, publish, and manage long-form Articles on X/Twitter. Premium+ feature. Includes article creation, formatting, media insertion, and performance tracking. Use when users want to write, publish, manage, or analyze X Articles.
nirholas/XActions
x-pro-management
Navigate to X Pro (TweetDeck), set up monitoring columns, and manage multi-column view. Use when users want to use X Pro / TweetDeck features or set up a multi-column dashboard.
nirholas/XActions
business-ads
Manages X/Twitter business intelligence including brand monitoring, audience insights, competitor analysis, tweet A/B testing, auto-plug replies for promotion, and content performance optimization. Use when users want brand monitoring, audience analysis, competitor comparison, or promotion optimization on X.
nirholas/XActions
engagement-interaction
Automates X/Twitter engagement actions — like, unlike, reply, bookmark, hide replies, and auto-like by keyword. Also bulk-unlikes all posts. Use when users want to automate likes, send replies, manage bookmarks on tweets, hide replies, or clear their entire likes history.
nirholas/XActions
unfollow-management
Mass unfollow on X/Twitter via browser console scripts. Unfollows everyone, only non-followers, non-followers with username logging, smart time-based unfollow with whitelists, and follow/following ratio management. Use when cleaning up a following list, removing non-followers, bulk unfollowing accounts, or optimizing your follow ratio.
nirholas/XActions
follower-monitoring
Monitors X/Twitter follower changes using browser console scripts. Detects who unfollowed, tracks new followers with welcome messages, monitors any public account, runs continuous monitoring with alerts, tracks follower growth over time, and analyzes follower demographics. Use when tracking follower changes, detecting unfollowers, or monitoring Twitter accounts.
Didn't find tool you were looking for?