Timeline Viewing
Apps & Automationtimeline-viewingTimeline Viewing is an Agent Skill for apps & automation published in the nirholas/XActions repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
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.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/nirholas/XActions/blob/HEAD/skills/timeline-viewing/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/timeline-viewing, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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