og-refresh: Link Preview (Open Graph) Refresher
A CLI that refreshes your link previews on Facebook and LinkedIn after a deploy — and finds the OG-tag bugs that keep previews from showing.
This app is open on GitHub. Fork it, use it and build on it. I like giving it to the community.
About the project
When you ship a new site or change a share image, platforms keep serving the old link preview — Facebook for up to 30 days. And LinkedIn silently drops WebP images, so the preview doesn't render at all. og-refresh forces Meta (Facebook, Instagram, Messenger) to re-read your pages right away, and lints your pages for exactly those Open Graph traps (WebP, missing dimensions, oversized images).
It started as a by-product of moving the AI First site to a new platform, where I needed to refresh previews across nearly 200 pages at once. It's fully deterministic (no LLM to run), open source, and dependency-light. A neat piece of vibe coding: a small thing you build in an evening that saves you repetitive manual work in Facebook's and LinkedIn's debuggers.
What you get
- New link previews show up immediately, not days later.
- Catches the WebP trap that makes LinkedIn render no image.
- Checks your whole site straight from the sitemap.
- Free, open source, no AI and no subscription.
How it works (under the hood)
- Re-scrape via the Meta Graph API — self-paces against the rate limit and resumes.
- OG-tag linter: WebP, dimensions, image weight, twitter:card.
- Input from URLs, a file, or a sitemap.
- Plain Python, single dependency (python-dotenv).
Built with
Want to build like this too?
I teach building apps without programming in the AI First course.
More from Tool
Shoutbase: Testimonials Manager
An internal tool for managing testimonials: a queue of who to ask, a collection of what we've gathered, and an overview of where we use them.
Toucan: A Shared Second Brain for the Team
A shared cloud knowledge base that the team and its AI agents draw from, a "second brain" connected to my local context1.
Running a Project's Marketing Through Claude Code
A marketing team as a set of Claude Code skills: a director, department managers, and specialists that run a project alongside me.