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

Name: Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ)
Author: xpoz.ai

远程服务

xpoz.ai社交媒体137 周前更新

代码仓库访问官网

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

Xpoz 是面向 AI Agent 的托管社交媒体搜索服务，可查询 Twitter/X、Instagram、Reddit 和 TikTok 的用户、帖子与评论。它提供自然语言搜索、持续跟踪和异步 CSV 导出，并通过 OAuth 2.1 连接远程 MCP 服务。

主要功能

01搜索四个平台的用户、帖子和评论
02按自然语言描述搜索内容
03持续跟踪查询、用户或社区
04异步导出最多 50 万行 CSV
05分页、字段选择与缓存控制

适用场景

01发现潜在客户和内容创作者
02监测品牌提及与竞争动态
03研究社交平台趋势和讨论
04追踪漏洞相关讨论

MCP 相关

远程 MCP 服务通过 Streamable HTTP 提供社交平台搜索、用户与帖子查询、跟踪及导出工具。客户端使用 OAuth 2.1 登录；也可通过 Docker 桥接供仅支持 stdio 的客户端连接。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://mcp.xpoz.ai/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http ai-xpoz-social-insights https://mcp.xpoz.ai/mcp

Cursor.cursor/mcp.json{"mcpServers":{"ai-xpoz-social-insights":{"type":"http","url":"https://mcp.xpoz.ai/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"ai-xpoz-social-insights":{"type":"http","url":"https://mcp.xpoz.ai/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"ai-xpoz-social-insights":{"type":"http","url":"https://mcp.xpoz.ai/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"ai-xpoz-social-insights":{"serverUrl":"https://mcp.xpoz.ai/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

参数	类型	必填	说明
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 Agent 搜索 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 的客户端）

此仓库提供一个小型 Docker 镜像，通过 mcp-remote 将 stdio 桥接到远程服务，适用于只能启动本地命令的客户端：

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

如果你希望直接通过代码或终端调用 Xpoz，而不是通过 MCP 客户端：

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。

这四种渠道在底层均通过 https://mcp.xpoz.ai/mcp 使用相同的 MCP 协议，因此你在下方看到的任何工具都可通过每种方式使用。可在 xpoz.ai/get-token 获取 API 令牌。

平台和工具

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`	获取用户个人资料和 Karma
`getRedditUsersByKeywords`	查找活跃于相关主题的用户
`getRedditPostsByKeywords`	跨多个 subreddit 搜索帖子
`getRedditPostWithCommentsById`	获取帖子及其评论树
`getRedditCommentsByKeywords`	按关键词搜索评论
`searchRedditSubreddits`	按名称查找 subreddit
`getRedditSubredditWithPostsByName`	获取 subreddit 的元数据和近期帖子
`getRedditSubredditsByKeywords`	按主题查找 subreddit

TikTok（7 个工具）

工具	描述
`searchTiktokUsers`	按姓名或用户名查找创作者
`getTiktokUser`	获取创作者个人资料（粉丝数、获赞数、简介、认证状态）
`getTiktokUsersByKeywords`	根据创作者的发帖记录按主题查找创作者
`getTiktokPostsByKeywords`	按关键词或话题标签搜索视频
`getTiktokPostsByUser`	获取特定创作者发布的视频
`getTiktokPostsByIds`	按 ID 获取指定视频
`getTiktokCommentsByPostId`	获取特定视频的评论

跟踪与监控（3 个工具）

用于持续开展品牌监控和潜在客户挖掘——Xpoz 会在新的匹配内容出现时将其编入索引。

工具	描述
`addTrackedItems`	订阅在任意平台持续监控某个查询、用户或 subreddit
`getTrackedItems`	列出当前跟踪项及其上次更新时间
`removeTrackedItems`	按 ID 停止监控跟踪项

主要功能

自然语言查询 — 描述你的需求，Xpoz 会优化搜索
CSV 导出 — 通过异步操作，单次下载最多可导出 500K 行
服务端分页 — 高效处理大型结果集
字段选择 — 仅请求所需字段
缓存控制 — forceLatest: true 可绕过缓存以获取实时数据
异步操作 — 通过状态轮询处理长时间运行的导出
OAuth 2.1 — 动态客户端注册，使用 Google 作为上游身份提供商，无需管理 API 密钥

使用场景

潜在客户挖掘 — 查找正在讨论你的产品能够解决的问题的人
网红发现 — 根据创作者发布的内容识别创作者，而不只是看粉丝数
品牌监控 — 跟踪提及内容、情绪倾向和竞争对手动态
市场调研 — 大规模分析趋势和讨论
专家查找 — 跨平台发现领域权威人士
安全情报 — 在 CVE 发布前监控漏洞相关讨论

发现入口（面向 AI Agent 和扫描器）

这些公开、机器可读的端点向爬虫和 Agent 客户端介绍 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 Skills
📖 文档
🐙 GitHub 上的 XPOZpublic — TS SDK、Python SDK、命令行工具、Agent Skills、示例手册
🍺 Homebrew tap

许可证

此仓库仅包含配置和文档。Xpoz MCP 服务是一项托管服务 — 请参阅服务条款。

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

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

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

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

Xpoz MCP 服务

快速开始

Claude Desktop / Cursor / Windsurf

Claude Code、Codex、Gemini CLI

OpenClaw

Docker（仅支持 stdio 的客户端）

SDK 和 CLI

TypeScript / Node.js

Python

CLI

平台和工具

Twitter / X（14 个工具）

Instagram（9 个工具）

Reddit（9 个工具）

TikTok（7 个工具）

跟踪与监控（3 个工具）

主要功能

使用场景

发现入口（面向 AI Agent 和扫描器）

链接

许可证

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？