FxEmbed Skill：把 Twitter/Bluesky 嵌入变成富媒体卡片的开源网关

Skill超级捕获手 技术创作者 2026-09-25 1125 阅读

FxEmbed 是一个开源的社交媒体内容嵌入解析网关，通过在 URL 前缀替换（Fxtwitter.com / Fixupx / Fxbsky）让原本无法在 Discord、Telegram 等平台正确渲染的 X/Twitter 和 Bluesky 帖子，变成包含视频、投票、多图、翻译等完整媒体内容的富预览卡片。项目的核心价值在于解决了社交平台有意限制第三方嵌入的痛点——Twitter/X 官方 API 收费高、嵌入功能残缺，而 FxEmbed 用 Cloudflare Workers 边缘部署的方式提供了一个零成本、自托管、可私有化部署的解决方案。项目同时支持 Instagram、Threads、TikTok 等平台的内容解析，并配有完整的 AGENTS.md，使 AI 编程 Agent 能够以标准化 Skill 格式调用其 API 能力。截至 2026-09-25，项目在 GitHub 拥有约 5,354 颗星、Fork 248 个，持续活跃在每日 Trending 榜单，是 2026 年增长最快的社交媒体工具类开源项目之一。

FxEmbed 的核心能力是”社交媒体 URL → 富媒体嵌入卡片”的转换。通过将目标 URL 中的域名替换为 FxEmbed 提供的域名入口（如 fxtwitter.com 替换 twitter.com），请求经过 Cloudflare Workers 边缘节点，代理后端解析原帖内容，组装成符合 Discord/Telegram 嵌入式规范的 Open Graph 卡片返回。项目采用 monorepo 架构，核心包位于 packages/atmosphere/，负责多平台内容的统一抽象与 API 路由，支持 Transport 层灵活切换（public / anonymous-proxy / proxy-relay / authenticated），以及 Instagram/Threads/TikTok 的专项解析逻辑。

截至 2026-09-25，FxEmbed 在 GitHub 拥有约 5,354 颗星、248 个 Fork，主要语言为 TypeScript（98.2%），采用 MIT 许可证。根据 awesome-repositories 数据，项目已登上 GitHub Trending 日榜，近期日均增长 100-200 颗星。在 awesome-repositories 的”链接与 URL 管理”分类中排名靠前，被多家技术媒体列为 2026 年必备工具之一。项目在开放源代码社区有较高认可度，FxEmbed 组织下另有 FixTweet（格式化推文）、Mosaic（多图拼接）等关联项目协同构成完整的社交媒体工具矩阵。

FxEmbed 组织（@FxEmbed）是该项目的维护主体，核心贡献者包括 Antonio32A（编写 Mosaic 多图拼接工具）、Syfaro、Deer Spangle 和 dangered wolf 等。项目的原始创意源自 FixTweet 生态，以 MIT 许可证开源，允许自由使用、修改和商业化。

FxEmbed 不是一个简单的 URL 跳转服务，而是一套完整的多平台内容解析与嵌入生成系统。它由以下子项目协同构成：FxTwitter / FixupX 负责 Twitter/X 内容解析，FxBluesky 负责 Bluesky 帖子嵌入，packages/atmosphere 是统一的内容解析核心库，polyglot 提供翻译服务。项目架构的核心设计是”Transport 抽象层”——同一套业务逻辑通过不同的 Transport 配置，既可以对接公共 API，也可以通过 Cookie 认证代理、第三方中继或自建代理池访问受保护内容。例如 TikTok 的公开接口几乎全部被签名保护，项目退而求其次通过网页端解析公开内容，并在 AGENTS.md 中详细记录了各平台的技术限制与应对策略。

  • 支持 Twitter/X、Bluesky、Instagram、Threads、TikTok 等 5+ 平台的内容解析
  • Cloudflare Workers 边缘部署：全球低延迟响应（亚秒级），免费计划即可支持数万次/日请求
  • 多图拼接（Mosaic）：多图推文自动拼接成一张宽幅预览图
  • 内置翻译（polyglot）：支持帖子内容多语言翻译后嵌入
  • AGENTS.md 集成：AI Agent 可通过标准 Skill 格式调用 FxEmbed API
  • Transport 灵活切换：public / proxy-relay / authenticated 多模式支持各类隐私需求
  • MIT 许可证：完全开源，可私有化部署，数据不留存
  • 无需 API Key：直接使用托管服务零成本接入

部署 FxEmbed 有两种方式：直接使用托管服务（免费）和自托管 Cloudflare Workers（约 $0/月）。托管服务使用非常简单，只需将目标 URL 中的 twitter.com 替换为 fxtwitter.com 即可。

# 示例：在 Discord/Telegram 中粘贴替换后的 URL
# 原链接：https://twitter.com/user/status/123456789
# 替换后：https://fxtwitter.com/user/status/123456789

# AI Agent 安装（AGENTS.md 格式）
# 将 AGENTS.md 复制到 ~/.claude/skills/fxembed/SKILL.md
# 或使用 npx skills add https://github.com/FxEmbed/FxEmbed

# 自托管部署（Docker Compose）
git clone https://github.com/FxEmbed/FxEmbed.git
cd FxEmbed
cp .env.example .env
cp wrangler.example.toml wrangler.toml
docker compose up -d --build

# 本地测试
curl -H "Host: fxtwitter.com" -H "User-Agent: Discordbot/2.0" 
     "http://localhost:8787/user/status/123"

FxEmbed 适合以下使用场景：社区运营者（Discord/Telegram 群管理员想让推文嵌入显示完整媒体内容）、内容创作者（在小红书/微博/Discord 分享推文时保留原帖视频和图片）、AI Agent 开发者（通过 AGENTS.md 将 FxEmbed 能力集成到自己的编程 Agent 工作流中）、隐私敏感用户（自托管部署，完全控制数据流向）。目标用户群体包括社交媒体运营者、开发者工具集成者、以及需要构建社交内容预览功能的产品/平台团队。

输入 1：用户分享 https://twitter.com/elonmusk/status/123456789 到 Discord 频道
输出：Discord 自动渲染出包含完整推文文本、附带视频（如有）、投票选项（如有）、翻译按钮（如有）的富媒体卡片，而不是一条无法预览的纯文本链接。

输入 2：AI 编程 Agent 需要解析某 Twitter 用户的最新 10 条推文内容
输出：Agent 调用 FxEmbed API（通过 AGENTS.md Skill），传入目标 URL，服务端返回包含正文、图片、视频 URL、互动数据（点赞/转发数）的结构化 JSON，Agent 随后提取关键信息写入报告。

GitHub: https://github.com/FxEmbed/FxEmbed

评论区

0 条评论

登录后可评论。

Skill超级捕获手 1125 阅读