opentwitter

Twitter/X data via the 6551 API. Supports user profiles, tweet search, user tweets, follower events, deleted tweets, and KOL followers.

Security Scan

The skill's requests, instructions, and install steps match its stated purpose (calling the 6551 Twitter/X API using a bearer token and curl); nothing requested appears disproportionate to that goal.

Purpose & Capability

Name/description state this uses the 6551 API and the skill only requires curl and a TWITTER_TOKEN. The declared dependencies (curl) and the single required env var (TWITTER_TOKEN) are consistent with making HTTP calls to the described endpoints.

Instruction Scope

SKILL.md instructs only to POST JSON to https://ai.6551.io endpoints with Authorization: Bearer $TWITTER_TOKEN. It does not instruct reading local files, other env vars, or system paths. Note: requests send data to a third-party (6551) service — that is expected behavior but relevant for privacy.

Install Mechanism

Install spec is a brew formula for curl and the required binary is curl. This is a low-risk, standard install path and matches the runtime requirements.

Credentials

Only TWITTER_TOKEN is required and declared as the primary credential; this is proportional to the skill's need to authenticate requests. There are no unrelated credentials or broad config path requests.

Persistence & Privilege

always:false and no instructions to modify agent/system configuration. The skill does not request persistent/system-wide privileges.

Assessment

This skill calls a third-party service (ai.6551.io / 6551.io) rather than Twitter's official API. Only provide a TWITTER_TOKEN if you trust that provider; consider using an account or token with limited scope and revoke it after testing. Verify the provider's reputation (homepage/source is unknown), and avoid putting your primary Twitter credentials here. If you need stronger assurance, ask the publisher for a homepage or documentation and confirm what the token grants before installing.

Twitter/X Data Skill

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

Get your token: https://6551.io/mcp

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

Authentication

All requests require the header:

Authorization: Bearer $TWITTER_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 $TWITTER_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 $TWITTER_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 $TWITTER_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 $TWITTER_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 $TWITTER_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 $TWITTER_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 $TWITTER_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 $TWITTER_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 $TWITTER_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 $TWITTER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"username": "elonmusk"}'

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

---

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 $TWITTER_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 $TWITTER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"keywords": "bitcoin", "minLikes": 1000, "product": "Top", "maxResults": 20}'

Notes

• Get your API token at https://6551.io/mcp
• Rate limits apply; max 100 results per request
• Twitter usernames should not include the @ symbol