SKILL.md

Twitter/X Data Skill

Query Twitter/X data from the 6551 platform REST API. All endpoints require a Bearer token via $OPENNEWS_TOKEN.

Get your token: http://app.newsliquid.com/mcp

Base URL: https://ai.6551.io

Authentication

All requests require the header:

Authorization: Bearer $OPENNEWS_TOKEN

Twitter Operations

1. Get Twitter User Info

Get user profile by username.

curl -s -X POST "https://ai.6551.io/open/twitter_user_info" \

  -H "Authorization: Bearer $OPENNEWS_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{"username": "elonmusk"}'

2. Get Twitter User by ID

Get user profile by numeric ID.

curl -s -X POST "https://ai.6551.io/open/twitter_user_by_id" \

  -H "Authorization: Bearer $OPENNEWS_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{"userId": "44196397"}'

3. Get User Tweets

Get recent tweets from a user.

curl -s -X POST "https://ai.6551.io/open/twitter_user_tweets" \

  -H "Authorization: Bearer $OPENNEWS_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{"username": "elonmusk", "maxResults": 20, "product": "Latest"}'

Parameter	Type	Default	Description
`username`	string	required	Twitter username (without @)
`maxResults`	integer	20	Max tweets (1-100)
`product`	string	"Latest"	"Latest" or "Top"
`includeReplies`	boolean	false	Include reply tweets
`includeRetweets`	boolean	false	Include retweets

4. Search Twitter

Search tweets with various filters.

curl -s -X POST "https://ai.6551.io/open/twitter_search" \

  -H "Authorization: Bearer $OPENNEWS_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{"keywords": "bitcoin", "maxResults": 20, "product": "Top"}'

Search from specific user:

curl -s -X POST "https://ai.6551.io/open/twitter_search" \

  -H "Authorization: Bearer $OPENNEWS_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{"fromUser": "VitalikButerin", "maxResults": 20}'

Search by hashtag:

curl -s -X POST "https://ai.6551.io/open/twitter_search" \

  -H "Authorization: Bearer $OPENNEWS_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{"hashtag": "crypto", "minLikes": 100, "maxResults": 20}'

Twitter Search Parameters

Parameter	Type	Default	Description
`keywords`	string	-	Search keywords
`fromUser`	string	-	Tweets from specific user
`toUser`	string	-	Tweets to specific user
`mentionUser`	string	-	Tweets mentioning user
`hashtag`	string	-	Filter by hashtag (without #)
`excludeReplies`	boolean	false	Exclude reply tweets
`excludeRetweets`	boolean	false	Exclude retweets
`minLikes`	integer	0	Minimum likes threshold
`minRetweets`	integer	0	Minimum retweets threshold
`minReplies`	integer	0	Minimum replies threshold
`sinceDate`	string	-	Start date (YYYY-MM-DD)
`untilDate`	string	-	End date (YYYY-MM-DD)
`lang`	string	-	Language code (e.g. "en", "zh")
`product`	string	"Top"	"Top" or "Latest"
`maxResults`	integer	20	Max tweets (1-100)

5. Get Follower Events

Get new followers or unfollowers for a user.

# Get new followers

curl -s -X POST "https://ai.6551.io/open/twitter_follower_events" \

  -H "Authorization: Bearer $OPENNEWS_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{"username": "elonmusk", "isFollow": true, "maxResults": 20}'

# Get unfollowers

curl -s -X POST "https://ai.6551.io/open/twitter_follower_events" \

  -H "Authorization: Bearer $OPENNEWS_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{"username": "elonmusk", "isFollow": false, "maxResults": 20}'

Parameter	Type	Default	Description
`username`	string	required	Twitter username (without @)
`isFollow`	boolean	true	true=new followers, false=unfollowers
`maxResults`	integer	20	Max events (1-100)

6. Get Deleted Tweets

Get deleted tweets from a user.

curl -s -X POST "https://ai.6551.io/open/twitter_deleted_tweets" \

  -H "Authorization: Bearer $OPENNEWS_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{"username": "elonmusk", "maxResults": 20}'

Parameter	Type	Default	Description
`username`	string	required	Twitter username (without @)
`maxResults`	integer	20	Max tweets (1-100)

7. Get KOL Followers

Get which KOLs (Key Opinion Leaders) are following a user.

curl -s -X POST "https://ai.6551.io/open/twitter_kol_followers" \

  -H "Authorization: Bearer $OPENNEWS_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{"username": "elonmusk"}'

Parameter	Type	Default	Description
`username`	string	required	Twitter username (without @)

8. Get Twitter Article by ID

Get Twitter article by ID.

curl -s -X POST "https://ai.6551.io/open/twitter_article_by_id" \

  -H "Authorization: Bearer $OPENNEWS_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{"id": "article_id"}'

Parameter	Type	Default	Description
`id`	string	required	Twitter article ID

9. Get Tweet by ID

Get a specific tweet by its ID, including nested reply/quote tweets.

This endpoint retrieves a tweet by ID and automatically fetches any tweets it replies to or quotes, providing complete context.

curl -s -X POST "https://ai.6551.io/open/twitter_tweet_by_id" \

  -H "Authorization: Bearer $OPENNEWS_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{"twId": "2030318958512164966"}'

Parameter	Type	Default	Description
`twId`	string	required	Twitter tweet ID (numeric)

Response includes:

Main tweet data

replyStatus: The tweet being replied to (if applicable)

quotedStatus: The tweet being quoted (if applicable)

10. Get Quote Tweets by ID

Get tweets that quote a specific tweet.

curl -s -X POST "https://ai.6551.io/open/twitter_quote_tweets_by_id" \

  -H "Authorization: Bearer $OPENNEWS_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{"id": "2030318958512164966", "maxResults": 20}'

Parameter	Type	Default	Description
`id`	string	required	Twitter tweet ID (numeric)
`maxResults`	integer	20	Max tweets (1-100)

11. Get Retweet Users by ID

Get users who retweeted a specific tweet.

curl -s -X POST "https://ai.6551.io/open/twitter_retweet_users_by_id" \

  -H "Authorization: Bearer $OPENNEWS_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{"id": "2030318958512164966"}'

Parameter	Type	Default	Description
`id`	string	required	Twitter tweet ID (numeric)
`cursor`	string	-	Pagination cursor for next page

12. Get Twitter Watch List

Get all Twitter monitoring users for the current user.

curl -s -X POST "https://ai.6551.io/open/twitter_watch" \

  -H "Authorization: Bearer $OPENNEWS_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{}'

13. Add Twitter Watch

Add a Twitter user to monitoring list.

curl -s -X POST "https://ai.6551.io/open/twitter_watch_add" \

  -H "Authorization: Bearer $OPENNEWS_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{"username": "elonmusk", "newTweetBol": true, "newFlwBol": false}'

Parameter	Type	Default	Description
`username`	string	required	Twitter username (without @)
`newTweetBol`	boolean	true (server)	Monitor new tweets
`newFlwBol`	boolean	false (server)	Monitor new followers
`newUnFlwBol`	boolean	false (server)	Monitor unfollowers
`newTweetReplyBol`	boolean	true (server)	Monitor tweet replies
`newTweetQuoteBol`	boolean	true (server)	Monitor quote tweets
`newRetweetBol`	boolean	true (server)	Monitor retweets
`updateNameBol`	boolean	true (server)	Monitor username changes
`updateDescBol`	boolean	true (server)	Monitor bio/description changes
`updateAvatarBol`	boolean	true (server)	Monitor profile picture changes
`updateBannerBol`	boolean	true (server)	Monitor banner image changes
`newCaBol`	boolean	false (server)	Monitor CA (contract address) events
`tweetToppingBol`	boolean	false (server)	Monitor tweet pinning events

14. Delete Twitter Watch

Delete a Twitter user from monitoring list by username.

curl -s -X POST "https://ai.6551.io/open/twitter_watch_delete" \

  -H "Authorization: Bearer $OPENNEWS_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{"username": "elonmusk"}'

Parameter	Type	Default	Description
`username`	string	required	Twitter username to delete (without @)

WebSocket Real-time Subscriptions

Endpoint: wss://ai.6551.io/open/twitter_wss?token=YOUR_TOKEN

Subscribe to real-time events from your monitored Twitter accounts.

Heartbeat

To keep the connection alive, the client can send ping, and the server responds with pong.

Subscribe to Twitter Events

{

  "jsonrpc": "2.0",

  "id": 1,

  "method": "twitter.subscribe"

}

Response:

{

  "jsonrpc": "2.0",

  "id": 1,

  "result": {

    "success": true

  }

}

Unsubscribe

{

  "jsonrpc": "2.0",

  "id": 2,

  "method": "twitter.unsubscribe"

}

Server Push - Twitter Event

When a monitored account has activity, the server pushes:

{

  "jsonrpc": "2.0",

  "method": "twitter.event",

  "params": {

    "id": 123456,

    "twAccount": "elonmusk",

    "twUserName": "Elon Musk",

    "profileUrl": "https://twitter.com/elonmusk",

    "eventType": "NEW_TWEET",

    "content": "...",

    "ca": "0x1234...",

    "remark": "Custom note",

    "createdAt": "2026-03-06T10:00:00Z"

  }

}

Note: The content field structure varies by event type (see below).

**Event Types and Content Structure**:

#### Tweet Events

- `NEW_TWEET` - New tweet posted

- `NEW_TWEET_REPLY` - New reply tweet

- `NEW_TWEET_QUOTE` - New quote tweet

- `NEW_RETWEET` - Retweeted

- `CA` - Tweet with CA address

Content structure for tweet events:

{

"id": "1234567890",

"text": "Tweet content...",

"createdAt": "2026-03-06T10:00:00Z",

"language": "en",

"retweetCount": 100,

"favoriteCount": 500,

"replyCount": 20,

"quoteCount": 10,

"viewCount": 10000,

"userScreenName": "elonmusk",

"userName": "Elon Musk",

"userIdStr": "44196397",

"userFollowers": 170000000,

"userVerified": true,

"conversationId": "1234567890",

"isReply": false,

"isQuote": false,

"hashtags": ["crypto", "bitcoin"],

"media": [

{

"type": "photo",

"url": "https://...",

"thumbUrl": "https://..."

}

"urls": [

{

"url": "https://...",

"expandedUrl": "https://...",

"displayUrl": "example.com"

}

"mentions": [

{

"username": "VitalikButerin",

"name": "Vitalik Buterin"

}

]

}


#### Follower Events

- `NEW_FOLLOWER` - New follower

- `NEW_UNFOLLOWER` - Unfollower event

Content structure for follower events (array):

[

{

"id": 123,

"twId": 44196397,

"twAccount": "elonmusk",

"twUserName": "Elon Musk",

"twUserLabel": "Verified",

"description": "User bio...",

"profileUrl": "https://...",

"bannerUrl": "https://...",

"followerCount": 170000000,

"friendCount": 500,

"createdAt": "2026-03-06T10:00:00Z"

}

]


#### Profile Update Events

- `UPDATE_NAME` - Username changed (content: new name string)

- `UPDATE_DESCRIPTION` - Bio updated (content: new description string)

- `UPDATE_AVATAR` - Profile picture changed (content: new avatar URL string)

- `UPDATE_BANNER` - Banner image changed (content: new banner URL string)

#### Other Events

- `TWEET_TOPPING` - Tweet pinned

- `DELETE` - Tweet deleted

- `SYSTEM` - System event

- `TRANSLATE` - Tweet translation

- `CA_CREATE` - CA token created

## Data Structures

### Twitter User

{

"userId": "44196397",

"screenName": "elonmusk",

"name": "Elon Musk",

"description": "...",

"followersCount": 170000000,

"friendsCount": 500,

"statusesCount": 30000,

"verified": true

}


### Tweet

{

"id": "1234567890",

"text": "Tweet content...",

"createdAt": "2024-02-20T12:00:00Z",

"retweetCount": 1000,

"favoriteCount": 5000,

"replyCount": 200,

"userScreenName": "elonmusk",

"hashtags": ["crypto", "bitcoin"],

"urls": [{"url": "https://..."}]

}


## Common Workflows

### Crypto Twitter KOL Tweets

curl -s -X POST "https://ai.6551.io/open/twitter_user_tweets" \

-H "Authorization: Bearer $OPENNEWS_TOKEN" \

-H "Content-Type: application/json" \

-d '{"username": "VitalikButerin", "maxResults": 10}'


### Trending Crypto Tweets

curl -s -X POST "https://ai.6551.io/open/twitter_search" \

-H "Authorization: Bearer $OPENNEWS_TOKEN" \

-H "Content-Type: application/json" \

-d '{"keywords": "bitcoin", "minLikes": 1000, "product": "Top", "maxResults": 20}'

opentwitter

SKILL.md

Twitter/X Data Skill

Authentication

Twitter Operations

1. Get Twitter User Info

2. Get Twitter User by ID

3. Get User Tweets

4. Search Twitter

Twitter Search Parameters

5. Get Follower Events

6. Get Deleted Tweets

7. Get KOL Followers

8. Get Twitter Article by ID

9. Get Tweet by ID

10. Get Quote Tweets by ID

11. Get Retweet Users by ID

12. Get Twitter Watch List

13. Add Twitter Watch

14. Delete Twitter Watch

WebSocket Real-time Subscriptions

Heartbeat

Subscribe to Twitter Events

Unsubscribe

Server Push - Twitter Event

Stop writing automation&scrapers

opentwitter

SKILL.md

Twitter/X Data Skill

Authentication

Twitter Operations

1. Get Twitter User Info

2. Get Twitter User by ID

3. Get User Tweets

4. Search Twitter

Twitter Search Parameters

5. Get Follower Events

6. Get Deleted Tweets

7. Get KOL Followers

8. Get Twitter Article by ID

9. Get Tweet by ID

10. Get Quote Tweets by ID

11. Get Retweet Users by ID

12. Get Twitter Watch List

13. Add Twitter Watch

14. Delete Twitter Watch

WebSocket Real-time Subscriptions

Heartbeat

Subscribe to Twitter Events

Unsubscribe

Server Push - Twitter Event

Let your agent run on any real-world website

Related skills

Stop writing automation&scrapers