English Français العربية

io.github.yxs1640-png/xflux

السجل الرسمي البحث والويب

X/Twitter read API for agents: search, timelines, Smart Money. Claude/Cursor MCP. Not for posting.

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع io.github.yxs1640-png/xflux؟

  • Read API — public profiles, timelines, single tweets, and search. Bearer key, JSON.
  • Monitors — watch @handles on a schedule. New tweets are delivered with a signed webhook on paid plans. Create monitors in the Dashboard, not by posting to the API.
  • Smart Money — ranked KOL accounts and recent calls (read-only).
  • MCP server — the same read API inside Claude Desktop, Cursor, and other MCP clients.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @xflux/xflux-mcp-server
Claude Code 
claude mcp add xflux -e 'XFLUX_API_KEY=<your xflux_api_key>' -e 'XFLUX_API_BASE=<XFLUX_API_BASE>' -- npx -y @xflux/xflux-mcp-server@1.2.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "xflux": {
            "command": "npx",
            "args": [
                "-y",
                "@xflux/xflux-mcp-server@1.2.1"
            ],
            "env": {
                "XFLUX_API_KEY": "<your xflux_api_key>",
                "XFLUX_API_BASE": "<XFLUX_API_BASE>"
            }
        }
    }
}

متغيرات البيئة

  • XFLUX_API_KEY إلزامي سري API key from https://www.xfluxapi.com/dashboard/api-keys (free tier available)
  • XFLUX_API_BASE Optional API base URL (default https://www.xfluxapi.com/api/v1)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. XFlux
  2. What it does
  3. REST API
  4. MCP
  5. Recipes
  6. This repository
  7. License

XFlux

Read-only X/Twitter API for agents and apps: profiles, search, timelines, account monitors with signed webhooks, and Smart Money. Not for posting.

Site: xfluxapi.com · MCP: xfluxapi.com/mcp · Agents: llms.txt

Free tier: 1,000 calls/month, 1 monitor, no credit card. Paid plans add signed HTTP webhooks and higher quotas.

What it does

  • Read API — public profiles, timelines, single tweets, and search. Bearer key, JSON.
  • Monitors — watch @handles on a schedule. New tweets are delivered with a signed webhook on paid plans. Create monitors in the Dashboard, not by posting to the API.
  • Smart Money — ranked KOL accounts and recent calls (read-only).
  • MCP server — the same read API inside Claude Desktop, Cursor, and other MCP clients.

This service does not post tweets, send DMs, or require official X API approval.

REST API

Base URL: https://www.xfluxapi.com/api/v1

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

Get a key at Dashboard → API Keys.

MethodPathDescription
GET/api/v1/users/:usernameProfile
GET/api/v1/users/:username/tweetsTimeline
GET/api/v1/tweets/:idOne tweet
GET/api/v1/search?q=Search tweets
GET/api/v1/monitorsYour monitors (read-only)
GET/api/v1/monitors/:id/hitsHits for one monitor (read-only)

Docs: https://www.xfluxapi.com/docs

MCP

Registry name io.github.yxs1640-png/xflux. npm package @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"
      }
    }
  }
}
ToolDescription
xflux_get_userProfile by @username
xflux_search_tweetsSearch recent tweets
xflux_get_user_tweetsUser timeline
xflux_get_tweetOne tweet by ID
xflux_list_monitorsList monitors (read-only)
xflux_get_monitor_hitsHits for one monitor
xflux_smart_money_listRanked Smart Money accounts
xflux_smart_money_profileOne Smart Money profile
xflux_smart_money_claimsRecent Smart Money calls

Server details: mcp-server/README.md. Docs: https://www.xfluxapi.com/docs/integrations/mcp

Recipes

This repository

The public product runs from this repo: the website on Vercel, the API proxy and monitor worker on Fly.io, and the MCP package in mcp-server/. Deploy notes: docs/DEPLOYMENT.md.

License

MIT

الأسئلة الشائعة

ما هو io.github.yxs1640-png/xflux؟

X/Twitter read API for agents: search, timelines, Smart Money. Claude/Cursor MCP. Not for posting.

كيف أثبّت io.github.yxs1640-png/xflux؟

يعمل على جهازك. في Claude Code: claude mcp add xflux -e 'XFLUX_API_KEY=<your xflux_api_key>' -e 'XFLUX_API_BASE=<XFLUX_API_BASE>' -- npx -y @xflux/xflux-mcp-server@1.2.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.yxs1640-png/xflux إلى مفتاح API؟

نعم. يتطلب XFLUX_API_KEY، وتضبطها في إعداداته.

هل io.github.yxs1640-png/xflux مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.yxs1640-png/xflux؟

ينشره yxs1640-png. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.