X API - Twitter API Python 客户端¶

高性能的 Twitter (X) API Python 客户端，使用 Rust + PyO3 实现，提供完整的 Twitter 平台功能支持。

特性¶

高性能 - Rust 实现，提供原生性能
安全可靠 - 内置 JA3/TLS 指纹模拟，增强反检测能力
Python 友好 - 完整的异步 API，符合 Python 惯用风格
模块化设计 - 清晰的模块划分，易于使用和扩展
强类型 - 完整的类型提示支持
详细日志 - 完整的操作日志和错误追踪

功能模块¶

模块	功能	状态
dm	私信发送（单条、批量、自定义文案）	已完成
upload	图片和视频上传	已完成
posts	发帖、删帖、点赞、转发	已完成
user	用户资料查询和编辑	已完成
inbox	收件箱查询	已完成

安装¶

pip install x-api-rs

快速开始¶

import asyncio
from x_api_rs import Twitter

async def main():
    # 创建客户端（使用 cookies 认证）
    client = Twitter(cookies="your_cookies_here")

    # 发送私信
    result = await client.dm.send_message("123456", "Hello!")
    if result.success:
        print(f"发送成功，事件ID: {result.event_id}")

    # 上传图片
    with open("image.jpg", "rb") as f:
        image_bytes = f.read()
    upload_result = await client.upload.image(image_bytes, "tweet_image")

    # 发帖（带图片）
    tweet_result = await client.posts.create_tweet(
        text="Hello World!",
        media_ids=[upload_result.media_id_string]
    )

    # 获取用户资料
    user = await client.user.get_profile("elonmusk")
    print(f"用户: {user.name}, 粉丝: {user.followers_count}")

asyncio.run(main())

文档导航¶

快速开始 - 5 分钟上手指南
API 文档 - 详细的 API 接口说明
示例代码 - 各种使用场景的示例
开发指南 - 参与项目开发
架构设计 - 了解项目架构

许可证¶

本项目采用 MIT 许可证。详见 LICENSE 文件。