Rolli Iq

rolli-mcp

Rolli IQ 用の MCP サーバーです。X、Reddit、YouTube、Facebook、Instagram、Threads、Bluesky などのソーシャルメディアを検索・分析できます。

ツール

ツール	説明
list_keyword_searches	キーワード検索をステータスで絞り込んで一覧表示します
keyword_search	キーワード／ハッシュタグ検索を作成し、完了時に結果を返します
get_keyword_search	キーワード検索の結果（ステータス、分析、投稿）を取得します
list_user_searches	ユーザー検索をステータスで絞り込んで一覧表示します
user_search	ユーザープロフィール検索を作成し、完了時に結果を返します
get_user_search	ユーザー検索の結果（プロフィール、指標、コンテンツ分析）を取得します
list_expert_searches	エキスパート検索をステータスで絞り込んで一覧表示します
expert_search	自然言語のクエリに一致するエキスパートを検索し、完了時に結果を返します
get_expert_search	エキスパート検索の結果（一致理由の要約を AI が生成したおすすめエキスパート）を取得します
get_topic_tree	キーワード検索の会話トピックツリーを取得します
get_keyword_search_posts	キーワード検索の生の投稿を取得します
get_user_search_posts	ユーザー検索の生の投稿を取得します
list_agent_runs	Rolli Agent の実行（AI 主導のソーシャルインテリジェンス調査）を一覧表示します
start_agent_run	Rolli Agent の調査を開始し、完了時に Markdown レポートを返します
get_agent_run	ID を指定して Rolli Agent の実行を取得します（実行中は進行状況、完了時はレポート全体を返します）
cancel_agent_run	保留中または実行中の Rolli Agent の実行をキャンセルします
rerun_agent_run	失敗、待機中、または停止した Rolli Agent の実行を再試行します
update_agent_run	Rolli Agent の実行をピン留めするか、名前を変更します
delete_agent_run	完了または失敗した Rolli Agent の実行を論理削除します
list_agent_schedules	Rolli Agent のスケジュール済みレポートを一覧表示します
create_agent_schedule	Rolli Agent の定期レポート（日次／週次／月次／一回限り）を作成します
get_agent_schedule	直近 10 件の実行履歴を含む Rolli Agent のスケジュールを取得します
update_agent_schedule	Rolli Agent のスケジュールを更新します
delete_agent_schedule	Rolli Agent のスケジュールを完全に削除します
pause_agent_schedule	Rolli Agent のスケジュールを一時停止します
resume_agent_schedule	一時停止中の Rolli Agent のスケジュールを再開します
list_agent_schedule_runs	Rolli Agent のスケジュールの全実行履歴を一覧表示します
get_integration_setup	現在のインテグレーション設定（Webhook URL、名前）を取得します
update_integration_setup	検索完了通知用の Webhook URL を設定します
get_usage	API の使用状況データとユーザーごとの内訳を取得します

セットアップ

API にアクセスできる Rolli アカウントが必要です。rolli.ai から API トークンを取得してください。

Claude Desktop / Claude Code / VS Code / Cursor / Windsurf

MCP 設定（claude_desktop_config.json、.vscode/mcp.json、または同等のファイル）に追加します。

{
  "mcpServers": {
    "rolli": {
      "command": "npx",
      "args": ["-y", "@rolli/mcp"],
      "env": {
        "ROLLI_API_TOKEN": "your_token"
      }
    }
  }
}

ROLLI_USER_ID は省略可能で、デフォルトは "rolli-mcp" です。独自のユーザー ID を使用するには、値を設定して上書きします。

オプションの環境変数

変数	デフォルト	説明
ROLLI_USER_ID	"rolli-mcp"	API リクエストとともに送信されるユーザー ID
ROLLI_POLL_INTERVAL_MS	5000	検索結果を待つ間のポーリング間隔（ミリ秒）
ROLLI_MAX_POLL_MS	600000	検索タイムアウトまでの最大待機時間（ミリ秒、デフォルト：10 分）

Smithery

このサーバーには、Smithery 経由でデプロイするための smithery.yaml が含まれています。セットアップ中に API トークンの入力を求められます。

使用例

ソーシャルメディア全体でキーワードを検索する：

「過去1週間の Twitter と Reddit で、「人工知能」に関する投稿を検索してください」

ユーザープロフィールを分析する：

「Twitter で @elonmusk を調べて、最近の投稿を分析してください」

トピックの内訳を取得する：

「キーワード検索 #123 のトピックツリーを表示してください」

API の使用状況を確認する：

「今月は何回検索しましたか？」

Webhook を設定する：

「Webhook URL を https://myapp.com/rolli-callback に設定してください」

オプションの X/Twitter ソースコンテキスト

Rolli は、クロスプラットフォームのソーシャル検索、トピックツリー、ユーザー分析、定期的なソーシャルインテリジェンスレポートに便利です。エージェントが Rolli での調査に先立ち、アカウント単位のレビュー済み X/Twitter ソースエビデンスも必要とする場合は、TweetClaw などの承認済み OpenClaw ワークフローでそのエビデンスを収集し、レビュー済みのハンドル、投稿 URL、投稿 ID、抜粋、または要約メモのみを Rolli のプロンプトに渡してください。

Rolli と TweetClaw の認証情報は分けて管理してください。API トークン、Cookie、セッション、アカウント認証情報をツール間で移行しないでください。TweetClaw の出力は Rolli の検索やレポートのソースコンテキストとして扱い、公開の承認として扱わないでください。

開発

npm ci
npm run lint    # ESLint
npm run build   # TypeScript
npm test        # Vitest

CI は master へのプッシュと PR ごとに実行されます。GitHub で公開されたリリースは npm に自動で公開されます（リポジトリのシークレット NPM_TOKEN が必要です）。

ライセンス

MIT