コンテンツにスキップ
Twexapi
日本語
English简体中文日本語Español한국어FrançaisTürkçe
Esc
↑↓移動↵開く⌘Jプレビュー
このページの内容

MCP サーバー

Model Context Protocol で Claude、ChatGPT、Cursor などの AI エージェントを TwexAPI に接続します。TwexAPI アカウントでサインインするか、API キーを使います。

TwexAPI は https://api.twexapi.io/mcp で Model Context Protocol サーバーを提供しています。AI アシスタントやコーディングエージェントは、このサーバーを使ってツイートを検索したり、プロフィール、フォロワー、リプライ、スレッド、コミュニティ、リスト、トレンドを読み取ったりできます。呼び出しは REST リクエストと同じく、TwexAPI のクレジットを消費します。

このページでは API MCP サーバーについて説明します。エージェントに TwexAPI のドキュメントを検索させたい場合は、サインイン不要の Docs MCP サーバー（https://docs.twexapi.io/mcp）を使ってください。

クイックスタート

サーバーを追加する

MCP クライアントにリモートサーバーを追加し、URL に https://api.twexapi.io/mcp（Streamable HTTP）を指定します。サインインで接続する場合は、API キーやヘッダーの欄は空のままにしてください。

サインインする

クライアントがブラウザで twexapi.io を開きます。TwexAPI アカウント（メールまたは Google）でサインインし、承認後の戻り先を確認して、書き込み権限を付与するかを選び、Approve を選択します。

質問する

チャットを始めて、たとえば「TwexAPI で米国のトレンドトピックを調べて、上位のツイートを要約して」と頼みます。

クライアント別の手順：

Claude.ai と Claude Desktop

TwexAPI をカスタムコネクタとして追加します。

ChatGPT

Web 版またはデスクトップアプリで開発者モードから接続します。

コーディングエージェントとエディター

Claude Code、Codex、Cursor、VS Code、OpenCode、Windsurf。

独自クライアントを作る

OAuth 2.1 のエンドポイント、PKCE、スコープ、トークンの有効期間。

認証

サーバーは 2 種類の認証情報を受け付けます。

方式 用途 使い方
TwexAPI でサインイン（OAuth 2.1）、推奨 MCP の認可に対応したクライアント：Claude.ai、Claude Desktop、Claude Code、ChatGPT、Cursor、Codex、VS Code、OpenCode サーバー URL だけを追加します。サインインはクライアントが処理します。
API キー MCP のサインインに対応していないクライアント、スクリプト、エージェントフレームワーク x-api-key: YOUR_API_KEY または Authorization: Bearer YOUR_API_KEY を送ります。

API キーは TwexAPI ダッシュボード で作成またはコピーできます。ChatGPT はカスタムヘッダーを送れないため、常にサインインを使います。

サインインで許可される内容

  • アプリが受け取るトークンは https://api.twexapi.io/mcp でのみ使えます。パスワードや API キーは見えず、アカウントの変更やダッシュボードの閲覧もできません。
  • 呼び出しは、API キーで呼び出した場合とまったく同じように、アカウントのクレジットから課金されます。
  • 読み取りは常に許可されます。書き込み（twexapi_write によるツイートとリプライの投稿）は同意ページのチェックボックスで選べます。チェックを外すと読み取り専用で接続します。
  • アクセストークンの有効期間は 1 時間で、クライアントが自動で更新します。30 日間どのアプリにも使われなかった認可は失効します。
  • クライアントを接続するたびに、ダッシュボード の Authorized apps（認可済みアプリ）に項目が追加されます。Revoke を選ぶと、そのアプリのアクセスをすぐに止められます。クライアント側でコネクタを削除しても、TwexAPI 側の認可は取り消されません。

承認する前に

  • アカウントに、クレジットが残っている有効な API キーが必要です。クレジットがない場合、同意ページで先にチャージするよう案内されます。リクエストは 10 分間有効なので、チャージしてから再度 Approve を選択できます。
  • After you approve, you will return to（承認後の戻り先）の行を確認してください。claude.ai、chatgpt.com、デスクトップアプリなら 127.0.0.1 で始まるアドレスなど、使っているアプリのものになっているはずです。

ディスカバリー

MCP クライアントは、必要な情報をすべてサーバー自身から取得します。

URL 用途
https://api.twexapi.io/.well-known/oauth-protected-resource/mcp 保護リソースのメタデータ：認可サーバーの場所をクライアントに伝えます。
https://api.twexapi.io/.well-known/oauth-authorization-server 認可サーバーのメタデータ：サインイン、トークン、登録、取り消しの各エンドポイント。
https://api.twexapi.io/.well-known/mcp.json レジストリ向けの MCP サーバーカード。/.well-known/mcp/server-card.json でも同じ内容を返します。

認証情報のないリクエストには、保護リソースのメタデータ URL を含む WWW-Authenticate: Bearer チャレンジ付きで 401 が返ります。クライアントはこのチャレンジを見てサインインを開始します。全体の流れは MCP クライアントの OAuth を参照してください。

ツール

ツール 内容 利用可能な条件
explore エンドポイントカタログを検索し、メソッド、パス、パラメーター、例、呼び出しに使うツールを返します。クレジットを消費しません。 常に
twexapi_request 検索、プロフィール、フォロワー、リプライ、コミュニティ、リスト、トレンドなど、読み取り専用のエンドポイントを呼び出します。 常に
twexapi_write 書き込みエンドポイントを呼び出します。現在はツイートまたはリプライの投稿で、X アカウントの Cookie が必要です。 書き込みを許可したとき

Claude などのクライアントは、twexapi_write を呼ぶたびに確認を求めます。いいね、フォロー、DM などその他の書き込み操作は REST API でのみ利用できます。入力、出力、カタログ全体は MCP ツールリファレンス を参照してください。

クレジットとエラー

状況 表示される内容
認証情報がない サインインのチャレンジ付きで 401。サインインに対応したクライアントは自動でサインインを始めます。
API キーが無効、またはサインインが期限切れ・取り消し済み error="invalid_token" 付きで 401。再度サインインするか、キーを確認してください。
ダッシュボードで API キーが無効化されている 403、“This TwexAPI API key is disabled.”。
クレジットが残っていない 接続はそのまま使え、explore は無料です。その他のツール呼び出しは “No credits left on this TwexAPI account. Top up at https://twexapi.io/dashboard and try again.” を返します。
読み取り専用で認可した twexapi_write は表示されません。投稿したい場合は、書き込みのチェックを入れたまま再接続してください。

接続の問題を報告するときは、レスポンスヘッダー X-Request-Id と UTC 時刻を添えてください。

アカウントなしで呼び出しごとに支払う

API キーの代わりに Machine Payments Protocol で支払う MCP クライアントは、https://api.twexapi.io/mcp/pay に接続します。このエンドポイントは匿名のリクエストを受け付け、対象のツール呼び出しに支払いチャレンジを返します。メインの /mcp エンドポイントは、常にサインインまたは API キーが必要です。

Claude.ai と Claude Desktop

Claude.ai と Claude Desktop は同じコネクタを共有するため、TwexAPI の追加は 1 回で済みます。

カスタムコネクタを追加する

Settings → Connectors を開き、Add custom connector を選択します。名前に TwexAPI、URL に https://api.twexapi.io/mcp を入力します。OAuth のクライアント ID とシークレットは空のまま、Add を選択します。

接続する

Connect を選択し、開いた TwexAPI のページでサインインして Approve を選択します。

チャットで使う

チャットで + メニューを開き、コネクタから TwexAPI を有効にして質問します。

Team プランや Enterprise プランでは、オーナーが先にカスタムコネクタを許可する必要がある場合があります。

エージェントフレームワーク

エージェントのランタイムやスクリプトでは、通常 API キーを送ります。OpenAI Agents SDK の例：

from agents.mcp import MCPServerStreamableHttp

async with MCPServerStreamableHttp(
    params={
        "url": "https://api.twexapi.io/mcp",
        "headers": {"x-api-key": "YOUR_API_KEY"},
    },
) as twexapi:
    # use TwexAPI as a tool provider
    pass

キーはハードコードせず、環境変数やシークレットストアから読み込んでください。

MCP と REST API の比較

MCP サーバー

AI アシスタント、IDE のエージェント、自然言語のワークフローに向いています。エージェントは explore でエンドポイントを探し、twexapi_request または twexapi_write で呼び出します。

REST API

バックエンドサービス、定期ジョブ、直接の連携に向いています。Authorization: Bearer YOUR_API_KEY を付けて https://api.twexapi.io/* を呼び出します。すべてのエンドポイント、細かなページネーション制御、SDK のコードが必要な場合は API リファレンス を使ってください。

エージェントに自然言語で X/Twitter のデータを扱わせたいときは MCP を、本番のバックエンドを作るときや大量の結果を保存するときは REST を使います。

プロンプト例

接続したら、AI エージェントに次のように頼めます。

検索と取得

  • 過去 24 時間の AI agents に関する X の投稿を検索し、上位 20 件のツイートをツイート ID、投稿者、投稿日時、いいね数、リポスト数、1 行の要約付きで返して。
  • @elonmusk の最近のツイートから Grok または AI に触れたものを探し、トピックごとにまとめて X のリンクを付けて。
  • このツイートを読んで：https://x.com/elonmusk/status/2104354931595423762。内容を要約し、関連性の高いリプライを取得してリプライ ID を表示して。
  • ツイート ID 2104354931595423762 の類似ツイートを取得し、それぞれが関連する理由を説明して。

プロフィールとフォロー関係

  • @openai のプロフィールを読み、ユーザー名、表示名、ユーザー ID、所在地、フォロワー数、プロフィール URL を返して。
  • AI infrastructure に関連する X ユーザーを検索し、ユーザー名、プロフィール文、フォロワー数、一致した理由付きで 25 アカウント返して。
  • @elonmusk の最新のフォロワーを取得し、プロフィールで AI、スタートアップ、暗号資産に触れているアカウントを特定して。
  • @sama のフォロワーをカーソルページネーションで 1 ページ取得し、最初の 20 人を返して、次回用に next_cursor を残して。

トレンド

  • 対応しているグローバルトレンドの国をすべて表示し、united-states の上位トレンドトピックを取得して。
  • united-states で、トピック technology、コンテンツタグ AI のトレンドツイートを取得し、ツイート ID、投稿者、エンゲージメント指標を返して。
  • united-states、japan、united-kingdom のトレンドトピックを比べ、地域ごとの違いをまとめて。

リプライ、引用、スレッド

  • https://x.com/elonmusk/status/2104354931595423762 へのリプライを取得し、関連度順に並べて、リプライ ID、投稿者、本文、いいね数を返して。
  • ツイート ID 2104354931595423762 をリツイートしたユーザーを 50 人挙げ、ユーザー ID、ユーザー名、表示名、取得できればフォロワー数を返して。
  • ツイート ID 2104354931595423762 の引用ツイートを取得し、肯定的・批判的・中立に分類して。
  • ツイート ID 2104354931595423762 のスレッド全体を取得し、Markdown のアウトラインにまとめて。

記事、コミュニティ、リスト

  • X の記事 2104354931595423762 を Markdown で取得し、5 項目のエグゼクティブブリーフにまとめて。
  • AI builders に関連する X コミュニティを検索し、コミュニティ ID、名前、メンバー数、説明を返して。
  • AI founders に関連するリストを検索し、上位 10 件のリスト ID、名前、説明、メンバー数を返して。

フレームワークガイド

使い慣れたフレームワークで TwexAPI MCP ツールを使ってエージェントを構築できます。

LangChain

TwexAPI MCP ツールを LangChain と LangGraph のエージェントに接続します。

CrewAI

1 つの TwexAPI MCP 接続を共有するリサーチクルーを構築します。

Pydantic AI

Streamable HTTP の MCP ツールで型安全なエージェントを作ります。

Google ADK

Gemini ベースの ADK エージェントに TwexAPI のツールを追加します。

Mastra

TypeScript のエージェントをリモートの TwexAPI MCP ツールに接続します。

ノーコードワークフロー

エージェントの出力を n8n、Zapier、Make、Pipedream に引き渡します。

AI エージェントスキル

TwexAPI スキルを使うと、MCP 接続なしでも AI コーディングエージェントが TwexAPI API を深く理解できます。インストールすると、エージェントが API 連携を書いたり、MCP 接続を設定したり、TwexAPI のベストプラクティスに沿って作業したりできるようになります。

npx skills add twexapi-dev/x-api-scraper-cli

このページは役に立ちましたか？