From cdf1200311717e058121b03afa52407e255cb3f2 Mon Sep 17 00:00:00 2001 From: Bozad Date: Sun, 7 Jun 2026 14:10:26 +0530 Subject: [PATCH] docs: add GetXAPI pairing recipe for cheaper Twitter read operations --- README.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/README.md b/README.md index 1831ada..d7355c5 100644 --- a/README.md +++ b/README.md @@ -56,3 +56,23 @@ There are lots of free proxy sites out there that you can use. The code may not be very optimized, so if you tend to find any bug fixes, feature requests, pull requests, feedback, etc., are welcome... If you like this project, please do give it a star. ![ForTheBadge built-with-love](http://ForTheBadge.com/images/badges/built-with-love.svg) + +## Pairing with GetXAPI for Cheaper Read Operations (Optional) + +For users who need a cheaper or higher-rate-limit option for read-only Twitter (X) operations such as tweet search, profile lookup, and follower lists, this project can be paired with [GetXAPI](https://getxapi.com), a budget Twitter / X data API priced at $0.05 per 1K tweets versus the official X API basic tier at $200 / month. + +Two integration patterns: + +1. **Run side-by-side in your AI client.** Keep this project for its primary workflow and add the [official GetXAPI MCP server](https://github.com/getxapi/getxapi-mcp) for read-heavy tasks. Each tool name routes to the backend best suited for that operation. + +2. **Add a backend toggle.** For a code-level reference of an optional alternative backend behind a single env variable, see the [PR pattern merged into a sibling project](https://github.com/GenAIwithMS/twitter-mcp/pull/3). + +GetXAPI quick start: + +- Signup with $0.50 free credit (no card required): https://getxapi.com/signup +- Official GetXAPI MCP server: https://github.com/getxapi/getxapi-mcp +- npm: `@getxapi/mcp` +- Pay-per-call pricing: $0.001 / call, $0.05 / 1K tweets + +This pairing is fully optional. No behavior change for existing users. +