Twitter/X データスキル

6551 プラットフォーム REST API から Twitter/X データをクエリします。すべてのエンドポイントは $TWITTER_TOKEN 経由の Bearer トークンが必要です。

トークン取得: https://6551.io/mcp

ベース URL: https://ai.6551.io

認証

すべてのリクエストに以下のヘッダーが必要です:

Authorization: Bearer $TWITTER_TOKEN

---

Twitter 操作

1. Twitter ユーザー情報取得

ユーザー名でユーザープロフィールを取得します。

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. ID で Twitter ユーザーを取得

数値 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. ユーザーのツイート取得

ユーザーの最新ツイートを取得します。

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"}'

パラメータ	型	デフォルト	説明
username	string	必須	Twitter ユーザー名 (@ なし)
maxResults	integer	20	最大ツイート数 (1-100)
product	string	"Latest"	"Latest" または "Top"
includeReplies	boolean	false	リプライツイートを含める
includeRetweets	boolean	false	リツイートを含める

4. Twitter 検索

様々なフィルターを使用してツイートを検索します。

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"}'

特定ユーザーから検索:

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}'

ハッシュタグで検索:

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 検索パラメータ

パラメータ	型	デフォルト	説明
keywords	string	-	検索キーワード
fromUser	string	-	特定ユーザーからのツイート
toUser	string	-	特定ユーザーへのツイート
mentionUser	string	-	ユーザーをメンションしたツイート
hashtag	string	-	ハッシュタグでフィルター (# なし)
excludeReplies	boolean	false	リプライツイートを除外
excludeRetweets	boolean	false	リツイートを除外
minLikes	integer	0	最小いいね数
minRetweets	integer	0	最小リツイート数
minReplies	integer	0	最小リプライ数
sinceDate	string	-	開始日 (YYYY-MM-DD)
untilDate	string	-	終了日 (YYYY-MM-DD)
lang	string	-	言語コード (例: "en", "zh")
product	string	"Top"	"Top" または "Latest"
maxResults	integer	20	最大ツイート数 (1-100)

5. フォロワーイベント取得

ユーザーの新しいフォロワーまたはアンフォロワーを取得します。

# 新しいフォロワーを取得
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}'

# アンフォロワーを取得
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}'

パラメータ	型	デフォルト	説明
username	string	必須	Twitter ユーザー名 (@ なし)
isFollow	boolean	true	true=新規フォロワー, false=アンフォロワー
maxResults	integer	20	最大イベント数 (1-100)

6. 削除ツイート取得

ユーザーの削除されたツイートを取得します。

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}'

パラメータ	型	デフォルト	説明
username	string	必須	Twitter ユーザー名 (@ なし)
maxResults	integer	20	最大ツイート数 (1-100)

7. KOL フォロワー取得

ユーザーをフォローしている KOL (Key Opinion Leaders) を取得します。

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"}'

パラメータ	型	デフォルト	説明
username	string	必須	Twitter ユーザー名 (@ なし)

8. ID で Twitter 記事取得

ID で Twitter 記事を取得します。

curl -s -X POST "https://ai.6551.io/open/twitter_article_by_id" \
  -H "Authorization: Bearer $TWITTER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id": "article_id"}'

パラメータ	型	デフォルト	説明
id	string	必須	Twitter 記事 ID

9. ID でツイート取得

ID で特定のツイートを取得します。ネストされたリプライ/引用ツイートを含みます。

このエンドポイントは ID でツイートを取得し、自動的にそのツイートへのリプライまたは引用元ツイートを取得して、完全なコンテキストを提供します。

curl -s -X POST "https://ai.6551.io/open/twitter_tweet_by_id" \
  -H "Authorization: Bearer $TWITTER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"twId": "2030318958512164966"}'

パラメータ	型	デフォルト	説明
twId	string	必須	Twitter ツイート ID (数値)

レスポンスに含まれるもの:

• メインツイートデータ
• replyStatus: リプライされたツイート (該当する場合)
• quotedStatus: 引用されたツイート (該当する場合)

10. ID で引用ツイート取得

特定のツイートを引用したツイートを取得します。

curl -s -X POST "https://ai.6551.io/open/twitter_quote_tweets_by_id" \
  -H "Authorization: Bearer $TWITTER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id": "2030318958512164966", "maxResults": 20}'

パラメータ	型	デフォルト	説明
id	string	必須	Twitter ツイート ID (数値)
maxResults	integer	20	最大ツイート数 (1-100)

11. ID でリツイートユーザー取得

特定のツイートをリツイートしたユーザーを取得します。

curl -s -X POST "https://ai.6551.io/open/twitter_retweet_users_by_id" \
  -H "Authorization: Bearer $TWITTER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id": "2030318958512164966"}'

パラメータ	型	デフォルト	説明
id	string	必須	Twitter ツイート ID (数値)
cursor	string	-	次ページのペジネーションカーソル

12. Twitter ウォッチリスト取得

現在のユーザーの全 Twitter モニタリングユーザーを取得します。

curl -s -X POST "https://ai.6551.io/open/twitter_watch" \
  -H "Authorization: Bearer $TWITTER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

13. Twitter ウォッチ追加

Twitter ユーザーをモニタリングリストに追加します。

curl -s -X POST "https://ai.6551.io/open/twitter_watch_add" \
  -H "Authorization: Bearer $TWITTER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"username": "elonmusk", "newTweetBol": true, "newFlwBol": false}'

パラメータ	型	デフォルト	説明
username	string	必須	Twitter ユーザー名 (@ なし)
newTweetBol	boolean	true (サーバー)	新しいツイートをモニタリング
newFlwBol	boolean	false (サーバー)	新しいフォロワーをモニタリング
newUnFlwBol	boolean	false (サーバー)	アンフォロワーをモニタリング
newTweetReplyBol	boolean	true (サーバー)	ツイートリプライをモニタリング
newTweetQuoteBol	boolean	true (サーバー)	引用ツイートをモニタリング
newRetweetBol	boolean	true (サーバー)	リツイートをモニタリング
updateNameBol	boolean	true (サーバー)	ユーザー名変更をモニタリング
updateDescBol	boolean	true (サーバー)	自己紹介変更をモニタリング
updateAvatarBol	boolean	true (サーバー)	プロフィール画像変更をモニタリング
updateBannerBol	boolean	true (サーバー)	バナー画像変更をモニタリング
newCaBol	boolean	false (サーバー)	CA (コントラクトアドレス) イベントをモニタリング
tweetToppingBol	boolean	false (サーバー)	ツイートピン留めイベントをモニタリング

14. Twitter ウォッチ削除

ユーザー名でモニタリングリストから Twitter ユーザーを削除します。

curl -s -X POST "https://ai.6551.io/open/twitter_watch_delete" \
  -H "Authorization: Bearer $TWITTER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"username": "elonmusk"}'

パラメータ	型	デフォルト	説明
username	string	必須	削除する Twitter ユーザー名 (@ なし)

---

WebSocket リアルタイムサブスクリプション

エンドポイント: wss://ai.6551.io/open/twitter_wss?token=YOUR_TOKEN

モニタリング中の Twitter アカウントからのリアルタイムイベントにサブスクライブします。

Twitter イベントにサブスクライブ

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "twitter.subscribe"
}

レスポンス:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "success": true
  }
}

アンサブスクライブ

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "twitter.unsubscribe"
}

サーバープッシュ - Twitter イベント

モニタリング対象アカウントがアクティビティを起こしたとき、サーバーは以下をプッシュします:

{
  "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"
  }
}

注: content フィールドの構造はイベントタイプによって異なります (以下を参照)。

イベントタイプとコンテンツ構造:

ツイートイベント

• NEW_TWEET - 新しいツイート投稿
• NEW_TWEET_REPLY - 新しいリプライツイート
• NEW_TWEET_QUOTE - 新しい引用ツイート
• NEW_RETWEET - リツイート
• CA - CA アドレス付きツイート

ツイートイベントのコンテンツ構造:

{
  "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"
    }
  ]
}

フォロワーイベント

• NEW_FOLLOWER - 新規フォロワー
• NEW_UNFOLLOWER - アンフォロワーイベント

フォロワーイベントのコンテンツ構造 (配列):

[
  {
    "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"
  }
]

プロフィール更新イベント

• UPDATE_NAME - ユーザー名変更 (コンテンツ: 新しい名前の文字列)
• UPDATE_DESCRIPTION - 自己紹介更新 (コンテンツ: 新しい説明の文字列)
• UPDATE_AVATAR - プロフィール画像変更 (コンテンツ: 新しいアバター URL の文字列)
• UPDATE_BANNER - バナー画像変更 (コンテンツ: 新しいバナー URL の文字列)

その他のイベント

• TWEET_TOPPING - ツイートピン留め
• DELETE - ツイート削除
• SYSTEM - システムイベント
• TRANSLATE - ツイート翻訳
• CA_CREATE - CA トークン作成

---

データ構造

Twitter ユーザー

{
  "userId": "44196397",
  "screenName": "elonmusk",
  "name": "Elon Musk",
  "description": "...",
  "followersCount": 170000000,
  "friendsCount": 500,
  "statusesCount": 30000,
  "verified": true
}

ツイート

{
  "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://..."}]
}

---

一般的なワークフロー

Crypto Twitter KOL ツイート

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}'

トレンディング Crypto ツイート

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}'

注釈

• API トークンは https://6551.io/mcp で取得してください
• レート制限が適用されます。リクエストあたり最大 100 結果
• Twitter ユーザー名に @ 記号は含めないでください