How do I install the Timeline Viewing skill?

Run npx skillmds@latest add nirholas/timeline-viewing in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Timeline Viewing safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Timeline Viewing?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Timeline Viewing free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under Apache-2.

Who published Timeline Viewing?

nirholas (@nirholas) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Timeline Viewing by nirholas — Agent Skill

Name: Timeline Viewing
Author: nirholas

File contents

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-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

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

---name: timeline-viewingdescription: 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.license: Apache-2.0---# Timeline Viewing & ScrapingBrowser 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 Start1. Go to `x.com/home`2. Open DevTools (F12) → Console3. Paste `src/timelineViewer.js` → Enter4. JSON file auto-downloads when complete## Configuration (`timelineViewer.js`)```jsconst 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```js// timelineViewer.jsXActions.switchTo('for-you') // Switch to For You timelineXActions.switchTo('following') // Switch to Following timelineXActions.collect() // Start collecting postsXActions.export() // Export collected posts as JSONXActions.abort() // Stop collection// timelineScraper.jsXActions.scrape({ maxPosts: 200 }) // Scrape with custom limitXActions.results() // Get collected resultsXActions.download() // Download as JSON```## Output Data StructureEach 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## 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

Frequently asked questions

Timeline Viewing