Search everything you’ve liked on X.
A local archive of your likes, with the text read out of images, the linked articles saved, and an MCP server so Claude can search it too.
git clone https://github.com/excellent-so/x-likes.git
What you get
- 01
It reads the images
Every image gets a caption and its text read out, so a screenshot of code turns up in a search.
- 02
It keeps the articles
Links are unwrapped and each page’s readable text is saved with the like.
- 03
Search by meaning
Find a like by what it’s about, even when it shares no words with your search. The embeddings are made on your machine.
- 04
Claude can search it
An MCP server over the same database, with filters for tag, author, images and links.
Search by meaning
No like contains both words, so x-likes ranks by meaning. The top row is retries, offline-first sync, a latency chart and load shedding, and none of those posts says "flaky" or "networks".
It reads your images
Search reaches past the post. Here "latency" finds the diagram and the terminal screenshot by the text inside the image, and the offline-first post by the article it links to.
One like, opened
Open a like to see its image full size, the article behind its link, its tags and the likes related to it. Every like has its own link.
Filters, in the dark
Show only images or links, sort by date or best match, or narrow to a tag or a person. Dark is one click, and the page remembers it.
How it works
- 1
Get your archive
X: Settings › Your account › Download an archive of your data - 2
Build the archive
pnpm ingest ~/Downloads/twitter-….zip pnpm hydrate && pnpm enrich - 3
Search it
pnpm serve # http://localhost:4321
Details
- Needs
- Node 22, pnpm and your X data archive
- Your data
- A SQLite file on your machine
- Image text
- Claude with your Anthropic key, or an offline mock
- Embeddings
- A small model that runs on your machine
- License
- MIT
Why I made it
Most of what I like on X is screenshots of code and text. Now Claude can search them.
Matt Waite
Try x-likes.
Free and MIT licensed. Coming soon: the code goes public at launch.
git clone https://github.com/excellent-so/x-likes.git