grok-skill

Grok 4 — X/Twitter ライブ検索スキル

前提条件

• OpenRouter API キーが必要です（環境変数 OPENROUTER_API_KEY に設定してください）
• キーは openrouter.ai で取得できます
• Bun ランタイムがインストールされていること

使用する場面

ユーザーが X/Twitter からのトレンド、アクティビティ、事例、証拠を求めた場合は、いつでもこのスキルを使用してください。

• 「twitter|x で を検索」
• 「X で話題になっているのは？」
• 「 に関する人気のツイート／スレッド／ハッシュタグ」
• 「 について、みんなは何と言っていますか？」
• 「@handle のツイート」、「@a と @b を比較」

実行方法（Claude が実行してください）

• 最小構成：

  bun scripts/grok.ts --q "<query>"
  

• API キーをインラインで指定して一度だけ実行：

  OPENROUTER_API_KEY="sk-or-..." bun scripts/grok.ts --q "<query>"
  

• ハンドルと日付範囲（YYYY-MM-DD）を指定して実行：

  bun scripts/grok.ts \
    --q "<topic or question>" \
    --mode on \
    --include "@OpenAI" "@AnthropicAI" \
    --from "2025-11-01" --to "2025-11-07" \
    --min-faves 50 --min-views 0 \
    --max 12
  

• 出力は簡潔な JSON です。summary、citations（ツイートの URL）、usage が含まれます。簡潔にまとめ、ツイートへのリンクを付けて提示してください。

デフォルトと注意事項

• ライブ検索の mode はデフォルトで auto です。「今すぐ X を検索」のように明示された場合は on を使用してください。
• ユーザーがハンドルを指定した場合は、--include（または --exclude）で渡してください。
• 期間を指定するリクエストには --from/--to を使用してください。指定がない場合、日付を推測しないでください。
• コストと応答時間を抑えるため、--max は控えめな値（8～20）にしてください。結果が少ない場合のみ増やしてください。
• --include と --exclude は同時に使用できません。
• 非公開／保護されたコンテンツにアクセスできると主張しないでください。長い引用よりリンクを優先してください。

トラブルシューティング

• 結果が少ない場合 → --max を増やすか、フィルターを緩めてください。ハンドルの削除も検討してください。
• リンクが見つからない場合 → JSON 出力の citations に含まれています。URL を共有してください。