Tweetsmash について
Tweetsmashは、保存したXブックマークを検索・管理するMCPサーバーです。キーワード検索とセマンティック検索、ブックマーク数の確認、ラベル操作に対応し、ホスト型エンドポイントも利用できます。
主な機能
- 01キーワード・セマンティック検索
- 02条件を指定したブックマーク一覧
- 03ラベル別のブックマーク数集計
- 04ラベルの一覧・管理
- 05セマンティック検索インデックスの構築
活用シーン
- 01特定の話題に関する保存投稿を検索
- 02ラベルが付いたブックマーク数を確認
- 03保存投稿のグループにラベルを追加
MCP 対応
MCPクライアントにブックマーク検索・管理ツールを公開します。@tweetsmash/mcpパッケージで実行するほか、ホスト型エンドポイント https://mcp.tweetsmash.com/api/mcp に接続できます。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://mcp.tweetsmash.com/api/mcpclaude mcp add --transport http tweetsmash https://mcp.tweetsmash.com/api/mcp{"mcpServers":{"tweetsmash":{"type":"http","url":"https://mcp.tweetsmash.com/api/mcp"}}}Cursor で開く{"servers":{"tweetsmash":{"type":"http","url":"https://mcp.tweetsmash.com/api/mcp"}}}VS Code で開く{"mcpServers":{"tweetsmash":{"type":"http","url":"https://mcp.tweetsmash.com/api/mcp"}}}{"mcpServers":{"tweetsmash":{"serverUrl":"https://mcp.tweetsmash.com/api/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
5| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| limit | number | いいえ | 取得するブックマーク数(1-100) |
| cursor | string | いいえ | 次のページの結果を取得するためのページネーションカーソル |
| is_unread_only | boolean | いいえ | 未読のブックマークのみを絞り込みます |
| hide_archived | boolean | いいえ | 結果からアーカイブ済みブックマークを除外します |
| media_type | enum | いいえ | 特定のメディアタイプで絞り込みますthread | media | replies | notes | links |
| author | string | いいえ | 特定の作成者のユーザー名で絞り込みます |
| tag | string | いいえ | 特定のタグで絞り込みます |
| posted_from | string | いいえ | この日付以降に投稿されたツイートを絞り込みます(ISO 8601 形式) |
| posted_to | string | いいえ | この日付以前に投稿されたツイートを絞り込みます(ISO 8601 形式) |
| bookmarked_from | string | いいえ | この日付以降に追加されたブックマークを絞り込みます(ISO 8601 形式) |
| bookmarked_to | string | いいえ | この日付以前に追加されたブックマークを絞り込みます(ISO 8601 形式) |
| sort_by | enum | いいえ | 結果の並び順POSTED_DATE_ASC | POSTED_DATE_DESC | OLDEST_FIRST | NEWEST_FIRST |
詳細
Tweetsmash MCP サーバー:AI エージェント向け X(Twitter)ブックマーク
Tweetsmash MCP サーバーは、Claude、ChatGPT、Cursor、Raycast、およびあらゆる Model Context Protocol クライアントを、X(Twitter)のブックマークに接続します。ブックマークを 意味検索したり、件数を数えたり、自然言語でラベルを管理したりできます。
Tweetsmash は X(Twitter)向けのブックマーク管理ツールです。 X でブックマークした投稿を検索可能なライブラリにインポートし、 Notion、Google Sheets、Zotero と同期できるほか、この MCP サーバーおよび X bookmarks API を通じて AI エージェントに公開します。
クイックスタート
- tweetsmash.com で Tweetsmash アカウントを作成し、 X のブックマークをインポートします(ワンクリック)。
- API トークンを生成します:Settings > Integrations > API。
- MCP 設定にサーバーを追加します:
{
"mcpServers": {
"tweetsmash": {
"command": "npx",
"args": ["@tweetsmash/mcp"],
"env": { "TWEETSMASH_TOKEN": "your-token-here" }
}
}
}
ホステッドエンドポイント(ローカルインストール不要)
リモート MCP クライアントから次のエンドポイントに接続します:
https://mcp.tweetsmash.com/api/mcp
Tweetsmash API トークンを Bearer ヘッダーとして指定します。
ツール
| ツール | 機能 |
|---|---|
list_bookmarks | フィルターを適用して保存済み投稿をページごとに取得します |
search_bookmarks | すべてのブックマークを対象にキーワード検索と意味検索を行います |
get_bookmark_count | ブックマークの件数を数えます。ラベルで絞り込むこともできます |
list_labels | ライブラリ内のすべてのラベルを一覧表示します |
add_labels_to_tweets | エージェントからブックマークにラベルを付けます |
remove_labels_from_tweets | ラベルを削除します |
setup_vector_store | 意味検索インデックスを構築します |
プロンプトの例
- 「プロンプトエンジニアリングに関するブックマークを探して」
- 「MCP に言及しているブックマークはいくつありますか?」
- 「先週保存したものすべてに AI というラベルを付けて」
リンク
- X Bookmarks MCP
- セットアップガイド:Claude Desktop、Raycast、Smithery
- X Bookmarks API
- npm:@tweetsmash/mcp
- Smithery の掲載ページ
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。