mcpField
S
storyclaw-x-manager

storyclaw-x-manager

github.com/storyclaw-officialMarketing & growth046 installsUpdated today
Repository

About storyclaw-x-manager

storyclaw-x-manager is a skill for managing X accounts through posting, engagement, timeline access, search, and analytics. It supports per-user credentials and keyword-based auto-replies.

Key features

  1. 01Publish and split long posts
  2. 02Like, reply to, and repost
  3. 03Read user posts and timelines
  4. 04Search posts
  5. 05Configure keyword-based auto-replies

Use cases

  1. 01Publish updates to an X account
  2. 02Review an account timeline or search posts
  3. 03Automate replies to selected keywords

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/storyclaw-official/talenthub --skill storyclaw-x-manager

After installing, type/storyclaw-x-managerin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.gitignore
credentials/
example.json
scripts/
get_timeline.py
get_user_tweets.py
like_tweet.py
post_tweet.py
reply_tweet.py
retweet.py
search_tweets.py

Details

From the project README

X Manager - Twitter/X Account Management

Manage X (formerly Twitter) accounts: posting, engagement, timeline, and analytics.

Multi-User Architecture

Each user's credentials are stored in credentials/{USER_ID}.json:

{
  "twitter": {
    "api_key": "",
    "api_secret": "",
    "access_token": "",
    "access_token_secret": "",
    "bearer_token": ""
  }
}

If user has no Twitter credentials configured, prompt them to bind their X account first.

Or set env vars: TWITTER_API_KEY, TWITTER_API_SECRET, TWITTER_ACCESS_TOKEN, TWITTER_ACCESS_TOKEN_SECRET, TWITTER_BEARER_TOKEN.

Supported Operations

1. Post Tweet
python3 {baseDir}/scripts/post_tweet.py <USER_ID> "<tweet content>" [--media <image_path>]

Max 280 characters. Longer tweets auto-split for Premium/Enterprise accounts.

2. Engagement

Like:

python3 {baseDir}/scripts/like_tweet.py <USER_ID> <tweet_id>

Reply:

python3 {baseDir}/scripts/reply_tweet.py <USER_ID> <tweet_id> "<reply content>"

Retweet:

python3 {baseDir}/scripts/retweet.py <USER_ID> <tweet_id>
3. Data Retrieval

User tweets:

python3 {baseDir}/scripts/get_user_tweets.py <USER_ID> <twitter_handle> [--count <n>]

Timeline:

python3 {baseDir}/scripts/get_timeline.py <USER_ID> [--count <n>]

Search:

python3 {baseDir}/scripts/search_tweets.py <USER_ID> "<keywords>" [--count <n>]

Auto-Interaction Workflow

Configure in state/{USER_ID}.json:

{
  "auto_reply": {
    "enabled": true,
    "keywords": ["keyword1", "keyword2"],
    "reply_template": "Thanks {username} for {keyword}!"
  }
}

Error Handling

  • API rate limit: prompt user to wait and retry
  • Auth failure: prompt user to rebind X account
  • Tweet too long: auto-split or prompt user to shorten

Twitter API Tiers

  • Free: read only, no posting
  • Premium ($100/month): post + analytics
  • Enterprise: higher limits

Comments

Markdown supported