Xpoz MCP服务器
从任何人工智能代理处搜索推特、Instagram、Reddit和TikTok。 1.5B+帖子索引。自然语言查询。CSV最多可导出50万行。不需要API密钥。
 
远程MCP服务器 --无需本地安装。通过Streamable HTTP连接并使用OAuth 2.1进行身份验证(使用Google登录,无需管理API密钥)。直接探头至https://mcp.xpoz.ai/mcp返回401 Unauthorized--这是意料之中的;您的MCP客户端处理OAuth流。
快速开始
克劳德桌面/光标/风帆
添加到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龙虾
clawhub install xpoz-social-search然后在提示时通过OAuth链接进行身份验证。还有八种预置技能可供选择——请参阅 clawhub.ai/u/atyachin.
______________________________________________________________________
SDK和CLI
如果您更愿意直接从代码或终端调用Xpoz,而不是通过MCP客户端:
Types/Node.js
npm install @xpoz/xpozpython
pip install xpoz来源: XPOZpublic/xpoz-python-sdk.
命令行界面
| 平台 | 安装命令 | |
|---|---|---|
| macOS/Linux(自制) | 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` |
| 窗户(翼子板) | winget install Xpoz.XpozCli | |
| 任何Python≥3.10的平台 | pip install xpoz-cli |
来源: XPOZpublic/xpoz-cli.
所有四个通道都使用相同的MCP协议 https://mcp.xpoz.ai/mcp 在引擎盖下,所以你在下面看到的任何工具都可以从每个表面触及。在获取API令牌 xpoz.ai/get-token.
______________________________________________________________________
平台和工具
推特/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 | 在subreddit上搜索帖子 |
getRedditPostWithCommentsById | 获取带有评论树的帖子 |
getRedditCommentsByKeywords | 按关键字搜索评论 |
searchRedditSubreddits | 按名称查找子版块 |
getRedditSubredditWithPostsByName | 获取subreddit的元数据和最近的帖子 |
getRedditSubredditsByKeywords | 按主题发现子版块 |
TikTok(7个工具)
| 工具 | 说明 |
|---|---|
searchTiktokUsers | 按名称或用户名查找创建者 |
getTiktokUser | 获取创建者个人资料(关注者、点赞、个人简介、验证) |
getTiktokUsersByKeywords | 在帖子历史中按主题发现创作者 |
getTiktokPostsByKeywords | 按关键字或标签搜索视频 |
getTiktokPostsByUser | 获取特定创作者发布的视频 |
getTiktokPostsByIds | 按ID获取特定视频 |
getTiktokCommentsByPostId | 获取对特定视频的评论 |
跟踪和监控(3个工具)
为了进行持续的品牌监控和潜在客户开发,Xpoz会在新的匹配内容出现时对其进行索引。
| 工具 | 说明 |
|---|---|
addTrackedItems | 订阅对任何平台上的查询、用户或subreddit的持续监控 |
getTrackedItems | 列出您的活动跟踪项目以及上次更新时间戳 |
removeTrackedItems | 停止按ID监视跟踪的项目 |
______________________________________________________________________
主要特点
- 自然语言查询 --描述你想要什么,Xpoz优化搜索
- CSV导出 --通过异步操作在一次下载中最多可下载50万行
- 服务器端分页 --高效处理大型结果集
- 字段选择 --仅请求您需要的字段
- 高速缓存控制 —
forceLatest: true绕过实时数据缓存 - 异步操作 --具有状态轮询的长期导出
- OAuth 2.1 -动态客户端注册Google作为上游身份提供商,无需管理API密钥
用例
- 潜在顾客开发 --找到人们讨论你的产品解决的问题
- 影响者发现 --通过创作者发布的内容来识别他们,而不仅仅是关注者数量
- 品牌监测 --跟踪提及、情绪和竞争对手活动
- 市场研究 --大规模分析趋势和对话
- 专家发现 --跨平台发现域权限
- 安全情报 --在CVE发布之前监控漏洞讨论
发现表面(用于AI代理和扫描仪)
这些公共的、机器可读的端点将Xpoz描述为爬虫和代理客户端:
| 表面 | URL |
|---|---|
| MCP清单 | https://www.xpoz.ai/.well-known/mcp.json |
| MCP工具目录(描述+JSON模式参数) | https://www.xpoz.ai/.well-known/mcp/tools.json |
| 代理技能指数(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 MCP服务器是一个托管服务——请参阅 服务条款.
