Mcp X Intelligence

mcp-x-intelligence — 面向 Claude、Cursor 和 AI Agent 的 X/Twitter 研究 MCP

直接通过 Claude、Cursor、Windsurf 或任何兼容 MCP 的 AI Agent，搜索热门内容、分析 X 账号、追踪趋势话题并发现细分领域领军者。由 twitterapi.io 提供支持。不发布内容。不发私信。纯只读研究。

---

功能介绍 — 面向 AI Agent 的 4 种 X 研究工具

工具	功能	提示词示例
search_viral_content	按关键词查找热门帖子，并使用互动指标筛选（点赞、转发、时间范围）	“找出过去 48h 内关于 AI Agent 的热门帖子”
analyze_account	完整的个人资料分析：关注者、热门帖子、互动率、活跃时段	“分析 @fluyeporlaweb，并告诉我其最佳内容策略”
get_trending_topics	实时查看各国趋势话题	“西班牙和墨西哥现在有哪些热门话题？”
get_niche_leaders	按关注者数量排序，查找任意细分领域中的热门账号	“X 上排名前 10 的 AI 工具创作者有哪些？”

---

兼容所有主流 MCP 客户端

Claude Desktop · Claude Code · Cursor · Windsurf · Cline · Codex CLI · Gemini CLI · 任何兼容 MCP 的 AI Agent

---

快速开始

选项 1 — 通过 MCPize 使用托管版本（无需设置）

推荐给非技术用户。 无需 API 密钥，无需 Node.js，无需安装任何内容。连接后即可开始研究。

→ 在 MCPize 上使用 mcp-x-intelligence

套餐	每月调用次数	价格
免费	50	免费
Pro	1,000	$9/mo

---

选项 2 — BYOK：自带 twitterapi.io 密钥（免费）

使用自己的 API 密钥，直接连接到我们的托管端点。无需设置服务端——我们会为你托管 MCP 服务。

步骤 1 — 获取免费的 twitterapi.io API 密钥

在 twitterapi.io 注册，并从控制面板复制密钥。

步骤 2 — 将 MCP 服务添加到 AI 客户端配置中

选择下方的客户端，并将 YOUR_TWITTERAPI_KEY 替换为你的实际密钥。

Windows 上的 Claude Desktop

配置文件：%LOCALAPPDATA%\Packages\Claude_...\LocalCache\Roaming\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "x-intelligence": {
      "command": "cmd",
      "args": [
        "/c", "npx", "-y", "mcp-remote",
        "https://mcp-x-intelligence.fluyeporlaweb.workers.dev/mcp",
        "--header", "x-twitterapi-key: YOUR_TWITTERAPI_KEY"
      ]
    }
  }
}

Mac 上的 Claude Desktop

配置文件：~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "x-intelligence": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp-x-intelligence.fluyeporlaweb.workers.dev/mcp",
        "--header", "x-twitterapi-key: YOUR_TWITTERAPI_KEY"
      ]
    }
  }
}

Cursor / Windsurf / Cline

与上方 Mac 的配置相同。将其添加到 MCP 设置 JSON 文件中。

步骤 3 — 重启 AI 客户端并验证

向 AI 助手提问：

“你有哪些可用工具？”

你应该会看到列出的 x-intelligence 工具。

---

工具参数参考

search_viral_content

query         string   required  Search keyword or phrase
min_likes     number   optional  Minimum likes (default: 50)
min_retweets  number   optional  Minimum retweets (default: 0)
hours_back    number   optional  Hours back to search (default: 48)
limit         number   optional  Max results (default: 20)

analyze_account

username      string   required  X username without @
tweets_limit  number   optional  Tweets to analyze (default: 20)

get_trending_topics

woeid         number   optional  Where On Earth ID (default: 1 = Worldwide)
                                 23424977=USA · 23424950=Spain · 23424900=Mexico
                                 23424747=Argentina · 23424791=Colombia

get_niche_leaders

keyword       string   required  Niche or topic keyword
limit         number   optional  Max accounts (default: 10)

---

使用 AI 进行 X 研究的场景

• 内容创作者 — 在撰写下一条串文或帖子前，了解你的细分领域中正在走红的内容
• 营销人员 — 零成本进行竞品账号分析和实时趋势监控
• 开发者 — 基于实时 X 数据构建研究工作流和内容策略工具
• 研究人员 — 无需承担官方 X API 的费用即可收集社交媒体数据

---

可尝试的示例提示词

• "搜索过去 48 小时内关于 Claude MCP 且点赞数超过 100 的热门帖子"
• "分析账号 @OpenAI——他们最受欢迎的 5 条帖子是什么？他们通常在什么时候发帖？"
• "墨西哥和阿根廷现在有什么热门话题？"
• "找出 X 上 AI 工具领域排名前 10 的账号"

---

为什么不使用官方 X API？

官方 X API 按使用量计费， 没有月度最低消费。不过它仍然需要： 开发者账号审批流程、OAuth 2.0 身份验证设置， 以及连接 Claude 等 AI Agent 的自定义集成工作。

mcp-x-intelligence 消除了所有这些麻烦。 一个来自 twitterapi.io 的 API 密钥，一个配置块，搞定。

	官方 X API	mcp-x-intelligence
定价模式	按使用量付费（无最低消费）	免费（BYOK）或托管版 $9/mo
设置时间	需要开发者账号审批	几分钟
原生支持 MCP	否——需要自定义集成	是——即插即用
适用于 Claude	手动集成	原生支持
身份验证复杂度	需要设置 OAuth 2.0	单个 API 密钥

---

故障排除

“工具执行失败”或 RuntimeError

确保使用 v1.2.0 或更高版本。 早期版本存在架构兼容性问题， 会影响 Hermes、Cursor 和 Windsurf 用户。

MCPize 上的托管端点始终保持最新。

AI 客户端中未显示工具

1. 检查配置文件中的 JSON 语法是否正确
2. 完全重启 AI 客户端（不只是关闭窗口）
3. 在 twitterapi.io/dashboard 验证 twitterapi.io 密钥是否有效

结果为空

如果出现以下情况，某些查询可能不会返回结果：

• 关键词过于具体
• 时间范围（hours_back）过短
• 互动筛选条件（min_likes）过高

尝试放宽搜索参数。

速率限制

twitterapi.io 对免费账号实施速率限制。 如果在发送许多请求后遇到错误，请等待几分钟 再重试。

---

开发者

@fluyeporlaweb — 提供西班牙语的 AI 工具、自动化和开发者资源。

加入社区：t.me/fluyeporlaweb

已列入 Smithery

---

许可证

MIT——你想怎么用都行。