著者:Sorsa Editorial

2026年7月11日更新:公式 X のホスト型 MCP サーバー(2026年6月30日にローンチ)を追加し、X API の従量課金の読み取りレートを2026年4月20日の変更に対して刷新しました。

要点: AI エージェントとコーディングツールは、公開の X/Twitter データに3つの方法で到達します。チャットクライアントに読み取りツールを公開する MCP サーバー、コーディングツールにエンドポイントを教えるエージェントスキル、そして生成されたコードから呼ばれるプレーンな REST API です。読み取り専用のアクセスは、自律エージェントをユーザーアカウントから遠ざけ、フラットなリクエスト単位の課金がリソース単位のコストを避けます。

AI エージェント向けの Twitter API についてのほとんどのガイドは、エージェントが投稿するものと想定しています。フィードを見て、返信を下書きし、公開する。それは1つの仕事で、公式 X API がそれを担います。より大きく、より速く成長している仕事は読み取りです。会話を検索し、プロフィールを取得し、誰が誰をフォローしているかを確認し、あるいはモデルが要約するためにツイートを収集するエージェントです。読み取りこそ、マネージドで読み取り専用のデータ層が、自律エージェントを書き込み可能なアカウントにつなぐ方式に勝るところです。

それが、読み取りの多いアクセス向けに作られた Twitter/X の代替 API である Sorsa API が、AI の作り手のために埋めるギャップです。プロフィール、ツイート、検索、フォロワー、リスト、コミュニティ、確認系の機能にわたる40個の読み取りエンドポイントを、ApiKey ヘッダーの中の単一の API キー(OAuth なし、アプリ審査なし)、1,000ツイートあたり$0.02からのフラットなリクエスト単位の課金、そしてすべてのプランで一律の毎秒20リクエストで公開します。新規アカウントは、40個のエンドポイントすべてで、1回限り・クレジットカード不要の100回分の無料リクエストを得て、何かを支払う前にエージェントを実データにつなぐのに十分です。

本ガイドは、3つの接続経路、読み取り専用が自律エージェントの安全性の計算をどう変えるか、それらの部品が人々が実際に使うツール(Claude Desktop、Cursor、Claude Code、Codex、Windsurf、そしてバイブコーディングの作り手)にどう対応するか、そしてデータがエージェントの規模でいくらかかるかを扱います。

このページの内容

なぜ AI エージェントとコーディングツールは Twitter/X API を必要とするか {#why}

AI エージェントとコーディングツールが Twitter/X API を必要とするのは、言語モデルが単独ではプラットフォームへのライブアクセスを持たないからです。その訓練データは凍結されており、X は認証されていないスクレイピングをブロックします。API は「これについて人々が何を言っているか」を、モデルが行える構造化された呼び出しに変え、きれいな JSON を受け取り、それについて推論できるようにします。モデルが答えをでっち上げることなく。

需要はニッチではありません。Stack Overflow の49,000人を超える開発者を対象とした2025年開発者調査では、回答者の84%が開発プロセスで AI ツールを使っているか使う予定で、2024年の76%から増加し、プロの開発者の51%が AI ツールを毎日使っています。それらのツールはますます、実データのために自身の文脈の外に手を伸ばしており、公開のソーシャルな会話は最も要求されるソースの1つです。

実際には、2つの異なる読み手が現れます。1つ目は実行時のエージェントです。監視エージェント、リサーチアシスタント、公開アカウントを確認する必要があるサポートボットです。2つ目はビルド時のコーディングツール自体で、そこでは Cursor や Claude Code が統合コードを書き、呼び出しを正しくするために、エンドポイント、認証、レスポンスの形を知る必要があります。以下の3つの経路は、両方に役立ちます。

Twitter/X データを AI ツールに接続する3つの方法 {#three-ways}

AI ツールに Twitter/X データを与える方法は3つあります。チャットクライアント向けの MCP サーバー、コーディングツール向けのエージェントスキル、そして生成されたコードから直接呼ばれる REST API です。これらは競合ではありません。異なるツールに合い、同じ API キーが3つすべてで機能します。

選択肢1:チャットクライアント向けの MCP サーバー

MCP サーバーは、チャット式のクライアントに最も速い経路です。Model Context Protocol は、2024年後半に Anthropic が導入したオープンな標準で、AI アプリケーションが1つの統一された方法で外部ツールを呼べるようにします。MCP サーバーは一連のツールを公開し、クライアントがプロトコルを話し、モデルが各リクエストに正しいツールを選びます。Sorsa MCP サーバー は読み取りエンドポイントをラップするため、任意の MCP 互換クライアントが、ツイートの検索やプロフィール、フォロワー、返信、メンション、トレンドの読み取りのためのネイティブツールを得ます。

npx を通じてローカルで動くため、クローンやビルドするものは何もありません。キーを指定してクライアントを再起動します。

json
{
  "mcpServers": {
    "sorsa": {
      "command": "npx",
      "args": ["-y", "sorsa-mcp"],
      "env": {
        "SORSA_API_KEY": "YOUR_KEY"
      }
    }
  }
}

その同じブロックが、Claude Desktop、Cursor、GitHub Copilot 付きの VS Code、Windsurf、そして他のあらゆる MCP クライアントで機能します。サーバーはエンドポイントごとに1つのツール(合計40個)を公開し、すべて読み取り専用です。MCP サーバーのソースは GitHub に MIT ライセンスで公開されています。クライアントごとの完全な解説については、専用の Twitter MCP サーバーガイドをご覧ください。このセクションは短縮版です。

選択肢2:コーディングツール向けのエージェントスキル

ワークフローを構築・実行するコーディングエージェントには、チャットツールよりエージェントスキルのほうがよく合います。オープンな SKILL.md 形式のスキルは、エージェントが能力を学ぶために読む指示のフォルダです。どう認証するか、どのエンドポイントがどの目標に一致するか、そしてどう順に取得しバッチ処理するか、です。モデルがチャット時に呼ぶ MCP サーバーと異なり、スキルはコーディングエージェントに、正しい API コードを自分で書き、それから実際のプロジェクトの中でそれを実行することを教えます。

Sorsa API 向けのオープンな SKILL.md スキル は、その形式を読む任意のエージェントで機能します。Claude Code、Cursor、Codex CLI などです。手動のインストールは、エージェントのスキルディレクトリへのコピーです。

bash
git clone https://github.com/Sorsa-io/sorsa-x-api-skill ~/.claude/skills/sorsa-x-api
export SORSA_API_KEY=your_key

その後は、「@elonmusk の直近100フォロワーを取得して」や「今週 Solana に言及する人気の投稿を X で検索して」のようなプロンプトで十分です。スキルはエージェントに、ApiKey ヘッダーで認証し、エンドポイントを選び(フォロワーには /followers、検索には /search-tweets)、結果を順に取得するよう伝えます。実行可能な Python と curl の例に加えて、リトライとページネーションを扱う小さなクライアントを同梱するため、エージェントはリクエストの配管を書き直す代わりに再利用します。

スキルの経路は、ほとんどの競合ページが飛ばすもので、エージェント型のワークフローの読み取り側に自然に合います。エージェントが X データが必要なときを決め、それを自分で取得するのです。

選択肢3:バイブコーディング向けの REST API と AI が読めるドキュメント

アプリを自分で構築し、AI に統合を書かせるなら、REST API を直接呼びます。バイブコーディング、すなわちソフトウェアを平易な言葉で説明して構築することは、Collins Dictionary の2025年の今年の言葉で、Cursor、Bolt、Lovable、Replit のようなツールは今やプロンプトから動くアプリを出荷します。そのフローにおけるどの外部 API のボトルネックも、モデルが正しい呼び出しを書けるほど API をよく知っているかどうかです。

それが、AI が読めるドキュメントが解決するものです。人間向けのドキュメントに加えて、Sorsa は AI が読めるバージョンのドキュメント を公開しています。エージェントが文脈に取り込み、HTML やレンダリングと格闘せずにパースできる、プレーンテキストのリファレンスです。それを Cursor や Claude Code に貼り付けるかリンクすると、モデルにエンドポイントのリスト、パラメータ、レスポンスフィールドが与えられるため、生成されたリクエストが最初の試みで実際の API に一致します。

API 自体は単純なままで、それが生成されたコードを短く保ちます。プロフィールの照会は、認証された1つの GET です。

python
import os, requests

r = requests.get(
    "https://api.sorsa.io/v3/info",
    headers={"ApiKey": os.environ["SORSA_API_KEY"]},
    params={"username": "elonmusk"},
)
r.raise_for_status()
print(r.json()["followers_count"])

検索は、ツイート検索エンドポイント を通じて Twitter の高度な検索コマンドを受け付ける JSON 本文を持つ POST です。

bash
curl -X POST "https://api.sorsa.io/v3/search-tweets" \
  -H "ApiKey: $SORSA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "from:elonmusk min_faves:1000", "order": "popular"}'

そこから、フォロワーエンドポイント は呼び出しあたり最大200件のプロフィールを返し、バッチエンドポイントはリクエストあたり最大100件のツイートまたはプロフィールを受け取り、同じキーがすべてをカバーします。より完全な入門については、AI で構築するガイドAPI クイックスタート がセットアップを端から端まで案内します。

読み取り専用か書き込みアクセスか:自律エージェントが必要とするもの {#read-only}

ほとんどの AI のユースケースでは、エージェントはアカウントに書き込むのではなく公開の X データを読む必要があり、読み取り専用のアクセスは本当のリスクの一群を取り除きます。読むことしかできないエージェントは、スクレイピングされた返信の中のプロンプトインジェクションが何をせよと伝えても、投稿・削除・フォロー・DM の送信ができません。それは、エージェントが自分で動くときの意味のあるガードレールです。

信頼のデータがその慎重さを裏付けます。同じ Stack Overflow の2025年調査は、使用と信頼のあいだの鋭いギャップを見出しました。2025年の回答者のわずか29%が AI を信頼すると答え、2024年から11ポイント低下し、開発者の3分の2が挙げた最大の不満は、ほぼ正しいが完全ではない AI の出力でした。エージェントの間違いが読み取りに閉じ込められているとき、ほぼ正しいアクションは、自分で捕捉できる間違ったデータを返すのであって、取り消せないライブのアカウントへの間違った投稿ではありません。

これは正直な譲歩でもあります。エージェントの仕事が公開・いいね・DM の送信なら、公式 X API がユーザーアカウントへの書き込みアクションの適合的な経路で、どの読み取り専用プロバイダーもそれを置き換えません。書き込みアクションを売るサードパーティ API もあります。それは異なるトレードオフです。自動化された書き込みを実際のアカウントに置くからです。Sorsa は設計上読み取り専用で、それが API の使用をユーザーアカウントから完全に遠ざけます。読み取りの多いエージェントには、一律の毎秒20リクエストと フラットなリクエスト単位の料金 が、エージェントが決して呼ばない書き込みエンドポイントより重要です。読み取り専用の 単一キー認証 では、セットアップはユーザーごとの OAuth フローではなく、ヘッダーの中の1つのキーです。

公式 X API とそのホスト型 MCP サーバー {#official-x}

公式 X API は一次のソースで、2026年半ばに独自の MCP 層を加えました。X の開発者向け発表によれば、プラットフォームは2026年6月30日にホスト型 MCP サーバーを出荷し、Grok、Cursor、Claude、または任意の MCP クライアントが、開発者自身の認証情報を通じて X を読み書きできるようにし、開発者向けドキュメント用の別の MCP サーバーも用意しました。それは一次で、OAuth のスコープが付き、すべての呼び出しをアカウントの X API プランを通じてルーティングします。

即座に表面化した落とし穴はコストでした。ホスト型 MCP は料金を変えません。従量課金モデルの上に載っているため、すべてのツール呼び出しが取得したリソース単位で課金され、観察者たちは呼び出しごとの請求を初日最大の驚きとして指摘しました。多くの読み取りを発火するエージェントには、それがフラットプランでは起きない形で積み重なります。

読み取り専用のエージェントには、重要な違いはセットアップとコストです。公式 API は OAuth アプリを必要とし、リソース単位で課金し、一方フラットな読み取り専用プランは1つのキーを必要とし、リクエスト単位で課金します。

公式 X APISorsa API
エージェントのセットアップOAuth 2.0 アプリ、審査、ユーザーごとのトークン更新ApiKey ヘッダーの中の単一の API キー
MCP の選択肢一次のホスト型 MCP(2026年6月30日)、OAuth スコープ、読み書き読み取り専用の MCP サーバー、npx でローカル、OAuth なし
アクセスモデル取得したリソース単位で課金フラット:1呼び出し = 1リクエスト
読み取りコスト投稿あたり$0.005、プロフィールあたり$0.0101,000ツイートあたり$0.02から、1,000プロフィールあたり$0.01から
書き込みアクション投稿、DM、下書き(適合的な経路)なし(設計上読み取り専用)
無料スタート無料プランなし、まずクレジット購入100回分の無料リクエスト、クレジットカード不要

1回の Sorsa リクエストは最大100件のツイートまたは200件のプロフィールを返すため、1,000件あたりの数値はそのバッチ基準を使います。公式 X API の読み取りレートは2026年4月20日の料金によります。

AI エージェントにとって Twitter/X データはいくらかかるか {#cost}

読み取りの多い AI エージェントには、フラットなリクエスト単位のプランが、リソース単位の課金よりはるかに安いです。エージェントは多くの小さな読み取りを行い、同じデータを再利用するからです。公式 X API は取得したリソース単位で課金します。投稿の読み取りあたり$0.005、ユーザーの読み取りあたり$0.010なので、作者プロフィールとともに返される1つのツイートは$0.015、つまり1,000あたり約$15です。検索結果に埋め込まれた作者データは、別々のユーザー読み取りとして課金されます。

フラットプランはそれを逆転させます。Sorsa では、1回の API 呼び出しは、返す項目の数にかかわらず月間クォータから1リクエストで、すべてのツイートレスポンスの中の作者プロフィールは無料です。プランは、10,000リクエストで月額$49(Starter)、100,000で$199(Pro)、500,000で$899(Enterprise)で、それぞれ毎秒20リクエストです。読み取りの多いワークロードでは、量がおよそ月10,000投稿の読み取りを超えると、公式 API より最大50分の1のコストになります。

ツイートあたりの数字は2通りに読めます。/tweet-info-bulk を通じたバルクの ID 照会は、リクエストあたり100件のツイートを返し、Pro で1,000ツイートあたり$0.02からの基準に着地します。/search-tweets を通じた対話的な検索は、リクエストあたり約20件のツイートを返すため、同じプランで1,000あたり$0.10に近くなります。各呼び出しがより少ない項目を返すためです。どちらも、リソース単位のモデルの1,000あたり$15をはるかに下回り、どちらも公式 API の月200万投稿の読み取り上限を負いません。バッチ呼び出しでリクエスト数を削減することは API 利用の最適化 で扱っており、完全な公式料金は 2026年版 X API 料金の詳細 にあります。

どの経路がどのツールに合うか {#which-path}

適切な経路は、どれが最も新しいかではなく、ツールと仕事によります。短い決定リスト:

チャットクライアントとしての Claude Desktop、Cursor、または VS Code: MCP サーバー。1つの設定ブロックで、接着コードなしに読み取りツールを落とし込むためです。

ワークフローを構築する Claude Code、Codex、または Cursor: エージェントスキル。コーディングエージェントに、それが書く相手であるエンドポイント、認証、ページネーションを教えます。

カスタムまたはバイブコーディングのアプリ: 生成されたコードから呼ばれる REST API と、モデルが正しいリクエストを書くための AI が読めるドキュメントです。

投稿・いいね・DM の送信をするエージェント: 公式 X API。ユーザーアカウントへの書き込みアクションの適合的な経路です。

大量で読み取りの多いデータ収集: フラットな Sorsa プラン。1呼び出しが1リクエストで、作者プロフィールはツイートレスポンスの中に無料で付いてきます。

多くのビルドは経路を混ぜます。試作中は探索用に MCP サーバー、それから出荷するアプリでは REST API です。モデルを訓練またはファインチューニングするためにツイートを収集することは、それ自体のワークフローで、機械学習用のTwitterデータセットの構築 で扱っています。

小さなチームがエージェントをライブの X データにつないだ方法 {#case}

約5人の小さなソーシャル分析チームが、公式 X API でメンション追跡エージェントを運用し、より多くのブランドにカバレッジが広がるにつれてリソース単位の請求が上がるのを見ていました。追跡された各メンションは、投稿の読み取りに加えて作者のためのユーザーの読み取りを意味し、OAuth のトークン更新のコードは環境ごとに別々に維持しなければなりませんでした。

読み取りワークロードをフラットプランに移し、エージェントを MCP サーバー経由でつないだことで、同チームの Twitter データの支出は90%超削減され、環境ごとのトークン処理を削除して、環境変数の中の1つのキーに置き換えられました。エージェントが呼べるすべてのツールが読み取り専用だったため、スクレイピングされた返信に埋め込まれたプロンプトインジェクションは、それに何かを投稿させたりフォローさせたりできず、それがチームが慎重さから加えていたレビューのステップを取り除きました。このパターンは、どの常時稼働の読み取りエージェントにも一般化します。継続的なポーリングの仕組みは、REST API によるリアルタイムモニタリング にあります。

よくある質問 {#faq}

AI エージェントは開発者アカウントなしで Twitter/X データにアクセスできる?

はい。Sorsa のようなマネージドな Twitter/X データ API は、ApiKey ヘッダーの中の API キーだけを必要とし、X 開発者アカウントも、OAuth フローも、アプリ審査もありません。エージェントは1つのキーで認証し、プロフィール、ツイート、検索、フォロワーの読み取りエンドポイントを呼びます。新規アカウントは、クレジットカード不要の100回分の無料リクエストを得るため、エージェントはサインアップから数分以内にライブデータを取得できます。

コーディングツールには Sorsa MCP サーバーとエージェントスキルのどちらを使うべき?

Claude Desktop や Cursor のようなチャットクライアントには MCP サーバーを使います。そこではモデルが会話中に読み取りツールを直接呼びます。統合コードを書いて実行する Claude Code や Codex のようなコーディングエージェントには、SKILL.md のエージェントスキルを使います。スキルがそれらにエンドポイント、認証、ページネーションを教えるためです。どちらも同じ Sorsa の API キーを使い、多くの作り手は両方を実行します。

AI エージェントは Sorsa API を通じてツイートを投稿できる?

いいえ。Sorsa は設計上読み取り専用で書き込みエンドポイントを持たないため、エージェントはそれを通じて投稿・返信・いいね・フォロー・DM の送信ができません。それは意図的です。読み取り専用のアクセスが、自律エージェントをユーザーアカウントから遠ざけます。アカウントへの書き込みアクションには、公式 X API が適合的な経路です。Sorsa は読み取り側をカバーし、それがほとんどのエージェントとコーディングツールのワークフローが実際に必要とするものです。

AI エージェントにとって Twitter/X データはいくらかかる?

公式 X API は取得したリソース単位で課金し、投稿あたり$0.005、プロフィールあたり$0.010なので、作者付きのツイートは1,000あたり約$15です。Sorsa はフラットなリクエスト単位の課金を使います。10,000、100,000、または500,000リクエストで月額$49、$199、または$899です。バルクの照会は1,000ツイートあたり$0.02近く、検索は1,000あたり$0.10近くになり、作者プロフィールは無料で含まれます。

公式 X の MCP サーバーとは何で、どう違う?

X は2026年6月30日に一次のホスト型 MCP サーバーをローンチし、AI クライアントが開発者自身の OAuth 認証情報を通じて、自身の X API プランを経由して X を読み書きできるようにしました。それは書き込みアクションをサポートし、読み取り専用のサーバーはしません。トレードオフはコストです。それは呼び出しごとに従量課金モデルで課金し、一方読み取り専用の Sorsa MCP サーバーはローカルで動き、フラットプランに対してリクエスト単位で課金します。

どの AI コーディングツールが Sorsa の Twitter/X スキルで機能する?

スキルはオープンな SKILL.md 形式を使うため、その形式を読む任意のエージェントで機能します。Claude Code、Cursor、Codex CLI を含みます。MCP サーバーは任意の MCP 互換クライアントで機能します。Claude Desktop、Claude Code、Cursor、GitHub Copilot 付きの VS Code、そして Windsurf などです。いずれにせよ、セットアップは同じ標準の設定と1つの Sorsa API キーです。

始め方 {#getting-started}

コードを書く前にデータを試せます。ブラウザの playground で、登録なしで UI からエンドポイントを実行し、それから100回分の無料リクエストを受け取って実際のエージェントをライブデータに向けます。100リクエストは1回限り、クレジットカード不要、有効期限なしで、40個のエンドポイントすべてをカバーし、MCP サーバー、スキル、または直接の呼び出しを端から端までテストするのに十分です。

そこから経路を選びます。チャットクライアントには MCP の設定ブロックを追加し、コーディングエージェントにはスキルをクローンし、あるいは AI が読めるドキュメント をエディタに貼り付けて統合を書かせます。完全なドキュメント一律の毎秒20リクエスト が運用の詳細をカバーし、既存のエージェントを公式 API から移すチームは 移行ガイド に従えます。まずプロバイダーを比較検討しているなら、Twitter API の代替の比較 が、実際の数字で選択肢を並べます。


監修:Keksich(Sorsa創業者、マーケター兼X APIリサーチャー)

本ガイドは、Sorsa API の実地の運用、その稼働中のエンドポイントと公開の MCP およびスキルのリポジトリ、そして現行の v3 ドキュメントに基づいています。外部の数字は、AI ツールの採用と信頼については Stack Overflow 2025 開発者調査 に対して、コスト比較については X 自身のホスト型 MCP サーバーの開発者向け発表(2026年6月30日)と2026年4月20日の X API 料金更新に対して、2026年7月11日に確認しました。公式 X API は全体を通じて主要な比較の基準点です。