AI Hub Icon
AIBit オープンソースプロジェクトを発見
ホーム / 実用的なオープンソースプロジェクト

CLIツール: Claude Code & OpenClaw での X/Twitter リサーチ

February 11, 2026
カテゴリ: 実用的なオープンソースプロジェクト
タグ:
OpenSource cli XAPI ResearchTool ClaudeCode

高速CLIでX/Twitterリサーチを解き放て

AIエージェントを構築したり、データ駆動の調査を行ったりするとき、X/Twitter から会話を取得する信頼できる方法が必要です。 x‑research‑skill はまさにそれを実現します――TypeScript で書かれたエンドツーエンドのコマンドラインインターフェースで、Claude Code や OpenClaw に直接接続します。ツイート、スレッド、ユーザー活動を即座に、安価に、コストを意識しながら閲覧でき、エージェントはより高レベルの推論に注力できます。

なぜ重要なのか

  • 低いハードル – 重い UI やサーバー設定は不要。Git クローン、Bun をインストール、認証だけ。
  • コスト透明性 – 各クエリ後に CLI が正確な X API コストを表示し、予算内に収められます。
  • キャッシュ駆動の節約 – 再度のクエリは15分（クイックモードでは1時間）のキャッシュを利用し、同一 API 呼び出しを排除します。
  • クイックモード – 1ページで10件のピークチェックを行い、クリック数とクレジットを最小限に抑えます。
  • ウォッチリスト監視 – 任意のアカウントセット周辺の会話を追跡し、新しい活動が検知されると自動でアラートします。

はじめ方

以下はリポジトリのクローンから最初の検索を実行するまでのステップバイステップロードマップです。

前提条件

  1. X Bearer Token を X デベロッパーポータル から入手します（読み取り専用アクセスで十分です）。
  2. それをシェルにエクスポート: export X_BEARER_TOKEN="your-token-here"、あるいは X_BEARER_TOKEN=your-token-here を ~/.config/env/global.env に追加します。
  3. Bun をインストールします（CLI を動かす軽量 JS 実行環境）。

ワークスペースへクローン

# Claude Code 用
mkdir -p .claude/skills && cd .claude/skills
git clone https://github.com/rohunvora/x-research-skill.git x-research

# OpenClaw 用
mkdir -p skills && cd skills
git clone https://github.com/rohunvora/x-research-skill.git x-research

サンプル検索を実行

cd skills/x-research
bun run x-search.ts search "OpenAI" --sort likes --limit 5

ターミナルにツイート本文、著者、日付、エンゲージメント指標、そして最後にリクエストコスト（例: $0.50）が表示されます。

特徴の詳細解説

検索とソーティング

自然言語や高度なフラグを使いましょう:

bun run x-search.ts search "AI agents" --sort impressions --since 1d

オプションは以下のとおりです:

  • --sort – likes, impressions, retweets, or recent
  • --since – 1h, 3h, 12h, 1d, 7d
  • --min-likes, --min-impressions – ポストフィルタリングで低いエンゲージメントを除外
  • --quick – 最大10件に制限、リツイートと返信を自動で隠す

スレッド取得

bun run x-search.ts thread <tweet_id>

完全なスレッドを取得し、各メッセージにラベル付け、マークダウンまたは JSON でフォーマットします。

ユーザープロフィールと最近のツイート

bun run x-search.ts profile @username

ユーザーの最新公開投稿を表示し、同じフィルタを尊重します。

ウォッチリストダッシュボード

bun run x-search.ts watchlist add alice "Crypto analyst"
bun run x-search.ts watchlist check

ローカルに watchlist.json を保管し、check が各ハンドルをスキャンし新しい活動をレポートします。

コスト管理

X の従量課金モデルは各 API 呼び出しに適用されます。デフォルト料金（2026年2月時点）は以下の通りです:

  • 投稿読み取り: $0.005
  • ユーザー検索: $0.010
  • 検索ページ（100ツイート）: 約 $0.50（クイックモード）、3ページで $1.50。
  • キャッシュ済みの繰り返しクエリは無料。
  • 24時間の重複排除で同一投稿の二重請求を防止。

CLI は実行ごとに簡潔なコスト概要を表示し、いつ何を使っているかを把握できます。しきい値を超えたら トップアップ で事前購入クレジットを追加してください。

セキュリティとトークン管理

ログにトークンを露出させないようにしましょう:

  • スクリプトは環境変数または ~/.config/env/global.env から X_BEARER_TOKEN を読み込みます。
  • 他者がアクセスするコマンドラインやスクリプトにトークンを埋め込まないでください。
  • 最小権限である読み取り専用トークンを使用します。
  • 露出が疑われる場合は速やかにトークンをローテーションしてください。

制限と今後のロードマップ

  • 現状「recent」検索エンドポイントのみを使用。フルアーカイブ検索は利用可能だがまだ統合されていません。
  • 書き込み権限はありません ― ツールは読み取り専用です。
  • 将来のリリースではフルアーカイブクエリ、高度なフィルタリング、スレッド構造のオプショナルなグラフ可視化をサポートする予定です。

最終考察

データサイエンティストが AI チャットボットを構築する場合、研究者がソーシャルメディアの洞察を集約する場合、あるいはエンスージアストがツイート取り込みを自動化する場合、x‑research‑skill は X API への強力でゼロフリクションのインターフェースを提供します。内蔵キャッシュ、コストレポート、クイックモードは予算管理を容易にし、ゼロから研究ワークフローをスケールできます。

リポジトリをクローンし、ベアラトークンを設定し、作業を開始してください。 Happy researching!

元の記事: オリジナルを見る

この記事を共有