mcpField
X
x-user-timeline

x-user-timeline

github.com/b-open-ioProductivity1666 installsUpdated 4w ago
Repository

About x-user-timeline

x-user-timeline is a skill that retrieves recent tweets for a specified X user. It runs a shell script with an X bearer token and returns tweet text, timestamps, metrics, and author details.

Key features

  1. 01Fetch recent tweets by user
  2. 02Choose the maximum result count
  3. 03Return timestamps and tweet text
  4. 04Include public engagement metrics
  5. 05Expand author information

Use cases

  1. 01Reviewing a user's latest posts
  2. 02Retrieving a specified number of tweets
  3. 03Checking likes, reposts, replies, and views

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/b-open-io/prompts --skill x-user-timeline

After installing, type/x-user-timelinein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.clawnet/
unsigned-skill.json
scripts/
setup.sh
timeline.sh

Details

From the project README

X User Timeline

Get recent tweets from a specific user.

Setup

export X_BEARER_TOKEN="your-token"  # https://developer.x.com/en/portal/dashboard

Usage

${CLAUDE_SKILL_DIR}/scripts/timeline.sh <username> [max_results]

Examples

# Get 10 recent tweets (default)
${CLAUDE_SKILL_DIR}/scripts/timeline.sh kurtwuckertjr

# Get 25 tweets
${CLAUDE_SKILL_DIR}/scripts/timeline.sh kurtwuckertjr 25

Response Fields

  • text - Tweet content
  • created_at - Post timestamp
  • public_metrics - Likes, retweets, replies, views
  • author - User info (expanded)

Pricing and Rate Limits

X API access is pay-per-use. Read the endpoint's rate-limit response headers and consult the current X API pricing and rate-limit documentation instead of assuming a fixed free-tier quota.

References

Comments

Markdown supported