# X

> X (Twitter)

- Skill: `spike-faye-lei/x` (Agent Skill, multi-file: 35 files)
- Install (CLI): `npx skillmds@latest add spike-faye-lei/x`
- Raw SKILL.md: https://api.skillmd.com/api/skills/spike-faye-lei/x/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: spike-faye-lei (https://skillmd.com/u/spike-faye-lei)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/spike-faye-lei/x

---

# X (Twitter)

## Overview
Social media and microblogging platform. Archetype: Social Media. GraphQL API with persisted query hashes, L3 adapter for dynamic hash resolution and request signing. REST v1.1/v2 endpoints for social graph and moderation actions.

## Workflows

### Browse timeline and interact
1. `getHomeTimeline` → tweets → `tweet_id`
2. `likeTweet(tweet_id)` / `createBookmark(tweet_id)` / `createRetweet(tweet_id)`

### Compose and manage tweets
1. `createTweet(text)` → `rest_id` (new tweet_id)
2. `reply(tweet_id, text)` → reply to a tweet → `rest_id`
3. `deleteTweet(tweet_id)` → delete your own tweet (tweet_id from createTweet `rest_id` or getHomeTimeline)

### Find and read a user's profile
1. `getUserByScreenName(screen_name)` → `rest_id` (userId), `name`, `followers_count`
2. `getUserTweets(userId)` → user's tweets → `tweet_id`
3. `getUserLikes(userId)` → user's liked tweets → `tweet_id`
4. `getUserFollowers(userId)` / `getUserFollowing(userId)` → follower/following `rest_id` list

### Manage social graph
1. `getUserByScreenName(screen_name)` → `rest_id`
2. `followUser(userId)` / `unfollowUser(userId)`
3. `blockUser(userId)` / `unblockUser(userId)`
4. `muteUser(userId)` / `unmuteUser(userId)`

### Search tweets
1. `searchTweets(rawQuery)` → tweet results with cursor pagination

### Get tweet with replies
1. `getTweetDetail(focalTweetId)` → full tweet thread with replies

### Moderate replies
1. `getTweetDetail(focalTweetId)` → reply entries → reply `tweet_id`
2. `hideReply(tweet_id)` / `unhideReply(tweet_id)` — hide/show replies on your tweets

### Direct messages
1. `getUserByScreenName(screen_name)` → `rest_id` (recipientId)
2. `sendDM(recipientId, text)` → DM event with `messageId` — approved contacts only

### Notifications and bookmarks
1. `getNotifications` → mentions, likes, retweets, follows
2. `getBookmarks` → your bookmarked tweets

### Trending / Explore
1. `getExplorePage` → trending topics, recommended content

## Operations

| Operation | Intent | Key Input | Key Output | Notes |
|-----------|--------|-----------|------------|-------|
| getHomeTimeline | home feed | count | tweets, cursors | entry point, paginated |
| getTweetDetail | tweet + replies | focalTweetId | tweet thread, reply entries | also serves as getThread |
| getUserByScreenName | user profile | screen_name | rest_id, name, bio, followers_count | entry point |
| searchTweets | search posts | rawQuery, product (Top/Latest) | tweet results, cursors | paginated |
| getUserTweets | user's tweets | userId ← getUserByScreenName rest_id | tweets, cursors | paginated |
| getUserFollowers | followers list | userId ← getUserByScreenName rest_id | user profiles, cursors | paginated |
| getUserFollowing | following list | userId ← getUserByScreenName rest_id | user profiles, cursors | paginated |
| getExplorePage | trending/explore | — | trending topics, timelines | entry point, also serves as getTrending |
| getUserLikes | user's liked tweets | userId ← getUserByScreenName rest_id | tweets, cursors | paginated |
| getBookmarks | your bookmarks | count | bookmarked tweets, cursors | paginated, own bookmarks only |
| getNotifications | notifications | count | mentions, likes, follows, retweets | paginated |
| createTweet | post a tweet | text | rest_id | write, CAUTION |
| deleteTweet | delete your tweet | tweet_id ← createTweet rest_id / getHomeTimeline | — | write, CAUTION |
| reply | reply to tweet | tweet_id ← getHomeTimeline / getTweetDetail, text | rest_id | write, CAUTION |
| likeTweet | like a tweet | tweet_id ← getHomeTimeline / searchTweets / getTweetDetail | — | write — verified PASS |
| unlikeTweet | unlike a tweet | tweet_id ← getHomeTimeline / searchTweets / getTweetDetail (or paired likeTweet) | — | write — verified PASS |
| createBookmark | bookmark tweet | tweet_id ← getHomeTimeline / searchTweets / getTweetDetail | — | write — verified PASS |
| deleteBookmark | remove bookmark | tweet_id ← getHomeTimeline / searchTweets / getTweetDetail (or paired createBookmark) | — | write — verified PASS |
| createRetweet | retweet | tweet_id ← getHomeTimeline / searchTweets / getTweetDetail | retweet rest_id | write — verified PASS |
| deleteRetweet | undo retweet | source_tweet_id ← getHomeTimeline / searchTweets / getTweetDetail (or paired createRetweet) | — | write — verified PASS |
| followUser | follow user | userId ← getUserByScreenName rest_id | user object | write, CAUTION — pair-order sensitive (see Known Limitations) |
| unfollowUser | unfollow user | userId ← getUserByScreenName rest_id (or paired followUser) | user object | write — verified PASS |
| blockUser | block user | userId ← getUserByScreenName rest_id | user object | write, CAUTION — pair-order sensitive (see Known Limitations) |
| unblockUser | unblock user | userId ← getUserByScreenName rest_id (or paired blockUser) | user object | write — verified PASS |
| muteUser | mute user | userId ← getUserByScreenName rest_id | user object | write, CAUTION — page-lifecycle issue (see Known Limitations) |
| unmuteUser | unmute user | userId ← getUserByScreenName rest_id (or paired muteUser) | user object | write, CAUTION — page-lifecycle issue (see Known Limitations) |
| hideReply | hide reply | tweet_id ← getTweetDetail reply entries (or pinned fixture id) | hidden: true | write — verified PASS via permanent fixture |
| unhideReply | unhide reply | tweet_id ← getTweetDetail reply entries (or pinned fixture id) | hidden: false | write — verified PASS via permanent fixture |
| sendDM | send DM | recipientId ← getUserByScreenName rest_id, text | messageId, DM event | write, CAUTION, approved contacts |

## Quick Start

```bash
# Get home timeline
openweb x exec getHomeTimeline '{"count": 20}'

# Search tweets
openweb x exec searchTweets '{"rawQuery": "openai", "count": 20, "product": "Latest"}'

# Get user profile
openweb x exec getUserByScreenName '{"screen_name": "openai"}'

# Get tweet detail (also serves as getThread)
openweb x exec getTweetDetail '{"focalTweetId": "1234567890"}'

# Get user's followers (need userId from getUserByScreenName → rest_id)
openweb x exec getUserFollowers '{"userId": "4398626122", "count": 20}'

# Create a tweet
openweb x exec createTweet '{"text": "Hello from OpenWeb!"}'

# Reply to a tweet
openweb x exec reply '{"tweet_id": "1234567890", "text": "Great thread!"}'

# Follow a user
openweb x exec followUser '{"userId": "4398626122"}'

# Send a DM (approved contacts only)
openweb x exec sendDM '{"recipientId": "4398626122", "text": "Hey!"}'

# Get notifications
openweb x exec getNotifications '{"count": 20}'

# Get your bookmarks
openweb x exec getBookmarks '{"count": 20}'

# Get user's liked tweets
openweb x exec getUserLikes '{"userId": "4398626122", "count": 20}'
```

## Known Limitations

- **Open `https://x.com/home` in the managed Chrome (port 9222) before running write ops.** The site declares `page_plan.entry_url=https://x.com/home` with `warm: true`, but a runtime cascade can leave verify holding a stale browser handle if no x.com tab is already open at start. Pre-warming the tab also ensures cookies, ct0 CSRF, and the webpack signing module are hydrated.
- **Never use your own userId as a follow/block/mute target.** Twitter returns 403 (`code 158/147/271 — "you can't <verb> yourself"`) which the runtime maps to `needs_login`, triggering a 45 s cascade-timeout per op. Use a stable third-party account (e.g. `@XDevelopers` id `2244994945`) for testing. Destroy variants (unfollow/unblock/unmute) return 200 no-op even on self, masking the issue if you only check those.
- **`hideReply` / `unhideReply` require a cross-account reply.** Twitter blocks moderating own replies on own thread (returns DRIFT — `tweet_moderate_put: Done` only fires for foreign replies). The pinned fixture id `2046061970021847164` is a reply by `@QGuo219895` on `@iamoonkey/2045749343437619246` — both fixtures hard-code this id; `unhideReply` chains via `order: 19` after `hideReply`'s `order: 18`. The transport is GraphQL `ModerateTweet` / `UnmoderateTweet` (NOT the legacy REST `PUT /i/api/2/tweets/{id}/hidden`, which has been removed and hangs 45 s). No re-seeding needed between runs as long as the parent reply isn't deleted by the alt account.
- **Verified write ops:** `likeTweet`, `unlikeTweet`, `createBookmark`, `deleteBookmark`, `createRetweet`, `deleteRetweet`, `unblockUser`, `unfollowUser`, plus all 6 user/reply ops in standalone `pnpm dev x exec` runs after the 2026-04-19 fixture refresh. Aggregate `verify --write` still loses the create-side ops to cascade churn — see DOC.md "Verify quirk".