AI Islands
中文

xbird

Information Retrieval S rating

The Twitter/X automation tool set based on x402 micropayment supports 34 MCP tools to implement complete social functions such as tweeting, search, and interaction, and is suitable for developers to build AI-driven social media agents.

Open external ZIP download → Version：v0.1.1
OpenClaw Claude Code Cursor Codex

Usage instructions

Core usage

xbird is a set of Twitter/X integration tools for AI Agents. It provides 34 fine-grained tools through the MCP (Model Context Protocol) protocol, covering the complete life cycle of social media operations. Users need to passnpx @checkra1n/xbirdStart the local MCP server and configure the Twitter authentication cookie (auth_token, ct0) and optional wallet private key to enable x402 micropayments. The tools are divided into six categories by function: Read ($0.001/time) is used to obtain tweets, timelines, and user information; Search ($0.005/time) supports advanced search syntax; Bulk ($0.01/time) obtains user tweets in batches , watch list, etc.; Write ($0.01/time) performs interactive operations such as posting, replying, liking, and forwarding; Profile ($0.01/time) manages personal information; Media ($0.05/time) handles image and video uploads. Typical workflow includes: first callget_userParse the handle to obtain the numeric userId, and then use it for batch tools; the media must firstupload_mediaGet the mediaId and append it to the tweet.

Significant advantages

The pricing is transparent and billed by call, and the cost of low-frequency use is controllable; the tool granularity is extremely fine, and the Agent can be accurately combined to implement complex automation strategies; it supports advanced functions such as thread publishing, advanced search operators (from:/to:/since:/filter:media), and paging cursors; local operation is combined with residential IP to reduce the probability of platform risk control; the x402 payment protocol implements a pay-as-you-go model without subscription.

Potential Disadvantages and Limitations

Security architecture risks: The core logic is encapsulated in a closed-source npm package and cannot be audited locally;Credentials exposed: Sensitive cookies need to be manually extracted from the browser DevTools, which is cumbersome and error-prone;identity coupling: The Bulk tool mandates a numeric userId, adding an API round trip;payment threshold: The cost of high-frequency calls is accumulated, and there is no clear explanation of the free quota;platform dependency: Fully bound to Twitter/X private API, there is a risk of failure at any time;functional boundaries: Advanced functions such as private messages, spaces, and communities are not supported.

Suitable target group

Social media automation developers, AI Agent researchers, data analysts in brand operations teams, research institutions that need to collect public tweets in batches, and Twitter Bot prototype verifiers. It is especially suitable for individual developers or small teams who already have Twitter development experience, can accept the micropayment model, and have basic security awareness.

Risks of use

Account security: Cookie leakage can cause the account to be completely out of control, so it is recommended to use a dedicated alt account;financial risk: After the wallet private key is configured, there is a possibility of USDC being stolen and the balance needs to be controlled;Compliance risk: Automated interactions may trigger Twitter’s anti-spam policy and lead to account suspension;supply chain risk: Remote npm package updates may introduce unaudited code;performance risk: The local MCP server runs as a single point, without high availability guarantee;privacy risk: All operational data is transferred through a third-party server, and there is a man-in-the-middle attack surface.

Safety review

Core usage

xbird is a set of Twitter/X operation tools for AI Agents, integrated with Claude through the MCP (Model Context Protocol) protocol. After installation, users can use natural language instructions to let AI complete a full range of operations such as tweeting, replying, searching, liking, forwarding, bookmarking, and updating information.

Usage process：
1. Configure environment variables:XBIRD_AUTH_TOKEN、XBIRD_CT0(extracted from Twitter browser cookie), optionalXBIRD_PRIVATE_KEY(for payment)
2. Call 34 tiered pricing tools: Read ($0.001), Search ($0.005), Batch/Write/Data ($0.01), Media Upload ($0.05)
3. Key limitation: Batch tools need to be called firstget_userGet numericuserId, the media needs to firstupload_mediagetmediaIdAttach to tweet

Significant advantages

  • Fully functional: Covers the core scenarios of Twitter/X, from browsing timeline to complete posting workflow
  • AI native design: Natural language driven, no need to manually call API
  • Transparent billing: x402 micro-payment model, pay per call, no subscription burden
  • Localization portal: The MCP server runs from the user’s local IP, reducing the probability of platform risk control.

Potential Disadvantages and Limitations

  • External dependency risk: All data is transferred through the xbird MCP server and is not processed locally end-to-end.
  • Credential management burden: Twitter Cookie needs to be manually extracted and configured, and the private key is exposed at risk
  • Functional limitations: No direct message (DM) support; batch operations require a second query of userId; media upload cost is high ($0.05/time)
  • Platform policy risks: Changes to Twitter/X API terms may cause service interruption

Suitable for the crowd

  • Content creators and community operators who need to automate Twitter operations
  • Analysts who study social media data (with search tools)
  • Developers building AI Agent workflows

General risks

1. Account security: Cookie credentials leak can lead to Twitter account takeover
2. privacy exposure: Tweet content, search history, and interaction records are processed through third-party servers
3. payment risk: Private key configuration errors may lead to loss of funds
4. compliance boundary: Automated interactions may trigger Twitter’s anti-spam mechanism, posing a risk of account suspension.

content-mediasocial-mediaautomationapiproductivitymarketingdata-analytics

Copyright and takedown notice: AI Islands curates this page from public information. Skills, code, documents and packages remain the property of their original authors or rights holders. This listing is provided for indexing, research and installation convenience. If you believe any listing or download link infringes your rights, contact ai-islands@streamflowintel.com with proof of ownership, relevant URLs and your request. We will review and remove or adjust the content promptly. Review package permissions, dependencies and safety risks before installing.

Related Agent Skills