skills.rest
imMamdouhaboammar
imMamdouhaboammarCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

social-fetch

Fetch social media posts by URL and return normalized structured JSON across platforms.

Updated Aug 13, 2026
Search Tags:#structured data#social media#twitter#fetch#linkedin#scraping#api fallback
One-click install
npx skills add https://github.com/imMamdouhaboammar/marketing-skills --skill social-fetch-immamdouhaboammar
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: social-fetch
Source: https://github.com/imMamdouhaboammar/marketing-skills/tree/main/skills/social-fetch
Command: npx skills add https://github.com/imMamdouhaboammar/marketing-skills --skill social-fetch-immamdouhaboammar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Social posts live behind logins, anti-bot walls, and inconsistent APIs, making it hard to reliably pull a tweet, LinkedIn post, or Reddit thread into a research or marketing workflow. This Skill detects the platform from any URL, tries a chain of free and paid strategies, and returns one consistent JSON shape regardless of source. ## Core Features & Use Cases - Multi-platform URL detection: Recognizes X, LinkedIn, Instagram, TikTok, Bluesky, Reddit, Mastodon, Threads, and Hacker News URLs automatically. - Fallback strategy chains: Tries free public APIs first (Bluesky, Mastodon, HN, Reddit), then agent-browser scraping, Wayback Machine, and paid APIs (ScrapeCreators, Apify) only when keys are configured. - Normalized output schema: Returns author, posted_at, text, media, engagement counts, threads, and replies in the same JSON structure for every platform, with null for missing fields. - Optional enrichments: Flags for fetching replies, full threads, raw responses, media downloads, and 24-hour caching to conserve API quota. - Use Case: While running a deep-research brief, you encounter a relevant X thread URL. The Skill fetches it, normalizes the author, text, and engagement data, and hands structured JSON to the research brief instead of a screenshot. ## Quick Start Ask the agent to fetch this post and show its author, text, and engagement: /social-fetch followed by the post URL.

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 fetch command. Free strategies return a preview with text, author, and basic engagement; full threads and replies require a ScrapeCreators or Apify API key set as an environment variable.

Which social platforms can be fetched without paid API keys?▼

Bluesky, Mastodon, Hacker News, and Reddit work fully for free via public APIs. X returns preview data only, LinkedIn profiles show recent activity, and Instagram, TikTok, and Threads return only Open Graph metadata without paid keys.

How do I fetch LinkedIn posts or profile activity?▼

Profile URLs work through agent-browser after dismissing the signup modal, exposing recent activity. Specific post URLs usually require the ScrapeCreators or Apify paid fallback configured via environment variables.

Why does fetching fail on Instagram, TikTok, or Threads?▼

These platforms use heavy anti-bot protection, so free strategies only return Open Graph metadata. Reliable fetching with engagement data requires setting SCRAPECREATORS_API_KEY or APIFY_API_TOKEN as described in the auth-keys reference.

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, skip the cache, and on X require a paid key since free strategies cannot retrieve them.

What happens when a post is private or deleted?▼

Private or deleted content is a hard stop that no strategy chain can recover. For deleted posts, the Skill tries the Wayback Machine as a last resort and otherwise reports which strategies failed and why.

Related Skills

Explore More Marketing & Sales Skills→
ankitjh4ankitjh4

find-missed-connections

Fetch recent Craigslist New York missed connections and summarize stories with locations.

Community
Intermediate
ever-oliever-oli
3

blogwatcher

Monitor blogs and RSS/Atom feeds for updates and unread tracking.

Community
Intermediate
gaoming-agaoming-a

youtube-search-agent

Retrieve YouTube videos, transcripts, metadata, and comments for market research.

Community
Intermediate
portermetricsampleportermetricsample
17

meta-ads-account-safety

Enforce Meta Marketing API compliance for ad account automation.

Community
Advanced