Claude Code で Twitter/X のデータを使う：1行でセットアップ

#Claude Code は単独で Twitter を読めますか？

読めません。Claude Code には X 用のツールがなく、WebFetch ツールも x.com を開けません。2026年11月2日に、Claude Code 2.1.314 に X のプロフィール、単独の投稿、検索ページを取得させたところ、どのリクエストも本文なしの「HTTP 402 Payment Required」で返ってきました。

ログインしていないブラウザでも、X はほとんど見えません。プロフィールは自己紹介と数字が表示されるだけで、検索はログインページに飛ばされます。そのため X データは、追加するツールを通して Claude Code に届ける必要があり、それに向くのは2種類です。

• MCP サーバーは、Model Context Protocol（新しいタブで開きます） を通して、「投稿を検索する」「プロフィールを取得する」といったツールを Claude Code に渡します。普通の言葉で頼むと、Claude がツールを選び、返ってきた JSON を読み取ります。すべてセッションの中で完結します。
• スキルは、ツールの代わりに、書かれたノウハウを Claude Code に与えます。API を説明した SKILL.md ファイルで、Claude はそれをもとにリクエストを自分で書いて実行します。多くは、あとで使い回せるスクリプトとして残ります。

どちらの方法でも、データの取得元は必要です。公式 X API のホスト型 MCP サーバーと、コミュニティ製のほとんどのサーバーは、自分の X 開発者アプリで動き、OAuth と、投稿1件$0.005、プロフィール1件$0.010で課金される前払いクレジットを使います。月間の投稿読み取りは最大300万件です（X の料金（新しいタブで開きます））。X のユーザー名や Cookie でログインするサーバーは、開発者アプリが不要になる代わりに、アカウントを危険にさらします。データ API のキーなら、どちらも要りません。AI エージェント向け Twitter API のガイドでは、任意のエージェントについてこれらの方法を比較しています。このページでは、それを Claude Code にセットアップします。

#1行で Claude Code に X データを追加する

Claude Code で X を読むには、Twitter（X）API 兼スクレイピングツールである Sorsa API を、その MCP サーバー経由で使います。ターミナルで1行実行すると、キー1つの裏にある読み取り専用ツール40個が Claude に渡されます。X の開発者アカウントは不要で、ツイートは1,000件あたり$0.014から、どのプランも毎秒20リクエストです。

Sorsa API は、ツール呼び出し1回を1リクエストとして数えます。1回の呼び出しで、投稿100件をまとめて取得できる場合もあります。Claude Code は npx 経由でサーバーを起動するので、Node.js 18 以降のインストールが必要です。node -v でバージョンを確認できます。

1. キーを取得する。 Sorsa API にサインアップし、ダッシュボードの API キーのページからキーをコピーします。新しいアカウントには、料金がかからない100リクエストが付いてきます。カード不要で、時間が経っても失効しません。

2. サーバーを追加する。 Claude Code のセッションの外で、ターミナルから次のコマンドを実行します。YOUR_API_KEY は、コピーしたキーに置き換えてください。-s user を付けると、X のツールがすべてのプロジェクトで使えるようになります。

   claude mcp add sorsa -s user -e SORSA_API_KEY=YOUR_API_KEY -- npx -y sorsa-mcp
   

3. 接続を確認する。 claude mcp get sorsa を実行すると、「Scope: User config」と「Connected」が表示されるはずです。セッションの中では、/mcp が sorsa とそのツールを一覧表示します。

4. 最初の質問をしてみる。 「Sorsa API のリクエストは残りいくつ？」と聞いてみてください。Claude は get_key_usage_info で答えます。これは GET /key-usage-info（新しいタブで開きます） を使う無料の照会で、リクエストを消費しません。返答に数字があれば、チェーン全体が動いている証拠です。キーを打ち間違えていると、代わりに 401「invalid api key」が返ります。

5. 実際の仕事を任せる。 下の3つのプロンプトのどれかを貼り付けて、Claude がツールを選ぶ様子を見てください。

知っておきたいこと

コマンドの順序を守ってください。名前、次に -e、次に -- の順です。claude mcp add --env SORSA_API_KEY=... sorsa のようにキーを先に書くと、Claude Code は「Invalid environment variable format: sorsa」で止まります。このフラグは複数の組を受け取るため、名前をもう1つの組として飲み込んでしまうからです。

ダブルダッシュは、行の残りを npx に渡します。したがって、末尾に -e を付けると、それも npx に渡されます。その場合、サーバーは環境変数が空でキーのない状態で起動します。

ほかのアプリもセットアップしますか？ Sorsa MCP サーバーのページには、Cursor、Codex、VS Code 向けの対応する行が載っています。Twitter MCP サーバーガイドでは、ツール呼び出し1回あたりのコストを含め、X サーバーの種類を比べています。

#X ツールを使える範囲を選ぶ：自分、プロジェクト、チーム

Claude Code は MCP サーバーを3つのスコープのどれかに保存し、そのスコープが X ツールを使える人を決めます。1つのプロジェクトの中のあなた、すべてのプロジェクトのあなた、リポジトリをクローンした全員のいずれかです。

• Local：-s を省略したときの既定。サーバーを追加したプロジェクトでだけ読み込まれます。Claude Code は、そのプロジェクトのパスの下で ~/.claude.json に保存します。
• User：-s user を付けた場合。サーバーはコンピュータ上のすべてのプロジェクトで読み込まれ、自分専用のまま、同じく ~/.claude.json に保存されます。
• Project：-s project を付けた場合。Claude Code はサーバーをリポジトリのルートにある .mcp.json に書き込み、リポジトリをクローンした全員がそれを受け取ります。

スコープを選んで、コマンドをコピーしてください。

claude mcp add sorsa -s user -e SORSA_API_KEY=YOUR_API_KEY -- npx -y sorsa-mcp

claude mcp add sorsa -e SORSA_API_KEY=YOUR_API_KEY -- npx -y sorsa-mcp

claude mcp add-json sorsa -s project '{"type":"stdio","command":"npx","args":["-y","sorsa-mcp"],"env":{"SORSA_API_KEY":"${SORSA_API_KEY}"}}'

チームで使うなら、ファイルはコミットしてもキーは含めないでください。Claude Code は .mcp.json の中の ${VAR} 参照を展開するので、ファイルには変数名だけを書き、各自が自分のキーをシェルに置けます。

{
  "mcpServers": {
    "sorsa": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "sorsa-mcp"],
      "env": { "SORSA_API_KEY": "${SORSA_API_KEY}" }
    }
  }
}

このファイルは11月2日に claude mcp add-json で作成しました。チームメンバーが承認するまで、claude mcp list はサーバーを「Pending approval (run claude to approve)」と表示し、最初の対話セッションで一度だけ確認が出ます。変数が設定されていなければ、一覧に「Missing environment variables: SORSA_API_KEY」と警告が出るので、キーの不足が黙って見過ごされることはありません。承認または拒否したサーバーについてもう一度確認させたいときは、claude mcp reset-project-choices を実行します。すべてのスコープは、Anthropic の Claude Code の MCP ガイド（新しいタブで開きます）に記載されています。

#Claude Code にコードを書かせるなら、エージェント用スキルを追加する

Claude なしで動くコード、たとえばエクスポート用スクリプト、夜間ジョブ、データパイプラインを仕上げたいときは、Sorsa API のエージェント用スキルをインストールします。MCP サーバーはセッションの中で質問に答えます。スキルは Claude Code に API の使い方のルール（仕事ごとのエンドポイント、next_cursor によるページ送り、最大100件の ID のバッチ）を与えるので、書かれるコードは最初からそのルールに沿ったものになります。

npx skills add Sorsa-io/sorsa-x-api-skill -g -a claude-code -y

このコマンドは sorsa-x-api スキルを ~/.claude/skills/ にコピーし、すべての Claude Code セッションから見えるようにします。11月2日に実行して確認しました。Anthropic のスキルのドキュメント（新しいタブで開きます）にあるとおり、Claude Code はタスクが一致するまでスキルの短い説明だけを読み、一致したところで SKILL.md の全文を開きます。スキルのコードは SORSA_API_KEY からキーを読むので、~/.claude/settings.json の env ブロックに入れてください。Claude Code はこれを、すべてのセッションと、それが実行するコマンドに適用します。

{
  "env": { "SORSA_API_KEY": "YOUR_API_KEY" }
}

そのうえで、答えではなくファイルとして結果を頼みます。「自社の製品に言及した過去30日間の投稿をすべて mentions.csv に保存する Python スクリプトを書いて」と頼めば、Claude Code は POST /search-tweets（新しいタブで開きます） で next_cursor を最後までたどるループを書いて実行し、来月も使えるようにスクリプトを残します。

2つの方法は、仕事をきれいに分担します。

• セッション内での回答

  使うもの

  MCP サーバー

  理由

  Claude がツールを呼び出し、結果を自分で読む

• 残しておくファイルやスクリプト

  使うもの

  エージェント用スキル

  理由

  コードは Claude なしで動き、大量データが会話に入らない

• 両方

  使うもの

  両方を同じキーで

  理由

  どちらでも、呼び出し1回が1リクエスト

多くの人は MCP サーバーから始め、答えではなくファイルがほしくなった最初のときにスキルを追加します。

#すぐ使える3つのプロンプトと、1回の実行コスト

以下のプロンプトはどれも、作業、規模、出力を指定しているので、Claude Code は既知のツールを既知の回数だけ呼び出します。トピックやハンドルを差し替えて、セッションに貼り付けてください。

今週のトピックを調べる

Search X for posts about [your topic] from the last 7 days with
at least 20 likes. Read the top 100, group them into 3 to 5
themes, and give me a brief with the best 2 posts per theme,
linked.

Claude は search_tweets を、next_cursor をたどりながら5回実行します。1回につき約20件の投稿です。100件の投稿のコストは、Sorsa API では$0.007から、公式 X API の投稿1件$0.005のレートでは$0.50です。

フォローしているアカウントをダイジェストにする

For each of these accounts, read their posts from the last 7
days: [paste up to 10 handles]. Summarize what each one
announced or argued, flag anything about pricing or launches,
and end with a 5-line overview.

Claude はアカウントごとに get_user_tweets を1回呼び出し、POST /user-tweets（新しいタブで開きます） で20件ずつ投稿を取得します。約200件の投稿のコストは、Sorsa API では$0.014から、公式 X API のレートでは$1.00です。

アカウントのリストを審査する

Here are up to 100 X handles: [paste]. Get all the profiles in
one batch, then make a table with followers, following, posts,
join date and bio, sorted by followers. Flag accounts younger
than one year and save the table as accounts.csv.

Claude は get_user_info_batch を呼び出し、これが GET /info-batch（新しいタブで開きます） を実行して100件のプロフィールを一度に返します。コストは Sorsa API で$0.0014からです。公式 X API ではプロフィール1件$0.010で、このリストなら$1.00です。

公式 X API 側のコストは、2026年11月22日に増えます。この日から X は、投稿と一緒に返される投稿者に対して、1ユーザー$0.010を課金し始めます（X の告知（新しいタブで開きます））。20人の異なる投稿者による20件の投稿を返す検索は、$0.10から$0.30に上がります。Sorsa API では、すべての投稿が同じリクエストの中に、投稿者の完全なプロフィールを含んでいます。

3つのプロンプトを合わせて使うのは16リクエストなので、100回分の無料リクエストなら、プランを選ぶ前に6回実行できます。調査用のプロンプトを毎日実行したり、盛り上がっているトピックに向けたりすると、Claude が読む投稿が増えるごとに差が開きます。

#X の結果で Claude のコンテキストをあふれさせない

X の結果は長い JSON なので、Claude Code には必要な投稿だけを頼み、大量処理はスクリプトに回してください。Claude Code は、MCP ツールの1回の結果が1万トークンを超えると警告し、既定では2万5千トークンで切り捨てます。

• 件数を指定する。「いいねが多い上位50件」なら1回の呼び出しが小さく済みます。「X のすべて」と頼むと、Claude はページを進め続け、生の投稿でコンテキストを埋めてしまいます。
• 投稿に何が付いてくるかを知っておく。 どの投稿にも、投稿者の完全なプロフィールが付いてきます。Claude が情報源を判断するには役立ちますが、場所も取ります。結果を保存するときは、必要なフィールドだけを残すよう Claude に頼んでください。
• 1セッションだけ上限を上げる。 コンテキストの余裕より1つの大きな結果が重要なときは、MAX_MCP_OUTPUT_TOKENS=50000 claude を使います。
• 数千行はスキルに任せる。 フォロワーリストや1か月分のメンションは、CSV を書き出すスクリプトの仕事です。会話に入るのは、ファイルについての Claude の要約だけです。

ツール自体はほとんど場所を取りません。Sorsa API のサーバーは40個のツールを約2万3千文字、およそ5,800トークンで説明しており、既定のツール検索がオンの状態では、Claude Code はタスクが必要とするまで名前しか見ません。

#確認なしで Claude Code に X の作業を実行させる

Sorsa API のツールはすべて読み取りだけなので、毎回確認せずに Claude Code に呼び出させても大丈夫です。混乱したセッションや暴走したループにできるのは、せいぜいリクエストを消費することだけです。プロジェクトの .claude/settings.json か、すべてのプロジェクト向けに ~/.claude/settings.json に、許可ルールを1つ追加してください。

{
  "permissions": { "allow": ["mcp__sorsa__*"] }
}

Claude Code がワイルドカードを受け付けるのは、名前を指定したサーバーの後ろだけです。そのため mcp__sorsa__* は、Sorsa API のツールだけを承認し、それ以外は承認しません（権限ルール（新しいタブで開きます））。

同じルールで、無人での実行も可能になります。Claude Code のヘッドレスモード（新しいタブで開きます）である claude -p は、プロンプトを1つ実行して終了するので、cron ジョブや CI のスケジュールから、毎日の X ダイジェストを書き出せます。

claude -p "Search X for posts about [your topic] from the last 24 hours
and write a 10-line digest to digest.md" \
  --allowedTools "mcp__sorsa__*,Write"

11月2日に、架空のキーでこのようなヘッドレス呼び出しを実行しました。Sorsa API のツールは承認のプロンプトなしで動き、Sorsa API は 401「invalid api key」を返したので、Claude Code から API までのチェーン全体が生きていることがわかります。支出にも上限があります。1つのキーが毎秒20リクエストを超えることはなく、従量課金の追加リクエストは、請求期間ごとに設定した上限（引き上げない限り$100）で止まります。

知っておきたいこと

投稿に書かれた内容は読む材料として扱い、命令としては扱わないでください。X には AI エージェントを誘導するために書かれた投稿もあります。読み取り専用の X ツールなら、そうした投稿にできる最悪の影響は、リクエストを1つ消費させることです。ヘッドレス実行では、仕事に必要なツールだけを許可し、--allowedTools に Bash を入れないでください。

#今日から Claude Code を X につなぐ

Claude Code は x.com を取得できませんが、1行で X データを渡せます。セッション内の質問には Sorsa API の MCP サーバー、残しておくスクリプトにはそのエージェント用スキルを使い、どちらも読み取り専用のキー1つで動きます。ツイートは1,000件あたり$0.014からで、公式 X API は$5.00です。X のログイン情報も開発者アプリも、一切関与しません。まずは100回分の無料リクエストから始めてください。上の3つのプロンプトを6回実行できる量です。ほかのプロンプトは、AI で開発のページにあります。

#よくある質問