skills.rest
mintuz
mintuzCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

social-fetch

Fetches social media posts by URL and returns normalized structured JSON across platforms.

3|Updated Nov 8, 2014
Search Tags:#structured data#social media#twitter#fetch#linkedin#scraping#api fallback
One-click install
npx skills add https://github.com/mintuz/.dotfiles --skill social-fetch-mintuz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: social-fetch
Source: https://github.com/mintuz/.dotfiles/tree/main/agents/.agents/skills/social-fetch
Command: npx skills add https://github.com/mintuz/.dotfiles --skill social-fetch-mintuz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Social media posts live behind different APIs, login walls, and anti-bot defenses, making it painful to pull a tweet, LinkedIn post, or Reddit thread into a research or analysis workflow. This Skill detects the platform from any post URL, tries a chain of free and paid fetching strategies, and returns one consistent JSON shape regardless of source. ## Core Features & Use Cases - Cross-platform fetching: Supports X/Twitter, LinkedIn, Instagram, TikTok, Bluesky, Reddit, Mastodon, Threads, and Hacker News with per-platform strategy chains (direct APIs, agent-browser, Wayback Machine, ScrapeCreators, Apify). - Normalized output schema: Returns the same JSON structure (author, posted_at, text, engagement, media, thread, replies) for every platform, with null for missing fields rather than zero. - Optional enrichments: Flags for fetching replies, full threads, raw responses, and media downloads, plus a 24-hour cache to conserve paid API quota. - Use Case: While writing a research brief, you encounter a relevant X thread and a LinkedIn post. Ask the Skill to fetch both URLs and receive structured JSON with author, text, and engagement counts ready to cite. ## Quick Start Fetch this post and show me the author, text, and engagement: https://x.com/example/status/1234567890

Frequently Asked Questions about social-fetch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fetch a tweet or X post by URL?▼

Pass the x.com or twitter.com status URL to the Skill. It tries agent-browser preview, Nitter mirrors, and Wayback Machine for free, then falls back to ScrapeCreators or Apify if those API keys are set in your environment.

Which social media platforms can be fetched for free?▼

Bluesky, Mastodon, Hacker News, and Reddit have free public APIs that work reliably without any keys. X, LinkedIn, Instagram, TikTok, and Threads typically need paid fallback keys for complete data.

What API keys are needed for LinkedIn or Instagram scraping?▼

Set SCRAPECREATORS_API_KEY or APIFY_API_TOKEN in your shell environment to unlock paid fallback strategies. Without them, Instagram and TikTok return only Open Graph metadata, and LinkedIn is limited to profile activity views.

Can I fetch replies and full threads from a post?▼

Yes, use the --with-replies flag for top-level replies and --thread for same-author threads. These cost extra API quota on paid platforms and skip the cache since reply data ages quickly.

Why does fetching fail for some social media posts?▼

Private accounts and deleted posts cannot be retrieved by any strategy. For deleted content, the Skill tries the Wayback Machine; rate limits and anti-bot defenses on X, Instagram, and TikTok can also block free strategies.

Related Skills

Explore More Content & Communication Skills→
laik184laik184

podcast-marketing

Extract content atoms from podcast transcripts and generate marketing assets.

Community
Intermediate
wlzhwlzh
611

x-fetcher

Fetch X (Twitter) tweets and long-form articles into formatted Markdown files.

Community
Intermediate
RooseveltAdvisorsRooseveltAdvisors
1

VideoToSpec

Generate product specification documents from Loom, YouTube, and Vimeo videos.

Community
Advanced
starrank-softstarrank-soft

xiaohongshu-lowtop

Identify high-engagement posts from low-follower Xiaohongshu accounts.

Official
Intermediate