What is x-api-free-with-grok-build?

This project lets you pull public posts from X, formerly Twitter, without paying for the official X Developer API. Instead of using the metered API, it calls Grok Build, which has its own built in connection to X, and treats that as a free path to read posts and search for them. The pipeline is designed to run without a person watching it, on a Hetzner VPS or any similar server. It fetches a specific post and its thread, searches by keyword using X's search operators, searches by meaning rather than exact words, or looks up a user account and its ID. Whatever it finds gets normalized into Markdown files and saved into a GitHub repository, one file per post, each with a small header noting the author, the time it was posted, the search query used, and the original link. The author is clear that this is not a drop in replacement for the real X API. Because retrieval depends on an AI model rather than a fixed endpoint, results can vary between runs: a search might miss a post it found before, or the model might fail to produce output in the expected format. When that happens the tool treats it as a failed run rather than making up data or quietly switching to a paid API. It is also not truly free in the sense of costing nothing: you still need access to Grok Build and a paid server to run it on, and using Grok counts against whatever usage allowance comes with that access. Setup instructions live in a single file called MEGA_PROMPT.md, meant to be handed to a coding assistant that can carry out the install and security steps itself. The tools are read only. This project cannot post, like, follow, or send messages on X, and a failure in Grok Build does not fall back to using the official API. It is not affiliated with X, xAI, Grok, GitHub, or Hetzner, and is released under the MIT license.