opentwitter

# 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 ``` --- ## Meme Evidence Operations ### Get Meme Token Evidence Get the initial thesis and callout evidence for a meme token from the fomo/pump feeds. ```bash curl -s -X POST "https://ai.6551.io/open/meme/token-evidence" \ -H "Authorization: Bearer $OPENNEWS_TOKEN" \ -H "Content-Type: application/json" \ -d '{"coin": "GADj8JQ8iQLQD5S6ScvncJWmGs7PkwHnXsBrEUns6ue5", "limit": 100}' ``` Parameters: `coin`, `kind`, `platform`, `handle`, `user`, `since`, and `limit`. The default kind is `thesis,callout`; `limit` is capped at 1000. ### Get Meme Activity Get later statements and buy/sell evidence for meme tokens. ```bash curl -s -X POST "https://ai.6551.io/open/meme/activity" \ -H "Authorization: Bearer $OPENNEWS_TOKEN" \ -H "Content-Type: application/json" \ -d '{"coin": "GADj8JQ8iQLQD5S6ScvncJWmGs7PkwHnXsBrEUns6ue5", "kind": "trade", "limit": 100}' ``` Parameters: `coin`, `handle`, `user`, `wallet`, `kind`, `platform`, `since`, and `limit`. `kind=trade` is an alias for `buy` and `sell`. ## Twitter Operations ### 1. Get Twitter User Info Get user profile by username. ```bash 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. ```bash 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. ```bash 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. **Search with `query`:** ```bash curl -s -X POST "https://ai.6551.io/open/twitter_search" \ -H "Authorization: Bearer $OPENNEWS_TOKEN" \ -H "Content-Type: application/json" \ -d '{"query": "from:VitalikButerin bitcoin -filter:replies", "maxResults": 20, "product": "Top"}' ``` ```bash 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:** ```bash 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:** ```bash 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 | |------------------|---------|---------|-------------------------------------| | `query` | string | - | Complete search string; overrides other filters | | `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) | If `query` is set, it is passed through as-is and the other search fields are ignored. ### 5. Get Follower Events Get new followers or unfollowers for a user. ```bash # 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. ```bash 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. ```bash 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. ```bash 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. ```bash 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. ```bash