mcpField
S
Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ)

Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ)

リモート
xpoz.aiソーシャルメディア137 週間前に更新
リポジトリ公式サイト

Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ) について

XpozはAIエージェント向けのホスト型ソーシャル検索サービスで、Twitter/X、Instagram、Reddit、TikTokのユーザー、投稿、コメントを検索できます。自然言語検索、継続的な追跡、非同期CSV出力を備え、OAuth 2.1でリモートMCPサーバーに接続します。

主な機能

  1. 014つのプラットフォームでユーザー、投稿、コメントを検索
  2. 02自然言語による検索
  3. 03クエリ、ユーザー、コミュニティの継続追跡
  4. 04最大50万行の非同期CSV出力
  5. 05ページネーション、フィールド選択、キャッシュ制御

活用シーン

  1. 01見込み顧客やクリエイターの発見
  2. 02ブランドへの言及や競合の動向監視
  3. 03ソーシャルトレンドや会話の調査
  4. 04脆弱性に関する議論の追跡

MCP 対応

リモートMCPサーバーはStreamable HTTP経由で、ソーシャル検索、ユーザー・投稿の取得、追跡、エクスポートのツールを提供します。クライアントはOAuth 2.1で認証し、stdioのみ対応するクライアント向けのDockerブリッジも利用できます。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://mcp.xpoz.ai/mcp
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

ツール

52
パラメーター型必須説明
fieldsarrayいいえパフォーマンスの最適化:必要なフィールドを指定します。デフォルト(省略時):["id", "username", "name"]。使用可能なフィールド:基本:id、username、name、description、location、verified、verifiedType、protected。エンゲージメント:followersCount、followingCount、tweetCount、listedCount、likesCount、mediaCount。プロフィール:profileImageUrl、profileBannerUrl、profileInterstitialType。メタデータ:source、status、pinnedTweetId、isVerified、accountBasedIn、locationAccurate、label、labelType。詳細:nLang、nLangsFiltered。タイムスタンプ:modifiedAt、createdAt。アカウント履歴:verifiedSinceDatetime、usernameChanges、lastUsernameChangeDatetime。例:["id", "username"] は最小限、["username", "name", "description, followersCount"] は基本情報です。必要に応じてすべてのフィールドを指定することもできます。
_isTrialbooleanいいえ
feedbackstringいいえ任意。ツール、他のツール、プラットフォーム全体、その他について、自由にフィードバックをお寄せください。フィードバックは現在のツールに関するものでなくても構いません。このフィールドを使って、以前使用した別のツールについてコメントしたり、不足している機能を報告したり、新しいツールをリクエストしたり、全般的な感想を共有したりできます。例:"getTwitterPostsByKeywords で言語フィルタリングに対応してほしい"、"認証フローが分かりにくかった"、"Twitter リストのメンバーを一覧表示するツールがあると便利"、"とても高速でよかった"。製品改善のために収集され、ツールの動作には影響しません。
_requestIdstringいいえ
userPromptstringいいえ精度のために重要:クエリの最適化とコンテキストに応じたフィルタリングができるよう、ユーザーの質問全文を含めてください。このツールは元のプロンプトに NLP 分析を適用し、結果の関連性を高め、暗黙の要件を検出して、インテリジェントキャッシュを適用します。省略すると、結果が最適でない、または不完全になる可能性があります。
_trialTokenstringいいえ
forceLatestbooleanいいえ必要な場合のみ使用:キャッシュチェックを回避し、API から最新データを強制取得します。明確に要求された場合(例:「最新を取得」「最も新しい」「リアルタイム」)にのみ使用してください。警告:レイテンシーと API コストが増加します。デフォルト:false(インテリジェントキャッシュを使用)。
identifiersarrayはいユーザー ID(数値)またはユーザー名の配列(1~100 件)。すべて identifierType と一致する必要があります。例:ユーザー名の場合は ["elonmusk", "sama"]、ID の場合は ["44196397", "123456"]。見つかったユーザーのみを返し、見つからない識別子は省略します。
identifierTypeenumはい指定する識別子の種類。数値のユーザー ID には "id"、ユーザー名には "username" を使用します。id | username

詳細

Xpoz MCP サーバー

あらゆる AI エージェントから Twitter、Instagram、Reddit、TikTok を検索できます。 数十億件の投稿をインデックス化しています。自然言語で検索できます。最大 50 万行の CSV にエクスポートできます。API キーは不要です。

MCP Registry Website

リモート MCP サーバー — ローカルへのインストールは不要です。Streamable HTTP で接続し、OAuth 2.1 で認証します(Google でサインインするため、管理する API キーはありません)。https://mcp.xpoz.ai/mcp に直接アクセスすると 401 Unauthorized が返されますが、これは想定どおりです。OAuth フローは MCP クライアントが処理します。

クイックスタート

Claude Desktop / Cursor / Windsurf

MCP 設定に追加します。

{
  "mcpServers": {
    "xpoz": {
      "type": "streamable-http",
      "url": "https://mcp.xpoz.ai/mcp"
    }
  }
}
Claude Code、Codex、Gemini CLI
# Claude Code
claude mcp add --transport http --scope user xpoz https://mcp.xpoz.ai/mcp

# Codex / Gemini CLI: see https://www.xpoz.ai/integrations
OpenClaw
clawhub install xpoz-social-search

プロンプトが表示されたら、OAuth リンクから認証します。ほかにも事前構築済みのスキルを利用できます。詳細は clawhub.ai/u/atyachin をご覧ください。

Docker(stdio のみ対応するクライアント向け)

このリポジトリには、ローカルコマンドしか起動できないクライアント向けに、mcp-remote を介して stdio とリモートサーバーを橋渡しする小型の Docker イメージが含まれています。

docker build -t xpoz-mcp .
docker run -i --rm -e XPOZ_API_KEY=your-key xpoz-mcp

XPOZ_API_KEY は任意です。指定しない場合、ブリッジは OAuth サインインフローに切り替わります。このフローではブラウザーが必要です。キーは xpoz.ai/get-token で取得できます。


SDK と CLI

MCP クライアント経由ではなく、コードやターミナルから Xpoz を直接呼び出す場合は、以下をご利用ください。

TypeScript / Node.js
npm install @xpoz/xpoz

ソース:XPOZpublic/xpoz-ts-sdk。

Python
pip install xpoz

ソース:XPOZpublic/xpoz-python-sdk。

CLI
プラットフォームインストールコマンド
macOS / Linux(Homebrew)brew install XPOZpublic/xpoz/xpoz-cli
macOS / Linux(ワンライナー)curl -fsSL https://raw.githubusercontent.com/XPOZpublic/xpoz-cli/main/install.sh | sh
Windows(PowerShell)iwr -useb https://raw.githubusercontent.com/XPOZpublic/xpoz-cli/main/install.ps1 | iex
Windows(winget)winget install Xpoz.XpozCli
Python ≥ 3.10 に対応するすべてのプラットフォームpip install xpoz-cli

ソース:XPOZpublic/xpoz-cli。

4 つのすべてのチャネルは、内部で https://mcp.xpoz.ai/mcp に対して同じ MCP プロトコルを使用するため、以下に示すすべてのツールを、どの接続方法からも利用できます。API トークンは xpoz.ai/get-token で取得できます。


プラットフォームとツール

Twitter / X(14 ツール)
ツール説明
searchTwitterUsers名前、プロフィール、キーワードからユーザーを検索します
getTwitterUserプロフィールの詳細(フォロワー数、プロフィール、指標)を取得します
getTwitterUsersByKeywordsトピックについて積極的に投稿しているユーザーを見つけます
getTwitterUserConnectionsフォロワーまたはフォロー中のユーザーの一覧を取得します
getTwitterPostsByKeywordsキーワード、ハッシュタグ、メンションからツイートを検索します
getTwitterPostsByAuthor特定のユーザーのツイートを取得します
getTwitterPostsByIdsID を指定して特定のツイートを取得します
getTwitterPostCommentsツイートへの返信を取得します
getTwitterPostRetweetsツイートのリツイートを取得します
getTwitterPostQuotes引用ツイートを取得します
getTwitterPostInteractingUsers投稿に「いいね」またはリツイートしたユーザーを取得します
countTweetsクエリに一致するツイート数を集計します(時間別/日別)
checkOperationStatus非同期エクスポート処理のステータスを確認します
cancelOperation実行中の処理をキャンセルします
Instagram(9 個のツール)
ツール説明
searchInstagramUsers名前またはユーザー名でユーザーを検索
getInstagramUserプロフィールの詳細と指標を取得
getInstagramUsersByKeywordsトピックについて投稿しているユーザーを見つける
getInstagramUserConnectionsフォロワーまたはフォロー中のユーザー一覧を取得
getInstagramPostsByKeywordsキーワードまたはハッシュタグで投稿を検索
getInstagramPostsByUser特定のユーザーの投稿を取得
getInstagramPostsByIdsID を指定して投稿を取得
getInstagramPostInteractingUsers投稿に「いいね」またはコメントしたユーザーを取得
getInstagramCommentsByPostId投稿へのコメントを取得
Reddit(9 個のツール)
ツール説明
searchRedditUsers名前でユーザーを検索
getRedditUserユーザープロフィールとカルマを取得
getRedditUsersByKeywordsトピックで活発に活動しているユーザーを見つける
getRedditPostsByKeywordsサブレディット全体から投稿を検索
getRedditPostWithCommentsByIdコメントツリー付きで投稿を取得
getRedditCommentsByKeywordsキーワードでコメントを検索
searchRedditSubreddits名前でサブレディットを検索
getRedditSubredditWithPostsByNameサブレディットのメタデータと最近の投稿を取得
getRedditSubredditsByKeywordsトピックからサブレディットを見つける
TikTok(7 個のツール)
ツール説明
searchTiktokUsers名前またはユーザー名でクリエイターを検索
getTiktokUserクリエイターのプロフィールを取得(フォロワー数、「いいね」数、自己紹介、認証状況)
getTiktokUsersByKeywords投稿履歴のトピックからクリエイターを見つける
getTiktokPostsByKeywordsキーワードまたはハッシュタグで動画を検索
getTiktokPostsByUser特定のクリエイターが投稿した動画を取得
getTiktokPostsByIdsID を指定して動画を取得
getTiktokCommentsByPostId特定の動画へのコメントを取得
トラッキングとモニタリング(3 個のツール)

継続的なブランドモニタリングとリード獲得に対応します。Xpoz は条件に一致する新しいコンテンツが現れるとインデックスに追加します。

ツール説明
addTrackedItems任意のプラットフォームで、クエリ、ユーザー、またはサブレディットの継続的なモニタリングを登録
getTrackedItems最終更新日時とともに、現在トラッキング中の項目を一覧表示
removeTrackedItemsID を指定して項目のトラッキングを停止

主な機能

  • 自然言語クエリ — 必要な内容を説明すると、Xpoz が検索を最適化します
  • CSV エクスポート — 非同期処理で 1 回のダウンロードにつき最大 500K 行を出力
  • サーバーサイドページネーション — 大量の検索結果を効率的に処理
  • フィールド選択 — 必要なフィールドのみをリクエスト
  • キャッシュ制御 — forceLatest: true でキャッシュを迂回し、リアルタイムデータを取得
  • 非同期処理 — ステータスをポーリングしながら、時間のかかるエクスポートを実行
  • OAuth 2.1 — 上流の ID プロバイダーとして Google を使用する動的クライアント登録に対応し、管理が必要な API キーはありません

ユースケース

  • リード獲得 — 自社製品が解決する問題について話している人を見つける
  • インフルエンサーの発見 — フォロワー数だけでなく、投稿内容からクリエイターを特定
  • ブランドモニタリング — メンション、センチメント、競合他社の活動を追跡
  • 市場調査 — トレンドや会話を大規模に分析
  • 専門家の発見 — 複数のプラットフォームから分野の権威を見つける
  • セキュリティインテリジェンス — CVE の公開前に脆弱性に関する議論をモニタリング

検出用エンドポイント(AI エージェントとスキャナー向け)

以下の公開された機械可読エンドポイントは、クローラーやエージェント型クライアントに Xpoz の情報を提供します。

エンドポイントURL
MCP マニフェストhttps://www.xpoz.ai/.well-known/mcp.json
MCP ツールカタログ(説明と JSON-Schema パラメーター)https://www.xpoz.ai/.well-known/mcp/tools.json
Agent Skills インデックス(agentskills.io v0.2.0)https://www.xpoz.ai/.well-known/agent-skills/index.json
llms.txthttps://www.xpoz.ai/llms.txt
llms-full.txthttps://www.xpoz.ai/llms-full.txt
discovery.txthttps://www.xpoz.ai/discovery.txt
Webhooks の仕様https://www.xpoz.ai/webhooks
レート制限と 429 の仕様https://www.xpoz.ai/rate-limits

リンク

ライセンス

このリポジトリには設定とドキュメントのみが含まれています。Xpoz MCP サーバーはホステッドサービスです。詳しくは利用規約をご覧ください。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。