Fxtwitter Extract

使用 FxTwitter API 提取 X (Twitter) 文章内容。支持提取推文、线程、用户资料，包括文本、图片、视频、投票等。无需 API Key。

Security Scan

这个技能按其描述工作：运行一个本地 Python 脚本，通过 HTTPS 调用 api.fxtwitter.com 提取 X（Twitter）内容，不需要额外凭据或安装步骤，整体一致且没有明显的越权行为。

Purpose & Capability

技能名/描述与实现一致：描述为“使用 FxTwitter API 提取 X 内容，无需 API Key”，脚本只向 https://api.fxtwitter.com 发起请求并处理推文/线程/用户资料。没有请求与功能不符的权限或凭据。

Instruction Scope

SKILL.md 的运行指令仅示例性地调用包含在技能里的 Python 脚本（路径为工作区内的技能路径）并说明需要 User-Agent。脚本只读取命令行参数并发起网络请求，未尝试访问其他系统路径、环境变量或未声明的外部端点。

Install Mechanism

无安装规范（instruction-only + 附带脚本），没有下载或提取外部归档。风险较低：代码随技能一起提供并由本地 Python 运行。

Credentials

技能不要求环境变量、凭据或配置路径。所需权限与其功能相称：仅需网络访问到 api.fxtwitter.com。

Persistence & Privilege

技能没有设置 always:true 或要求修改系统/其他技能配置。它是按需调用的本地脚本，未请求长期常驻或提高特权。

Assessment

该技能会在本地运行一个 Python 脚本，并向第三方服务 https://api.fxtwitter.com 发起 HTTPS 请求以获取推文/线程/用户资料——这是其主要外部行为。考虑以下事项： - 如果你对外部服务的隐私/日志策略敏感，请先确认 FxTwitter 的隐私声明（SKILL.md 声称“不记录日志”，但无法由技能本身验证）。 - 技能无需密钥，但会把请求（包括被请求的推文 ID 或用户名）发送到第三方服务器；避免用其查询敏感或私人内容。 - 如果你有企业或网络出站限制，允许向 api.fxtwitter.com 的出站流量是必要的。若需更高信任，可审阅或托管等效开源实现（技能引用了 FxEmbed/FxTwitter 项目）。 总体上该技能在功能、要求和实现上是一致的（内部连贯），但仍需谨慎对待与第三方服务的网络交互。

FxTwitter Extract 技能

使用 FxTwitter API 提取 X (Twitter) 内容。

特点

• ✅ 无需 API Key - FxTwitter 是免费的公共服务
• ✅ 支持多种内容 - 文本、图片、视频、投票、引用
• ✅ 支持线程提取 - 可提取整个推文线程
• ✅ 支持用户资料 - 获取用户统计信息
• ✅ 隐私友好 - FxTwitter 不记录日志

使用方法

基本用法

# 提取单个推文
python ~/.openclaw/workspace/skills/fxtwitter-extract/scripts/fxtwitter_extract.py status <推文 ID>

# 提取推文（包含线程）
python ~/.openclaw/workspace/skills/fxtwitter-extract/scripts/fxtwitter_extract.py status <推文 ID> --thread

# 提取用户资料
python ~/.openclaw/workspace/skills/fxtwitter-extract/scripts/fxtwitter_extract.py profile <用户名>

# 从 URL 提取
python ~/.openclaw/workspace/skills/fxtwitter-extract/scripts/fxtwitter_extract.py url <X 文章 URL>

# 输出原始 JSON
python ~/.openclaw/workspace/skills/fxtwitter-extract/scripts/fxtwitter_extract.py status <推文 ID> --json

示例

# 提取 Elon Musk 的推文
python ~/.openclaw/workspace/skills/fxtwitter-extract/scripts/fxtwitter_extract.py status 1234567890

# 提取用户资料
python ~/.openclaw/workspace/skills/fxtwitter-extract/scripts/fxtwitter_extract.py profile elonmusk

# 从 URL 提取（支持 x.com 和 twitter.com）
python ~/.openclaw/workspace/skills/fxtwitter-extract/scripts/fxtwitter_extract.py url https://x.com/elonmusk/status/1234567890

API 端点

FxTwitter 提供以下 API 端点：

端点	说明	示例
/2/status/:id	获取单个推文	/2/status/1234567890
/2/thread/:id	获取推文线程	/2/thread/1234567890
/2/profile/:handle	获取用户资料	/2/profile/elonmusk
/2/owoembed	oEmbed 格式	/2/owoembed?url=...

基础 URL: https://api.fxtwitter.com

必需 Header:

• User-Agent: 必须标识你的应用（如 MyBot/1.0）

返回格式

推文响应

{
  "code": 200,
  "message": "OK",
  "status": {
    "id": "1234567890",
    "text": "推文内容",
    "created_at": "2024-01-01T00:00:00Z",
    "replies": 10,
    "retweets": 100,
    "likes": 1000,
    "views": 50000,
    "media": {
      "photos": [{"url": "..."}],
      "videos": [{"url": "..."}]
    },
    "poll": {
      "options": [{"label": "选项 1", "votes": 100}]
    }
  },
  "author": {
    "name": "用户名",
    "screen_name": "handle",
    "avatar_url": "...",
    "followers": 1000000
  }
}

用户资料响应

{
  "code": 200,
  "message": "OK",
  "user": {
    "screen_name": "elonmusk",
    "name": "Elon Musk",
    "description": "...",
    "followers": 236100712,
    "following": 1292,
    "tweets": 98573,
    "likes": 214954,
    "media_count": 4380,
    "verified": true,
    "location": "...",
    "joined": "Tue Jun 02 20:12:29 +0000 2009"
  }
}

在 Python 中直接使用

import urllib.request
import json

def fetch_tweet(status_id: str) -> dict:
    url = f"https://api.fxtwitter.com/2/status/{status_id}"
    req = urllib.request.Request(
        url,
        headers={"User-Agent": "MyBot/1.0"}
    )
    with urllib.request.urlopen(req) as response:
        return json.loads(response.read().decode('utf-8'))

# 使用示例
data = fetch_tweet("1234567890")
print(data["status"]["text"])

限制

• 速率限制: FxTwitter 有速率限制，但免费使用
• User-Agent: 必须提供 User-Agent header
• API 稳定性: API 可能随 Twitter/X 变化而更新

相关资源

• 官方文档: https://docs.fxtwitter.com/
• GitHub 项目: https://github.com/FxEmbed/FxEmbed
• 状态页面: https://status.fxtwitter.com
• Crowdin 翻译: https://crowdin.com/project/fxtwitter

支持的域名

FxTwitter 在以下域名运行（功能相同）：

• fxtwitter.com / api.fxtwitter.com
• twittpr.com (Discord sed 替换友好)
• fixupx.com (用于 x.com 链接)
• fxbsky.app (Bluesky 支持)

故障排除

404 错误

• 推文可能被删除或设为私密
• 推文 ID 不正确

401 错误

• 缺少 User-Agent header
• 添加 User-Agent: MyBot/1.0 到请求头

网络错误

• 检查网络连接
• FxTwitter 服务可能暂时不可用

与 DeepReader 的区别

特性	FxTwitter Extract	DeepReader
API	FxTwitter API	r.jina.ai
需要登录	❌ 否	❌ 否
支持视频	✅ 是	✅ 是
支持投票	✅ 是	✅ 是
支持线程	✅ 是	✅ 是
结构化数据	✅ JSON	Markdown
用户资料	✅ 支持	❌ 不支持

作者

基于 FxEmbed/FxTwitter 项目创建。