read-x

X を読む

X／Twitter の投稿や記事の全内容を取得します。API キーも認証もブラウザーも必要ありません。

仕組み

FxTwitter API を使用します。認証不要の公開 API で、埋め込み記事、メディア、エンゲージメント統計を含む完全なツイート JSON を返します。

エンドポイント

https://api.fxtwitter.com/{username}/status/{tweet_id}

使用する場面

• ユーザーが x.com または twitter.com の URL を共有したとき
• ユーザーが X の投稿や記事の閲覧、要約を求めたとき
• ユーザーがスレッドまたは長文の X 記事を共有したとき

使用しない場面

• ユーザーが X への投稿や返信だけを希望しているとき（この API は読み取り専用です）
• URL が投稿ではないとき（例：x.com/username のプロフィールページ）

取得方法

fxtwitter の URL に対して web_fetch を使用します。

web_fetch: https://api.fxtwitter.com/{username}/status/{tweet_id}

URL からの抽出

入力：https://x.com/elonmusk/status/1234567890

• username：elonmusk
• tweet_id：1234567890
• API URL：https://api.fxtwitter.com/elonmusk/status/1234567890

レスポンスの構造

API は次の内容を含む JSON を返します。

• tweet.text — ツイートのテキスト
• tweet.author — 投稿者の情報（名前、ハンドル、フォロワー数、自己紹介）
• tweet.likes、tweet.retweets、tweet.views — エンゲージメント
• tweet.article — 長文記事の全内容（存在する場合）
  • tweet.article.title — 記事のタイトル
  • tweet.article.content.blocks[] — 記事本文（Draft.js のようなブロック形式）
    • 各ブロックには、text、type（unstyled、header-two、blockquote、atomic）、inlineStyleRanges（Bold、Italic）が含まれます
• tweet.media — 添付された画像／動画
• tweet.replying_to — 返信の場合、返信先の投稿者

記事のレンダリング

tweet.article が存在する場合、整形された Markdown としてレンダリングします。

• header-two → ## 見出し
• blockquote → > 引用
• インラインスタイル Bold → **太字**
• インラインスタイル Italic → *斜体*
• DIVIDER エンティティを持つ atomic → ---
• entityMap 内のリンク → [テキスト](url)

制限事項

• 読み取り専用です（投稿、いいね、返信はできません）
• ツイートを利用できない場合があります（削除済み、保護されたアカウントなど）
• レート制限はありますが、通常の利用には十分な範囲です
• スレッドの場合、各ツイートに個別のリクエストが必要です（replying_to の連鎖をたどります）