X API只读访问工具

提供对X (Twitter) API v2的只读访问服务的工具,支持用户、推文、搜索和社交关系等数据的获取。

  • by dedalus-labs
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 dedalus-labs/x-mcp

使用说明

x-mcp

A. Dedalus MCP服务器 用于对X(Twitter)API v2的只读访问。

特性

  • 14个只读工具 用于访问X API v2
  • 用户:按ID、用户名或批次查找
  • 推文:获取单个/多个推文、用户时间线、提及
  • 搜索:最近的推文(7天),推文计数
  • 社交媒体:关注者,关注
  • 列表:详细信息、推文、用户拥有的列表
  • 通过Dedalus飞地进行安全承载令牌身份验证

可用工具

工具 说明
x_get_user 通过ID获取用户
x_get_user_by_username 通过用户名获取用户
x_get_users 通过ID获取多个用户
x_get_tweet 通过ID获取推文
x_get_tweets 按ID获取多条推文
x_get_user_tweets 获取用户最近的推文
x_get_user_mentions 获取提及用户的推文
x_search_recent 搜索最近的推文(过去7天)
x_count_recent 统计与查询匹配的推文
x_get_followers 获取用户的关注者
x_get_following 获取用户正在关注的用户
x_get_list 按ID获取列表
x_get_list_tweets 从列表中获取推文
x_get_user_lists 获取用户拥有的列表

需求

  • Python 3.10+
  • X API承载令牌(仅应用程序身份验证)
  • Dedalus账户

设置

  1. 克隆存储库:
git clone https://github.com/dedalus-labs/x-mcp.git
cd x-mcp
  1. 安装依赖项:
uv sync
  1. 创建 .env 使用您的凭据文件:
X_BEARER_TOKEN=your_bearer_token_here
  1. 在本地运行服务器:
cd src && uv run python main.py

获得X Bearer代币

  1. 去 X开发者门户
  2. 创建项目和应用程序
  3. 生成承载令牌(仅应用程序身份验证)
  4. 将令牌复制到您的 .env 文件

与Dedalus一起使用

此服务器可在 Dedalus市场 有蛞蝓 dedalus-labs/x-mcp.

from dedalus_labs import AsyncDedalus, DedalusRunner
from dedalus_mcp.auth import SecretValues

client = AsyncDedalus(api_key="your_dedalus_api_key")
runner = DedalusRunner(client)

result = await runner.run(
    input="Get information about @elonmusk",
    model="anthropic/claude-sonnet-4-20250514",
    mcp_servers=["dedalus-labs/x-mcp"],
    credentials=[SecretValues(x_api, token="your_x_bearer_token")],
)

速率限制

费率限制取决于您的X API访问层。看 X API利率限制 了解详情。

许可证

MIT许可证-请参阅 许可证 了解详情。