social-fetch

# /social-fetch — Pull any social post by URL Normalized fetcher for social posts across platforms. Detects platform from URL, tries strategies in order, returns the same JSON shape regardless of source. ## Step 1 — Detect platform | URL pattern | Platform | |---|---| | `x.com/<user>/status/<id>` or `twitter.com/<user>/status/<id>` | **x** (Twitter) | | `linkedin.com/posts/<slug>` or `linkedin.com/feed/update/urn:li:activity:<id>` | **linkedin** | | `linkedin.com/in/<handle>` (profile, recent activity) | **linkedin-profile** | | `instagram.com/p/<id>` or `instagram.com/reel/<id>` | **instagram** | | `tiktok.com/@<user>/video/<id>` | **tiktok** | | `bsky.app/profile/<handle>/post/<rkey>` | **bluesky** | | `reddit.com/r/<sub>/comments/<id>/...` | **reddit** | | `<mastodon-instance>/@<user>/<id>` (e.g. mastodon.social, hachyderm.io) | **mastodon** | | `threads.net/@<user>/post/<id>` | **threads** | | `news.ycombinator.com/item?id=<id>` | **hn** | | `youtube.com/watch?v=<id>` or `youtu.be/<id>` | → defer to `watch-video` | If the URL doesn't match any pattern, ask the user what platform it is. ## Step 2 — Pick strategy chain Read `references/strategies.md` for the per-platform strategy chain. Each platform has 2–5 strategies tried in order. Key principles: - **Free strategies first** (direct APIs, agent-browser) - **Paid only as fallback** (ScrapeCreators / Apify) — and only if the env key is set - **Bluesky / Mastodon / HN / Reddit are free + reliable** (public APIs) - **...