SuperAPI AI 工具集

twitter-reader

写作与研究

查看项目

更新于 10-16 05:05

技能介绍

用途:抓取 Twitter/X 帖子与 X Articles 长文内容,输出正文、作者、互动指标与内嵌媒体,并把图片下载到本地、生成完整 Markdown。

主要能力:完整文章模式(fetch_article.py)可获取结构化元数据(作者、日期、点赞、转推、书签),自动下载全部内嵌图片,生成带本地图片引用的 Markdown 与 YAML frontmatter,适合 PKM 系统;简单模式基于 Jina API,仅取文本,支持单条与批量。

使用方式:纯文本单条帖子优先用 fxtwitter 镜像 API,无需登录与密钥,正文在 tweet.text(无 full_text 键):curl -sS --max-time 20 "https://api.fxtwitter.com/<user>/status/<id>"。带图 X Articles 用:uv run --with pyyaml python scripts/fetch_article.py <article_url> [output_dir]。简单模式需先 export JINA_API_KEY="your_api_key_here",单条用 python scripts/fetch_tweet.py <tweet_url> [output_file],批量用 scripts/fetch_tweets.sh url1 url2 url3。支持 x.com/USER/status/ID、x.com/USER/article/ID 与 twitter.com 旧链接。输出目录含 YYYY-MM-DD-article-title.md 与 attachments/YYYY-MM-DD-author-title/ 图片。

限制:Jina 匿名访问 x.com 会被间歇性封禁,拒绝时 curl 仍返回 0 且响应体是 JSON 错误信封(403 AbuseAlleviationError 或 402 InsufficientBalanceError),脚本以 Markdown Content: 标记判断是否成功;fetch_tweets.sh 与 fetch_tweet.py 依赖 JINA_API_KEY 且无备用来源,密钥失效即不可用,仓库不附带密钥。fetch_article.py 在 Jina 被拒时保留 twitter-cli 文本并报告 Images: 0。元数据经 twitter-cli 读取,其书签等时间线命令上限为 500 条(_ABSOLUTE_MAX_COUNT = 500),maxCount 须放在配置的 rateLimit: 段下,否则回退 200;更深分页需直接调用 GraphQL。fxtwitter 不携带文章正文。