Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ) について
XpozはAIエージェント向けのホスト型ソーシャル検索サービスで、Twitter/X、Instagram、Reddit、TikTokのユーザー、投稿、コメントを検索できます。自然言語検索、継続的な追跡、非同期CSV出力を備え、OAuth 2.1でリモートMCPサーバーに接続します。
主な機能
- 014つのプラットフォームでユーザー、投稿、コメントを検索
- 02自然言語による検索
- 03クエリ、ユーザー、コミュニティの継続追跡
- 04最大50万行の非同期CSV出力
- 05ページネーション、フィールド選択、キャッシュ制御
活用シーン
- 01見込み顧客やクリエイターの発見
- 02ブランドへの言及や競合の動向監視
- 03ソーシャルトレンドや会話の調査
- 04脆弱性に関する議論の追跡
MCP 対応
リモートMCPサーバーはStreamable HTTP経由で、ソーシャル検索、ユーザー・投稿の取得、追跡、エクスポートのツールを提供します。クライアントはOAuth 2.1で認証し、stdioのみ対応するクライアント向けのDockerブリッジも利用できます。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://mcp.xpoz.ai/mcpclaude mcp add --transport http ai-xpoz-social-insights https://mcp.xpoz.ai/mcp{"mcpServers":{"ai-xpoz-social-insights":{"type":"http","url":"https://mcp.xpoz.ai/mcp"}}}Cursor で開く{"servers":{"ai-xpoz-social-insights":{"type":"http","url":"https://mcp.xpoz.ai/mcp"}}}VS Code で開く{"mcpServers":{"ai-xpoz-social-insights":{"type":"http","url":"https://mcp.xpoz.ai/mcp"}}}{"mcpServers":{"ai-xpoz-social-insights":{"serverUrl":"https://mcp.xpoz.ai/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
52| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| fields | array | いいえ | パフォーマンスの最適化:必要なフィールドを指定します。デフォルト(省略時):["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"] は基本情報です。必要に応じてすべてのフィールドを指定することもできます。 |
| _isTrial | boolean | いいえ | |
| feedback | string | いいえ | 任意。ツール、他のツール、プラットフォーム全体、その他について、自由にフィードバックをお寄せください。フィードバックは現在のツールに関するものでなくても構いません。このフィールドを使って、以前使用した別のツールについてコメントしたり、不足している機能を報告したり、新しいツールをリクエストしたり、全般的な感想を共有したりできます。例:"getTwitterPostsByKeywords で言語フィルタリングに対応してほしい"、"認証フローが分かりにくかった"、"Twitter リストのメンバーを一覧表示するツールがあると便利"、"とても高速でよかった"。製品改善のために収集され、ツールの動作には影響しません。 |
| _requestId | string | いいえ | |
| userPrompt | string | いいえ | 精度のために重要:クエリの最適化とコンテキストに応じたフィルタリングができるよう、ユーザーの質問全文を含めてください。このツールは元のプロンプトに NLP 分析を適用し、結果の関連性を高め、暗黙の要件を検出して、インテリジェントキャッシュを適用します。省略すると、結果が最適でない、または不完全になる可能性があります。 |
| _trialToken | string | いいえ | |
| forceLatest | boolean | いいえ | 必要な場合のみ使用:キャッシュチェックを回避し、API から最新データを強制取得します。明確に要求された場合(例:「最新を取得」「最も新しい」「リアルタイム」)にのみ使用してください。警告:レイテンシーと API コストが増加します。デフォルト:false(インテリジェントキャッシュを使用)。 |
| identifiers | array | はい | ユーザー ID(数値)またはユーザー名の配列(1~100 件)。すべて identifierType と一致する必要があります。例:ユーザー名の場合は ["elonmusk", "sama"]、ID の場合は ["44196397", "123456"]。見つかったユーザーのみを返し、見つからない識別子は省略します。 |
| identifierType | enum | はい | 指定する識別子の種類。数値のユーザー ID には "id"、ユーザー名には "username" を使用します。id | username |
詳細
Xpoz MCP サーバー
あらゆる AI エージェントから Twitter、Instagram、Reddit、TikTok を検索できます。 数十億件の投稿をインデックス化しています。自然言語で検索できます。最大 50 万行の CSV にエクスポートできます。API キーは不要です。
リモート 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
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 | 特定のユーザーのツイートを取得します |
getTwitterPostsByIds | ID を指定して特定のツイートを取得します |
getTwitterPostComments | ツイートへの返信を取得します |
getTwitterPostRetweets | ツイートのリツイートを取得します |
getTwitterPostQuotes | 引用ツイートを取得します |
getTwitterPostInteractingUsers | 投稿に「いいね」またはリツイートしたユーザーを取得します |
countTweets | クエリに一致するツイート数を集計します(時間別/日別) |
checkOperationStatus | 非同期エクスポート処理のステータスを確認します |
cancelOperation | 実行中の処理をキャンセルします |
Instagram(9 個のツール)
| ツール | 説明 |
|---|---|
searchInstagramUsers | 名前またはユーザー名でユーザーを検索 |
getInstagramUser | プロフィールの詳細と指標を取得 |
getInstagramUsersByKeywords | トピックについて投稿しているユーザーを見つける |
getInstagramUserConnections | フォロワーまたはフォロー中のユーザー一覧を取得 |
getInstagramPostsByKeywords | キーワードまたはハッシュタグで投稿を検索 |
getInstagramPostsByUser | 特定のユーザーの投稿を取得 |
getInstagramPostsByIds | ID を指定して投稿を取得 |
getInstagramPostInteractingUsers | 投稿に「いいね」またはコメントしたユーザーを取得 |
getInstagramCommentsByPostId | 投稿へのコメントを取得 |
Reddit(9 個のツール)
| ツール | 説明 |
|---|---|
searchRedditUsers | 名前でユーザーを検索 |
getRedditUser | ユーザープロフィールとカルマを取得 |
getRedditUsersByKeywords | トピックで活発に活動しているユーザーを見つける |
getRedditPostsByKeywords | サブレディット全体から投稿を検索 |
getRedditPostWithCommentsById | コメントツリー付きで投稿を取得 |
getRedditCommentsByKeywords | キーワードでコメントを検索 |
searchRedditSubreddits | 名前でサブレディットを検索 |
getRedditSubredditWithPostsByName | サブレディットのメタデータと最近の投稿を取得 |
getRedditSubredditsByKeywords | トピックからサブレディットを見つける |
TikTok(7 個のツール)
| ツール | 説明 |
|---|---|
searchTiktokUsers | 名前またはユーザー名でクリエイターを検索 |
getTiktokUser | クリエイターのプロフィールを取得(フォロワー数、「いいね」数、自己紹介、認証状況) |
getTiktokUsersByKeywords | 投稿履歴のトピックからクリエイターを見つける |
getTiktokPostsByKeywords | キーワードまたはハッシュタグで動画を検索 |
getTiktokPostsByUser | 特定のクリエイターが投稿した動画を取得 |
getTiktokPostsByIds | ID を指定して動画を取得 |
getTiktokCommentsByPostId | 特定の動画へのコメントを取得 |
トラッキングとモニタリング(3 個のツール)
継続的なブランドモニタリングとリード獲得に対応します。Xpoz は条件に一致する新しいコンテンツが現れるとインデックスに追加します。
| ツール | 説明 |
|---|---|
addTrackedItems | 任意のプラットフォームで、クエリ、ユーザー、またはサブレディットの継続的なモニタリングを登録 |
getTrackedItems | 最終更新日時とともに、現在トラッキング中の項目を一覧表示 |
removeTrackedItems | ID を指定して項目のトラッキングを停止 |
主な機能
- 自然言語クエリ — 必要な内容を説明すると、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.txt | https://www.xpoz.ai/llms.txt |
llms-full.txt | https://www.xpoz.ai/llms-full.txt |
discovery.txt | https://www.xpoz.ai/discovery.txt |
| Webhooks の仕様 | https://www.xpoz.ai/webhooks |
| レート制限と 429 の仕様 | https://www.xpoz.ai/rate-limits |
リンク
- 🌐 xpoz.ai
- 💰 料金
- 📦 MCP レジストリ
- 🛠️ ClawHub スキル
- 📖 ドキュメント
- 🐙 GitHub の XPOZpublic — TS SDK、Python SDK、CLI、エージェントスキル、クックブック
- 🍺 Homebrew tap
ライセンス
このリポジトリには設定とドキュメントのみが含まれています。Xpoz MCP サーバーはホステッドサービスです。詳しくは利用規約をご覧ください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。