Skip to content
TakoAPI
Back to skills

x-smart-read

by nevaaron

Browser & Automation
346Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Personal X (Twitter) analytics — timeline engagement, mentions, follower tracking, read any tweet/thread.

Description

What This Skill Does

Personal X (Twitter) analytics agent for monitoring your account's posts, mentions, engagement, and follower changes. Reads tweets and threads by URL or ID, manages bookmarks, and generates combined daily briefings. Tracks API spend against a configurable daily budget to avoid unexpected costs.

Combining timeline, mentions, and profile into a single cached briefing command avoids redundant API calls that would cost 3x as much when running each script separately.

When to Use It

  • Morning briefing of overnight X engagement
  • Checking if a specific tweet gained traction
  • Reading a thread someone linked you
  • Tracking follower count changes over the week
  • Accountability check on how much time you're spending on X

Example Workflow

INPUT

User asks: how did my posts do this week?

AGENT
  1. 1

    Run x_timeline.py top --days 7 to pull top posts from local store at no cost

  2. 2

    Display engagement metrics for each post

  3. 3

    If user asks about a specific post, run x_timeline.py refresh TWEET_ID for updated metrics

  4. 4

    Check today's spend total from command output before making additional calls

OUTPUT

Ranked list of top posts from the past 7 days with like, retweet, and reply counts, plus current spend total

Requirements

  • X API v2 credentials (API key, API secret, access token, access token secret, bearer token) from developer.twitter.com
  • X Developer account with at least Basic tier access

Installation

clawhub install nevaaron/x-smart-read

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links