mcpField
X
x-search

x-search

github.com/syjcnss生産性039 回インストール35 週間前に更新
リポジトリ

x-search について

xAI の Grok API を使って X の投稿を検索するスキルです。キーワード・セマンティック検索に加え、ユーザーや日付で絞り込み、分析と引用を返します。

主な機能

  1. 01キーワード・セマンティック検索
  2. 02日付範囲による絞り込み
  3. 03ユーザーの指定・除外
  4. 04画像と動画の分析
  5. 05推論モデルの利用

活用シーン

  1. 01X 上の特定テーマの話題を追跡
  2. 02期間やアカウントを指定した検索
  3. 03視覚メディアを含む投稿の検索
  4. 04複雑なテーマの詳細な分析

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/syjcnss/skills --skill x-search

インストール後、Claude Code で/x-searchを入力して読み込まれたか確認します。

同梱ファイルscripts/x_search.sh

詳細

X 検索

キーワード検索、セマンティック検索、ユーザーフィルタリング、期間指定機能を使用して、xAI の Grok API で X（Twitter）の投稿を検索します。

エージェント向けの手順

このスキルを呼び出す場合：

  1. ユーザーのリクエストに応じたパラメーターを指定し、Bash ツールでスクリプトを実行します
  2. 分析セクションと引用セクションの両方を含む出力を解析します
  3. 重要：必ずユーザーへの回答に引用を含めてください。スクリプトの出力には、番号付きの X 投稿 URL を記載した「Citations:」セクションがあり、ユーザーに必ず提示する必要があります
  4. 次の内容を含めて回答を整形します：
    • Grok による分析／調査結果
    • 参照されている投稿 URL をすべて含む引用の完全なリスト

スクリプトは引用を含む整形済みの出力を返します。必ずユーザーへの回答にこれらの引用を含めてください。

クイックスタート

基本的な X 検索：

scripts/x_search.sh "What are people saying about AI?"

環境の設定

必須の環境変数：

  • XAI_API_KEY：xAI API キー（必須）
  • XAI_API_HOST：API ホスト URL（任意。デフォルトは https://api.x.ai）

検索オプション

期間で絞り込む

検索対象を特定の期間に限定します：

scripts/x_search.sh "AI developments" --from-date 2025-01-01 --to-date 2025-02-06
ユーザーハンドルで絞り込む

特定のユーザーのみを検索します（最大 10 件）：

scripts/x_search.sh "latest updates" --allowed-handles elonmusk,gdb

特定のユーザーを除外します（最大 10 件）：

scripts/x_search.sh "tech news" --excluded-handles spamaccount,bot123

注：同じリクエストで --allowed-handles と --excluded-handles の両方を使用することはできません。

メディアの解析

投稿内の画像解析を有効にします：

scripts/x_search.sh "AI art trends" --enable-images

投稿内の動画解析を有効にします：

scripts/x_search.sh "product demos" --enable-videos
オプションの組み合わせ

すべてのオプションを組み合わせて使用できます：

scripts/x_search.sh "climate change discussion" \
  --from-date 2025-01-01 \
  --excluded-handles climateskeptic \
  --enable-images
推論モデルを有効にする

--thinking フラグを使用すると、より深い分析を行う推論モデルに切り替わります：

scripts/x_search.sh "complex topic requiring deep analysis" --thinking

デフォルトの grok-4-1-fast-non-reasoning の代わりに grok-4-1-fast-reasoning を使用します。

出力形式

スクリプトは JSON 応答を自動的に解析し、次の内容を出力します：

  1. テキストコンテンツ：Grok が整形した分析と調査結果
  2. 引用：参照番号付きの X 投稿 URL のリスト

出力例：

## Response:

[Analysis text with inline citation markers]

## Citations:
[1] https://x.com/i/status/...
[2] https://x.com/i/status/...

使用上の注意

  • デフォルトモデル：高速な検索応答を行う grok-4-1-fast-non-reasoning
  • --thinking フラグを使用する場合：より深い推論を行う grok-4-1-fast-reasoning
  • このスクリプトは curl を使用して xAI Responses API エンドポイントにクエリを送信します
  • 出力は jq で自動的に解析され、読みやすく整形されます
  • 日付形式：ISO8601（YYYY-MM-DD）
  • ハンドル数の上限：許可／除外リストそれぞれ最大 10 件

コメント

Markdown 対応