X (Twitter)

🚀 Twitter MCP

このプロジェクトは、Twitter API とのインタラクションを行うためのミドルウェア (MCP) です。Twitter 機能の統合と管理を簡素化することを目的としています。このサーバーは、ツイートの送信、ツイート情報の取得、ユーザーのインタラクションの処理など、一般的な Twitter 操作を実行するための一連のツールを提供します。

🚀 クイックスタート

この Twitter MCP を使用することで、Twitter API とのやり取りを簡単に行うことができます。以下の手順に従って、セットアップと使用を開始しましょう。

✨ 主な機能

• ツイート操作：ツイートの送信、返信、削除が可能です。
• 検索と分析：ツイートの検索、ユーザー情報の取得、ハッシュタグの分析ができます。
• ユーザーインタラクション：ユーザーのフォロー/フォロー解除、フォロワーリストの管理が可能です。
• リスト管理：リストの作成、メンバーの追加/削除、リスト情報の取得ができます。

📦 インストール

プロジェクトのセットアップ

1. リポジトリをクローンします。

git clone https://github.com/your-repository.git

2. 依存関係をインストールします。

npm install

3. 環境変数を設定します。 .env ファイルを作成し、以下の内容を追加します。your-twitter-api-key などを実際の Twitter API の認証情報に置き換えてください。

TWITTER_API_KEY=your-twitter-api-key
TWITTER_API_SECRET_KEY=your_twitter_api_secret_key
TWITTER_ACCESS_TOKEN=your_twitter_access_token
TWITTER_ACCESS_TOKEN_SECRET=your_twitter_access_token_secret

4. サーバーを起動します。

npm start

📚 ドキュメント

利用可能なツールの分類

• ツイート操作：ツイートの送信、返信、削除。
• 検索と分析：ツイートの検索、ユーザー情報の取得、ハッシュタグの分析。
• ユーザーインタラクション：ユーザーのフォロー/フォロー解除、フォロワーリストの管理。
• リスト管理：リストの作成、メンバーの追加/削除、リスト情報の取得。

詳細なツールの説明

ツイート操作

• ツイートの送信 (postTweet)：

POST /api/tweet/post
{
    "text": "你的推文内容"
}

返り値：ツイート ID。

• ツイートの削除 (deleteTweet)：

DELETE /api/tweet/{tweetId}

返り値：削除成功の確認メッセージ。

検索と分析

• ツイートの検索 (searchTweets)：

GET /api/search?q=查询词&count=结果数量

返り値：一致するツイートのリスト。

• ユーザー情報の取得 (getUserInfo)：

GET /api/user/{username}

返り値：ユーザーの詳細プロフィール（自己紹介、フォロワー数など）。

ユーザーインタラクション

• ユーザーのフォロー (followUser)：

POST /api/follow/{username}

返り値：フォローの確認メッセージ。

• ユーザーのフォロー解除 (unfollowUser)：

DELETE /api/follow/{username}

返り値：フォロー解除の確認メッセージ。

リスト管理

• リストの作成 (createList)：

POST /api/list/create
{
    "name": "列表名称",
    "mode": "public" 或 "private"
}

返り値：新しいリストの ID。

• リストへのメンバーの追加 (addToList)：

POST /api/list/{listId}/members
{
    "username": "用户名"
}

返り値：追加の確認メッセージ。

エラー処理

すべてのツールは、パラメータの欠落や API エラーなど、標準的なエラー応答を返します。詳細なエラーコードと情報については、API ドキュメントを参照してください。

開発ガイド

クイックスタート

# プロジェクトのビルド
npm run build

# 開発サーバーの起動（ホットリロード対応）
npm run dev

用語集

Twitter MCP をご利用いただき、ありがとうございます。何か問題があれば、サポートチームにご連絡ください。