← Back to Skills Marketplace
infra403

opentwitter

by infra403 · GitHub ↗ · v1.0.0
darwinlinuxwin32 ✓ Security Clean
22240
Downloads
26
Stars
24
Active Installs
1
Versions
Install in OpenClaw
/install opentwitter-mcp
Description
Twitter/X data via the 6551 API. Supports user profiles, tweet search, user tweets, follower events, deleted tweets, and KOL followers.
README (SKILL.md)

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
Usage Guidance
Install only if you trust the 6551 API service with your TWITTER_TOKEN and the usernames, searches, follower-event checks, or deleted-tweet lookups you submit. Prefer a dedicated or revocable token, avoid sensitive investigations unless appropriate, and review the provider's privacy and retention practices.
Capability Analysis
Type: OpenClaw Skill Name: opentwitter-mcp Version: 1.0.0 The skill is designed to query Twitter/X data via the 6551 platform API. It explicitly requires a `TWITTER_TOKEN` environment variable for authentication, which is standard for API access. All `curl` commands are directed to a specific, hardcoded domain (`https://ai.6551.io`) and involve standard POST requests with JSON payloads for data retrieval. There is no evidence of data exfiltration to unauthorized endpoints, malicious command execution, persistence mechanisms, or prompt injection attempts against the agent to perform actions outside the skill's stated purpose. The skill's behavior is clearly aligned with its description.
Capability Assessment
Purpose & Capability
The advertised purpose is Twitter/X data lookup, and the documented capabilities match that purpose, including user profiles, search, user tweets, follower events, deleted tweets, and KOL follower lookups. Some lookups are privacy-sensitive, but they are disclosed as core features.
Instruction Scope
The artifact provides bounded curl examples for read-oriented API calls and does not instruct hidden execution, destructive actions, unrelated local data access, prompt manipulation, or background behavior.
Install Mechanism
Install metadata only requires curl with a Homebrew install hint. There are no package scripts, compiled binaries, or install-time mutations beyond obtaining an HTTP client.
Credentials
The skill requires TWITTER_TOKEN and sends it with query parameters to https://ai.6551.io. That outbound credentialed API use is expected and disclosed, but users should treat the token and query targets as sensitive.
Persistence & Privilege
No persistence, privilege escalation, local credential-store access, broad indexing, background workers, or automatic recurring execution are present in the artifacts.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install opentwitter-mcp
  3. After installation, invoke the skill by name or use /opentwitter-mcp
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of opentwitter: Twitter/X data from the 6551 API - Query Twitter/X user profiles, tweets, search, follower events, deleted tweets, and KOL followers via the 6551 API. - Requires a Bearer token via the environment variable `TWITTER_TOKEN`. - Supports endpoints for user info, user by ID, user tweets (with filtering), tweet search (with advanced filters), follower/unfollower events, deleted tweets, and KOL follower lookup. - Provides example cURL usage and parameter details for all endpoints. - Includes sample data structures for users and tweets.
Metadata
Slug opentwitter-mcp
Version 1.0.0
License
All-time Installs 24
Active Installs 24
Total Versions 1
Frequently Asked Questions

What is opentwitter?

Twitter/X data via the 6551 API. Supports user profiles, tweet search, user tweets, follower events, deleted tweets, and KOL followers. It is an AI Agent Skill for Claude Code / OpenClaw, with 22240 downloads so far.

How do I install opentwitter?

Run "/install opentwitter-mcp" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is opentwitter free?

Yes, opentwitter is completely free (open-source). You can download, install and use it at no cost.

Which platforms does opentwitter support?

opentwitter is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux, win32).

Who created opentwitter?

It is built and maintained by infra403 (@infra403); the current version is v1.0.0.

💬 Comments