X (Twitter) Scraper

🚀 Twitter MCP サーバー

agent-twitter-client ライブラリを使用して、Twitter とのインタラクションツールを提供する MCP（モデルコンテキストプロトコル）サーバーです。

🚀 クイックスタート

このサーバーを使用することで、Twitter とのやり取りを容易に行うことができます。以下に手順を説明します。

✨ 主な機能

• getTweet：ID を使って単一のツイートを検索します。
• sendTweet：新しいツイートを Twitter に投稿します。

📦 インストール

前提条件

• Node.js (v14 以上)
• npm または yarn
• Twitter アカウントの認証情報

インストール手順

1. このリポジトリをクローンします。
2. 依存関係をインストールします。

npm install
# または
yarn install

3. プロジェクトのルートディレクトリに .env ファイルを作成し、Twitter の認証情報を追加します。

TWITTER_USERNAME=your_twitter_username
TWITTER_PASSWORD=your_twitter_password
TWITTER_EMAIL=your_email@example.com (任意)
TWITTER_2FA_SECRET=your_2fa_secret (任意)

# 任意の API 認証情報（予備として）
TWITTER_API_KEY=your_api_key
TWITTER_API_SECRET_KEY=your_api_secret_key
TWITTER_ACCESS_TOKEN=your_access_token
TWITTER_ACCESS_TOKEN_SECRET=your_access_token_secret

💻 使用例

サーバーの起動

FastMCP CLI ツールを使用してサーバーを起動できます。

# 開発とテストでターミナルから使用
npx fastmcp dev

# MCP インスペクターを使用して視覚的に確認
npx fastmcp inspect

ツールの使用

getTweet

ID を使って単一のツイートを検索します。 パラメーター：

• tweetId (文字列)：検索するツイートの ID

使用例：

getTweet({"tweetId": "1734609533274853865"})

sendTweet

新しいツイートを Twitter に投稿します。 パラメーター：

• text (文字列)：投稿するツイートの内容

使用例：

sendTweet({"text": "Hello World from MCP!"})

📚 ドキュメント

このサーバーは以下のものを使用して構築されています。

• FastMCP - MCP サーバーを構築するための TypeScript フレームワーク
• agent-twitter-client - Twitter クライアントライブラリ

TypeScript コードをビルドするには、以下のコマンドを実行します。

npx tsc

📄 ライセンス

MIT