xflux

Name: xflux
Author: yxs1640-png

本地服务

github.com/yxs1640-png社交媒体01 天前更新

代码仓库

关于 xflux

xflux 是面向 Agent 和应用的只读 X/Twitter 数据服务，涵盖个人资料、帖子、搜索、账号监控和 Smart Money 账号。其 MCP 服务让 Claude Desktop、Cursor 等客户端使用同一只读 API。

主要功能

01读取公开资料和时间线
02搜索推文并获取单条帖子
03列出监控项并获取命中记录
04查看排名靠前的 Smart Money 账号及观点
05付费方案提供带签名的监控 Webhook

适用场景

01搜索有关某主题的近期帖子
02查看账号资料或时间线
03跟踪受监控账号并检查命中记录

MCP 相关

MCP 服务通过工具开放 XFlux 的只读 API，涵盖资料、搜索、时间线、推文、监控和 Smart Money 数据。它通过 XFLUX_API_KEY 环境变量连接 MCP 客户端。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "yxs1640-png-xflux": {
      "command": "npx",
      "args": [
        "-y",
        "@xflux/xflux-mcp-server"
      ],
      "env": {
        "XFLUX_API_KEY": "<XFLUX_API_KEY>",
        "XFLUX_API_BASE": "<XFLUX_API_BASE>"
      }
    }
  }
}

启动命令npx -y @xflux/xflux-mcp-server

需要配置的环境变量

XFLUX_API_KEY密钥API key from https://www.xfluxapi.com/dashboard/api-keys (free tier available)

XFLUX_API_BASEOptional API base URL (default https://www.xfluxapi.com/api/v1)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@xflux/xflux-mcp-server1.2.1stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
username	string	是	不带 @ 的用户名，例如 elonmusk

详细介绍

XFlux

面向 Agent 和应用的只读 X/Twitter API：个人资料、搜索、时间线、带签名 Webhook 的账户监控，以及 Smart Money。不支持发帖。

网站： xfluxapi.com · MCP： xfluxapi.com/mcp · Agent： llms.txt

免费套餐：每月 1,000 次调用、1 个监控项、无需信用卡。付费套餐提供带签名的 HTTP Webhook 和更高的配额。

功能

读取 API — 公开个人资料、时间线、单条推文和搜索。使用 Bearer 密钥，返回 JSON。
监控 — 按计划监控 @用户名。付费套餐会通过带签名的 Webhook 推送新推文。请在控制面板中创建监控项，而不是向 API 发送请求。
Smart Money — 排名靠前的 KOL 账户和近期观点（只读）。
MCP 服务 — 在 Claude Desktop、Cursor 和其他 MCP 客户端中使用同一读取 API。

此服务不会发布推文、发送私信，也无需获得 X 官方 API 的批准。

REST API

基础 URL：https://www.xfluxapi.com/api/v1

curl -H "Authorization: Bearer xflux_YOUR_KEY" \
  https://www.xfluxapi.com/api/v1/users/x

在控制面板 → API 密钥获取密钥。

方法	路径	描述
GET	`/api/v1/users/:username`	个人资料
GET	`/api/v1/users/:username/tweets`	时间线
GET	`/api/v1/tweets/:id`	单条推文
GET	`/api/v1/search?q=`	搜索推文
GET	`/api/v1/monitors`	你的监控项（只读）
GET	`/api/v1/monitors/:id/hits`	单个监控项的命中记录（只读）

文档：https://www.xfluxapi.com/docs

MCP

注册表名称 io.github.yxs1640-png/xflux。npm 包 @xflux/xflux-mcp-server。

export XFLUX_API_KEY=xflux_your_key_here
npx -y @xflux/xflux-mcp-server

{
  "mcpServers": {
    "xflux": {
      "command": "npx",
      "args": ["-y", "@xflux/xflux-mcp-server"],
      "env": {
        "XFLUX_API_KEY": "xflux_your_key_here"
      }
    }
  }
}

工具	描述
`xflux_get_user`	按 @用户名查询个人资料
`xflux_search_tweets`	搜索近期推文
`xflux_get_user_tweets`	用户时间线
`xflux_get_tweet`	按 ID 查询单条推文
`xflux_list_monitors`	列出监控项（只读）
`xflux_get_monitor_hits`	获取单个监控项的命中记录
`xflux_smart_money_list`	排名靠前的 Smart Money 账户
`xflux_smart_money_profile`	单个 Smart Money 个人资料
`xflux_smart_money_claims`	Smart Money 近期观点