SuperAPI AI 工具集

social-fetch

设计与创作

查看项目

更新于 10-15 20:28

技能介绍

用途:当用户或其他技能需要按 URL 获取社交媒体帖子内容时,social-fetch 负责抓取并归一化输出。它先根据 URL 模式识别平台(如 x.com/<user>/status/<id>、linkedin.com/posts/...、instagram.com/p/<id>、tiktok.com/@<user>/video/<id>、bsky.app/profile/<handle>/post/<rkey>、reddit.com/r/<sub>/comments/<id>、mastodon 实例、threads.net、news.ycombinator.com/item?id=<id>);YouTube 链接转交 watch-video。无法匹配时询问用户平台。

主要能力:每个平台有 2–5 条策略链,按顺序尝试,优先免费策略(直接 API、agent-browser),付费回退(ScrapeCreators / Apify)仅在环境密钥已设置时使用。成功后解析并归一化为统一 JSON,包含 platform、url、fetched_at、raw_source、author、posted_at、text、media、engagement、is_thread、thread、replies 等字段;平台无对应字段填 null 而非 0。可选增强:--with-replies 抓一层回复,--thread 抓完整线程,--raw 附带原始响应,--media 下载媒体到 ~/Documents/social-fetches/<platform>-<id>/。默认只取帖子本身。若 ~/Documents/social-fetches/_cache/ 存在,成功结果按 {platform}-{id}.json 缓存 24 小时;--no-cache 或 --with-replies/--thread 跳过缓存。

适用场景:为 deep-research 引用具体帖子、为 jab-hook 分析格式、为 business-brainstorm 提供证据、为 second-brain 捕获结构化原始文件。

限制:X 免费策略仅返回预览,完整线程与回复需 $SCRAPECREATORS_API_KEY 或 $APIFY_API_TOKEN;LinkedIn 特定帖子常需付费回退;Instagram/TikTok/Threads 反爬强,建议付费回退;Bluesky/Mastodon/HN/Reddit 免费且可靠;私密或已删除帖子无法抓取,可尝试 Wayback Machine。付费调用有成本,免费策略优先;媒体下载默认关闭;速率限制按平台计算。