К основному содержанию
скилл CX Codex

social-fetch — скилл для Claude Code: что делает и как установить

Забирает содержимое поста по ссылке — твит, LinkedIn, Reddit, Bluesky, Mastodon, HN — и отдаёт его в едином структурированном виде. Срабатывает на команду /social-fetch <url> или фразу «прочитай этот тред».

MIT 531 установок ★ 932 обновлён 2026-11-11

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add coreyhaines31/makerskills --skill social-fetch -a claude-code
Открыть на GitHub

Что делает social-fetch

Скилл сам определяет платформу по URL и перебирает способы получения данных по очереди: сначала прямые API (Bluesky, Mastodon, Hacker News, Reddit), затем agent-browser с закрытием модальных окон (LinkedIn, превью X), затем Wayback Machine для старых постов, и только в конце — платные API ScrapeCreators или Apify, если заданы соответствующие переменные окружения. На выходе всегда одна и та же структура: автор, дата публикации, текст, счётчики лайков и репостов, ссылки на медиа, при необходимости — ветка и ответы.

Для X, Instagram, TikTok и Threads бесплатные способы отдают только превью поста без полного треда — ради этих данных нужен ключ SCRAPECREATORS_API_KEY или APIFY_API_TOKEN. Удалённые и закрытые посты скилл не восстановит, кроме как через архив Wayback Machine. Успешные запросы можно кэшировать на сутки в ~/Documents/social-fetches/_cache/, чтобы не тратить лимиты API повторно в рамках одной сессии.

Скилл вызывают и другие инструменты набора: deep-research — для цитирования постов в исследованиях, jab-hook — для разбора форматов у аккаунтов-примеров, business-brainstorm — для сбора комментариев конкурентов.

Какие задачи решает

  • вытащить текст твита или LinkedIn-поста по ссылке
  • собрать ветку обсуждения с Hacker News или Reddit
  • получить счётчики лайков и репостов без скринштота
  • подложить цитату конкретного поста в отчёт deep-research
  • скачать медиафайлы из поста вместе с текстом

Примеры запросов агенту

  • /social-fetch https://x.com/example/status/1234567890
  • Прочитай этот тред с Reddit и перескажи суть
  • Что написано в этом посте на LinkedIn — вытащи текст

Как установить social-fetch

1Через Skills CLI (Vercel)

npx skills add coreyhaines31/makerskills --skill social-fetch -a claude-code

2Вручную: положить файлы

~/.claude/skills/social-fetch/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/social-fetch/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о social-fetch

Как установить social-fetch в Claude Code?

Выполните npx skills add coreyhaines31/makerskills --skill social-fetch -a claude-code, скилл появится в ~/.claude/skills/social-fetch/SKILL.md.

Что делает social-fetch?

Скилл забирает содержимое поста по ссылке — твита, LinkedIn, Reddit, Bluesky, Mastodon, Threads или Hacker News — и возвращает автора, текст, дату и счётчики вовлечённости в одинаковом формате независимо от платформы.

Какие ключи нужны для полного доступа к X и Instagram?

Бесплатные способы для X, Instagram, TikTok и Threads отдают только превью поста. Для полного треда и ответов нужен ключ SCRAPECREATORS_API_KEY или APIFY_API_TOKEN в переменных окружения.

Исходный текст

SKILL.md · MIT
---
name: social-fetch
description: "When you or another skill needs to fetch the content of a social media post by URL — tweet, X thread, LinkedIn post, Instagram post, TikTok video, Bluesky post, Reddit thread, Mastodon status, Threads post, Hacker News thread. Returns normalized structured data (author, posted_at, text, engagement counts, media URLs, replies if requested) regardless of platform. Tries strategies in order: direct API (Bluesky, Mastodon, HN, Reddit), agent-browser with modal dismissal (LinkedIn, X preview), Wayback Machine (older posts), paid APIs (ScrapeCreators / Apify — only if env keys present). Triggers on \"/social-fetch <url>,\" \"fetch this tweet,\" \"fetch this post,\" \"what does this LinkedIn say,\" \"read this thread,\" \"pull this post.\" For what's said inside a video, use watch-video. Used by deep-research (citing specific posts), jab-hook (inspiration account analysis), business-brainstorm (competitor / operator commentary)."
metadata:
  version: 0.1.4
---

# /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)
- **X / LinkedIn / Instagram / TikTok / Threads** need paid or scraping fallback for full data

## Step 3 — Execute strategy

For each strategy in the chain:
1. Try it
2. If success: parse → normalize → return
3. If failure (404, 402, auth wall, empty response): note the failure and try the next strategy

After exhausting the chain, return a clear error: which strategies were tried, why each failed, and what's needed to unlock (e.g., "Add `$SCRAPECREATORS_API_KEY` for X — see `references/auth-keys.md`").

## Step 4 — Normalize output

Return this shape regardless of platform (see `references/output-schema.md` for the full spec + platform-specific examples):

```json
{
  "platform": "x",
  "url": "https://x.com/example/status/1234567890",
  "fetched_at": "2026-06-17T14:35:00Z",
  "raw_source": "scrapecreators",
  "author": {
    "handle": "@example",
    "name": "the user Ganim",
    "verified": true
  },
  "posted_at": "2026-06-17T16:53:00Z",
  "text": "The 80/20 of a useful AI second brain: ...",
  "media": [],
  "engagement": {
    "likes": 51,
    "reposts": 13,
    "replies": 9,
    "bookmarks": 7,
    "views": 32700
  },
  "is_thread": true,
  "thread": [],
  "replies": []
}
```

Fields with no equivalent on a platform (e.g., `bookmarks` on Mastodon) get `null`, not `0`. Missing data is different from zero data.

## Step 5 — Optional enrichments

Based on flags / asks:

| Flag | Behavior |
|---|---|
| `--with-replies` | Fetch top-level replies (1 hop). Costs extra API quota. |
| `--thread` | If the post is part of a thread by the same author, fetch the whole thread. |
| `--raw` | Include the raw API/scrape response in the output (for debugging) |
| `--media` | Download media files (images/videos) to `~/Documents/social-fetches/<platform>-<id>/` |

Default: just the post itself, no replies, no media download (just URLs).

## Step 6 — Cache (optional)

If `~/Documents/social-fetches/_cache/` exists, cache successful fetches there by `{platform}-{id}.json` for 24h. Saves API quota when the same post is referenced repeatedly across skills.

Skip cache if `--no-cache` flag is set or for `--with-replies` / `--thread` (likely-stale).

## Composes with

- `deep-research` — cite specific posts in research briefs. When research surfaces a relevant tweet/post URL, fetch and include in the brief.
- `jab-hook` — pull recent posts from inspiration accounts for deeper format analysis (currently uses agent-browser inline; should call this skill instead).
- `business-brainstorm` — pull competitor / operator commentary as evidence during scoring.
- `second-brain` — capture a post into `raw/` with the `tweet-` / `bookmark-` prefix; the structured output makes for cleaner raw files than a screenshot or copy-paste.
- `watch-video` — for YouTube URLs (or any video — Loom, Vimeo, Riverside, MP4), route there instead.

## Known limits

- **X**: free strategies return tweet preview only (text, author, basic engagement). Full thread + replies need `$SCRAPECREATORS_API_KEY` or `$APIFY_API_TOKEN`.
- **LinkedIn**: agent-browser works for profile recent-activity (after dismissing the modal). Specific post URLs (`linkedin.com/posts/...`) often need paid fallback.
- **Instagram / TikTok / Threads**: heavy anti-bot. Paid fallback strongly recommended.
- **Bluesky / Mastodon / HN / Reddit**: free + reliable.
- **Private / deleted posts**: nothing helps. Try Wayback Machine for deleted content.

If a platform consistently fails on free strategies and the user uses it often, prompt to set up the paid key (see `references/auth-keys.md`).

## Notes on quality

- **Strategy chain, not single-source.** Every platform has a fallback ladder (native oEmbed → agent-browser → SCS API → Apify). If one step fails, degrade gracefully to the next. Never fail hard on the first attempt.
- **Structured output over screenshots.** Downstream skills (jab-hook, deep-research, second-brain) need JSON with author + text + engagement fields, not an image. Even when the underlying strategy is a screenshot, extract text before returning.
- **Cache aggressively, invalidate honestly.** 24h TTL on `~/Documents/social-fetches/_cache/` prevents API burn when the same post is referenced across multiple skills in a session. `--with-replies` / `--thread` skip cache because replies age fast.
- **Respect paid-key economics.** ScrapeCreators / Apify calls cost real money. Prompt before hitting paid strategies if the user hasn't confirmed they want depth. Free strategies first, always.
- **Media download is opt-in.** Default is post text only; `--media` downloads images/videos. Silent media downloads eat disk quickly.
- **Private / deleted content is a hard stop.** No strategy chain rescues private accounts or deleted posts. Suggest Wayback Machine for deleted content and stop.
- **Rate-limits are per-platform.** X free strategies hit rate limits fast; LinkedIn agent-browser burns session fingerprints. Space out calls in loops or the workflow degrades to worse-than-manual.

© coreyhaines31 · MIT · coreyhaines31/makerskills

Похожие скиллы

Все скиллы по теме «Браузер и парсинг» →
Social Profile Lookup — Twitter, GitHub, LinkedIn axel-belfort Social Profile Lookup — Twitter, GitHub, LinkedIn — MCP-сервер для Claude Code собирает данные профиля по никнейму или URL в Twitter, GitHub, LinkedIn и YouTube. CX Codex +1 6 933установок social coreyhaines31 Скилл social для Claude Code, Codex и Cursor, который пишет органические посты, треды и сценарии для соцсетей. Генерирует публикации без типичных штампов нейросетей вроде broetry и дешёвого кликбейта. CX Codex +1 100 700установок social-media-generator ailabs-393 Скилл social-media-generator для Claude Code пишет посты для Twitter, Instagram, LinkedIn и Facebook и сохраняет их в папки с понятными именами файлов. Для анонса на нескольких площадках. CX Codex +1 1 500установок social-content Alireza Rezvani Скилл social-content помогает готовить публикации для соцсетей, составлять контент-план и перерабатывать материалы под разные форматы. CX Codex +1 668установок social-media-copywriter davila7 Субагент social-media-copywriter готовит рекламные посты для Twitter, LinkedIn и Instagram по материалам подкаста. Помогает быстро собрать публикации с учётом лимитов символов и формата каждой площадки. CX Codex 1 113установок social-media-post qf-studio Скилл social-media-post для Claude Code готовит варианты постов для Threads, X и LinkedIn с учётом формата площадки. Создаёт тексты для анонсов, обновлений продукта и публикаций по заданной теме. CX Codex +1 1установок

Из того же набора20

Весь набор →
decide Скилл decide помогает принять решение через отбор 6–8 ключевых вопросов и сохраняет логику выбора в архив с датой проверки. CX Codex +1 562установок read-book Скилл read-book разбивает PDF, EPUB, MOBI или текстовые книги на фрагменты, извлекает тезисы по главам и готовит заметки для личной базы знаний. CX Codex +1 489установок business-brainstorm Скилл business-brainstorm оценивает новую бизнес-идею по структурированным критериям и выдаёт вердикт: строить, отложить или отказаться. Проверка охватывает рынок, аудиторию, монетизацию и доступность домена. CX Codex +1 473установок second-brain Скилл second-brain превращает папку с заметками в вики: складывает источники в raw/, компилирует их в связанные страницы и отвечает на вопросы по ним. CX Codex +1 412установок company-brain Скилл company-brain для Claude Code, Codex, Cursor и других агентов превращает заметки команды в структурированную базу — люди, компании, встречи, SOP, решения. CX Codex +1 407установок deep-research Скилл deep-research собирает ответ на исследовательский вопрос из нескольких источников за несколько проходов и оформляет его в структурированный отчёт с источниками. Запускается на фразы «research X», «investigate X», «due diligence on X». CX Codex +1 401установок company-cfo Скилл company-cfo ведёт месячный финансовый цикл компании: собирает данные из банка, платёжного сервиса, payroll и расходов, сводит их и пишет отчёт для руководства. CX Codex +1 400установок personal-cfo Скилл personal-cfo моделирует личные финансовые сценарии прямо в агенте: покупка дома с доходом от сдачи ADU и спален, ремонт, месячный кэш-флоу, крупные покупки. На выходе — сравнительные таблицы в markdown. CX Codex +1 399установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой