twitter-signal-mcp

twitter-signal-mcp

在 Claude、Cursor 或任何 MCP 客户端中进行实时 X/Twitter 搜索 和 AI 趋势摘要 — 无需 Twitter/X API 密钥，无需订阅，也没有月度最低消费。 你的 Agent 使用 x402 在 Base 上以 USDC 付款，每次调用的费用不到一美分。

x_search           $0.02/call    up to 20 newest matching tweets + engagement
x_digest           $0.05/call    the same tweets + an AI-written trend summary
x_leads            $0.05/call    the people behind matching posts, enriched (bio, website, emails, followers)
x_pain_points      $0.05/call    clustered complaints / feature requests / praise for a product, with quotes
x_user_timeline    $0.02/call    one account's own recent posts
x_profile          $0.02/call    one account's bio, stats, and links
x_tweet            $0.01/call    one tweet by ID, full text + engagement
x_replies          $0.02/call    the reply thread under one tweet
x_find_accounts    $0.02/call    accounts matching a name/topic, not posts
x_account_verdict  $0.02/call    AI read on whether an account is worth engaging
x_watch            $0.05/call    only the posts newer than your last check
x_ticker_pulse     $0.02/call    facts about a US stock ticker's X activity — no sentiment/advice
x_list             $0.05/call    2-50 handles' combined recent posts, one call, no OR-splitting
x_followers        $0.02/call    one page of an account's followers
x_following        $0.02/call    one page of who an account follows
x_mentions         $0.02/call    one page of posts mentioning a handle
x_engagers         $0.05/call    who quoted / who retweeted one post
x_person           $0.15/call    one handle's enriched person card (role, company, contact routes)
x_leads_deep       $0.20/call    the whole search-to-contact leads chain in one call, people enriched + clustered

为什么要做这个项目

官方 X API 从月度订阅和开发者账号审批开始。如果 Agent 只是想了解人们此刻在说什么，为少量查询做这么多准备工作并不划算。这个服务按请求收费 — 一百次搜索约花费 60 美分，而且没有任何需要取消的项目。

工具

x_search — $0.02

支持完整的高级搜索语法。最多返回 20 条最新匹配结果，包含作者账号名、粉丝数、文本、时间戳、永久链接、点赞数、转发数、回复数和浏览量。需要超过 20 条？ 完整结果的末尾会附带 next.older — 将其 cursor 值（使用相同的 query）传回，即可获取接下来 20 条更早的匹配结果，每页 $0.02。无需手动按日期切分。

x_digest — $0.05

包含上述所有内容，另加仅根据返回的推文生成的 AI 摘要：

{
  "summary": "3-5 sentences on what's actually being said",
  "sentiment": "positive | negative | mixed | neutral",
  "sentiment_note": "why it leans that way",
  "key_themes": ["..."],
  "driving_accounts": ["@handle", "..."],
  "notable_post_urls": ["https://x.com/..."]
}

想了解要点时使用 x_digest；想查看原始帖子时使用 x_search。

x_leads — $0.05

使用与 x_search 相同的高级搜索语法，但返回匹配帖子背后的人，而不是帖子本身 — 包含个人简介、网站、简介中找到的邮箱、粉丝数、所在地、是否开放私信的标记，以及每个人的所有匹配帖子：

{
  "result_count": 20,
  "lead_count": 8,
  "leads": [{ "username": "someone", "followers": 5000, "emails": [], "matched_posts": [] }]
}

输入：query（必填，语法与 x_search 相同）、max（可选，"20" 或 "40" — 默认值为 20）。 适用于招聘、寻找联合创始人、B2B 潜在客户开发、发现影响者和寻找社区。

x_pain_points — $0.05

传入产品或品牌名称／账号名，即可从实时 X 帖子中提取并归类用户投诉、功能请求和好评，并附上原文引述和 URL：

{
  "product": "Cursor",
  "analysis": { "summary": "...", "pain_points": [{ "theme": "...", "count": 4, "severity": "medium" }] }
}

输入：product（必填 — 名称或 X 账号名）。适用于产品调研、竞品调研、流失信号分析和路线图规划。

x_user_timeline — $0.02

某个账号自己的近期帖子（原创、回复、转发），按时间倒序排列。输入：username（必填）。用法：x_user_timeline username="elonmusk"，跟踪竞争对手或创始人自己的动态。

x_profile — $0.02

单个账号的个人简介、网站、所在地、加入日期、粉丝数／关注数以及认证状态。 输入：username（必填）。用法：x_profile username="cursor_ai"，在联系潜在客户之前评估其资格。

x_tweet — $0.01

通过数字 ID 获取单条推文：完整文本、作者、时间戳、永久链接和互动数据。输入：id（必填）。 用法：x_tweet id="1859012345678901234"，重新查看已找到的特定帖子。

x_replies — $0.02

获取某条推文下的回复串，按时间倒序排列。输入：id（必填，与 x_tweet 相同）。用法： x_replies id="1859012345678901234"，查看人们对某条特定帖子的反应。

x_find_accounts — $0.02

搜索符合名称、关键词或主题的账号 — 而不是帖子。输入：query（必填，语法与 x_search 相同）。用法：x_find_accounts query="solar installer hawaii"，整理一份待联系账号的候选名单。

x_account_verdict — $0.02

对单个账号进行简短的 AI 评估：账号的主题、活跃度／互动度，以及是否值得进一步联系。输入：username（必填）。用法：x_account_verdict username="someone"，无需亲自阅读个人资料，即可快速筛选潜在客户。

x_watch — $0.05

执行与 x_search 相同的搜索，但只返回比你提供的游标更新的帖子。输入：query（必填）、since（可选 — ISO 时间戳或上次调用 x_watch 时返回的 cursor.newest_id）。用途：定期监控品牌／股票代码／话题标签，无需重复为已查看过的帖子付费。 如果检查后没有发现新内容，则不收费 — 只有出现新消息时才需要付费。

x_ticker_pulse — $0.02

面向交易 Agent，提供一只美国股票的 X/Twitter 活动情况：与上一时间窗口相比的帖子数量、按点赞数排序的热门帖子、最活跃的账号，以及关键词主题标记（财报、业绩指引、诉讼、SEC 调查、召回、并购、裁员、上调/下调评级、做空报告、股息、回购、CEO）。输入：ticker（必填，1–6 个字母，可带或不带前导 $），window（可选，默认 24h，或 7d）。用法：x_ticker_pulse ticker="TSLA" window="24h"。 仅提供事实——只统计数量并匹配关键词，绝不提供情绪判断、目标价或买入/卖出/持有信号。

x_list — $0.05

一次调用即可获取 2–50 个账号近期帖子的合并列表，按时间从新到旧排序并去重，包含各账号的帖子数量，以及用于下次仅获取新内容的 since 游标——无需将关注列表拆分成多个 from:a OR from:b x_search 调用（X 限制了单次搜索可包含的 OR 条件数量）：

{
  "handle_count": 3, "result_count": 40, "truncated": true,
  "per_handle_counts": { "elonmusk": 20, "naval": 12, "balajis": 8 },
  "cursor": { "newest_id": "1967000000000000001" },
  "tweets": [{ "author": "elonmusk", "text": "...", "likes": 1234 }]
}

输入：handles（必填——以逗号或空格分隔，@ 可选，2–50 个账号），since（可选——ISO 时间戳，或来自 cursor.newest_id 的推文 ID），limit（可选，1–100，默认 40）。用法：x_list handles="elonmusk,naval,balajis"，一次调用即可查看关注列表。

x_followers — $0.02

获取一个账号粉丝列表的一页（最多显示 20 人）：账号名、姓名、简介、粉丝数/关注数、认证状态、是否开放私信。输入：username（必填），cursor（可选，来自先前调用的 next.older）。用法：x_followers username="elonmusk"，用于受众研究或寻找潜在客户。

x_following — $0.02

获取一个账号关注对象的一页（最多显示 20 人），字段与 x_followers 相同。输入：username（必填），cursor（可选）。用法：x_following username="elonmusk"，用于梳理账号的关系网络。

x_mentions — $0.02

获取提及某个账号的一页帖子（最多显示 20 条）：作者、粉丝数、文本、时间戳、永久链接、互动数据。输入：username（必填），cursor（可选）。用法： x_mentions username="cursor_ai"，用于品牌监测或声誉追踪。

x_engagers — $0.05

查看引用和转发某条帖子的用户（每类最多 20 人）：账号名、姓名、简介、粉丝数、认证状态：

{ "id": "1878000000000000000", "quote_count": 5, "retweeter_count": 40, "quotes": [], "retweeters": [] }

输入：id（必填，与 x_tweet 相同）。用法：x_engagers id="1878000000000000000"，从热门帖子的受众中寻找传播者或潜在客户。

x_person — $0.15

提供账号名，即可获取丰富的个人资料卡：姓名、职位、公司、工作内容、主题、资历估计、联系方式（在其个人网站或简介中找到的邮箱、LinkedIn、GitHub、是否开放私信），以及事实信息（粉丝数、账号年龄、每周发帖数、网站）。只有实际找到邮箱时才会报告，绝不猜测。输入：username（必填）。用法：x_person username="naval"。 X402_MAX_PRICE 至少需要设置为 0.15（见 Setup）。

x_leads_deep — $0.20

一次调用即可完成搜索 → 个人资料 → 联系方式的全流程。最多搜索 4 页，按作者归类帖子，为排名靠前的 10–15 人补充其个人网站信息（邮箱、LinkedIn、GitHub），并对其进行分组，每人附上一句匹配原因：

{
  "pages_fetched": 4, "lead_count": 10, "enriched_count": 7,
  "clusters": [{ "theme": "Solidity engineers", "lead_usernames": ["someone"] }],
  "leads": [{ "username": "someone", "emails": [], "web": { "emails": [], "links": {}, "title": "..." }, "card": { "why_they_match": "..." } }]
}

输入：query（必填，语法与 x_search 相同），max（可选，"1" 至 "15"，默认 "10"）。 没有找到结果 = 不收费。X402_MAX_PRICE 至少需要设置为 0.20（见 Setup）。价格更低的初步查询：x_leads。

查询语法（x_search、x_digest、x_leads、x_find_accounts、x_watch）

这两个工具都接受一个 query 字符串：

模式	示例
关键词/短语	"rate cut" inflation
账号	from:elonmusk starship
话题标签/现金标签	#bitcoin · $NVDA
互动数下限	min_faves:100 · min_retweets:50
语言/日期	lang:en since:2026-08-01 until:2026-08-09
排除项	airdrop -giveaway

快速开始（复制粘贴）

examples/ 中有 4 个可直接使用的文件：

• examples/claude-desktop.json — Claude Desktop 配置块
• examples/claude-code.md — claude mcp add 单行命令 + Cursor mcp.json
• examples/x402-fetch.mjs — 普通 Node 脚本，无需 MCP，使用私钥钱包付款
• examples/credits-curl.sh — 无需钱包：用银行卡购买预付额度 + Bearer 密钥

设置

你需要一个已存入少量 Base 上 USDC 的 Coinbase CDP 钱包，该钱包会按调用付费。 在 portal.cdp.coinbase.com 创建一个（API 密钥 + 钱包密钥）。

Claude Desktop — 添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "twitter-signal": {
      "command": "npx",
      "args": ["-y", "twitter-signal-mcp"],
      "env": {
        "CDP_API_KEY_ID": "your-key-id",
        "CDP_API_KEY_SECRET": "your-key-secret",
        "CDP_WALLET_SECRET": "your-wallet-secret",
        "X402_MAX_PRICE": "0.05"
      }
    }
  }
}

X402_MAX_PRICE 是每次调用以 USD 计价的硬性上限。如果端点报价超过此上限， 请求会在签名前被拒绝，不会产生费用。默认值 0.05 适用于除两个高级工具外的所有 工具：x_person（$0.15）和 x_leads_deep（$0.20）。将 X402_MAX_PRICE 设为 0.25 即可启用它们（默认值特意保持为 0.05，这样 Agent 就不会 超出你的预期支出）。

费用与安全

• 只有成功获得响应才会收费。无效查询会在付款前被拒绝（HTTP 400，不结算）。
• 没有找到内容 = 不收费。 空结果 x_search / x_digest / x_leads / x_pain_points / x_watch 会以 no_results 返回，并带有 charged: false —— 不会结算付款。
• 10 分钟内重复相同调用 = 免费。 使用同一钱包重复完全相同的调用，即可免费获得 已保存的答案（meta.charged: false）。
• 如果上游推文来源在付款后发生故障，API 会明确返回 error，并记录该调用以便退款， 而不是假装调用成功。
• 手续费由 facilitator 承担 — 你只需支付 USDC。
• 60 秒内的相同查询会从缓存中返回。

工作原理

MCP client → twitter-signal-mcp → 402 challenge → sign USDC authorization
           → facilitator settles on Base → data returned

协议：x402 v2（CAIP-2 网络、PAYMENT-REQUIRED 挑战标头）。v1 客户端无法 与此 API 通信。

许可证

MIT