sociallens

sociallens

sociallens は、Rolli IQ のソーシャルメディア検索・分析 API と連携します。キーワード、ユーザー、専門家の検索と、それらの検索で見つかった投稿、トピックツリー、エージェントの実行、エージェントのスケジュール、連携の設定、アカウントの利用状況を扱います。1 つのバイナリで、コマンドラインインターフェイスと stdio MCP サーバーの両方を提供します。

API トークンが必要です。使用前に ROLLI_API_TOKEN を設定してください。未設定または空白の場合、リクエストは一切送信されず、すべてのツールがエラーで失敗します。ROLLI_USER_ID は任意で、デフォルト値は rolli-mcp です。その値はすべてのリクエストとともに送信されます。API のベース URL は SOCIALENS_API_URL で変更できます。設定されていない場合、呼び出し先は https://api.rolli.ai です。

元のサーバーとの違いとして、あらかじめ知っておきたい点があります。元のサーバーは検索が完了するまでポーリングして待機します（最長 10 分かかることがあります）。sociallens はツール呼び出しごとに 1 回だけリクエストを行い、その時点で API が返すステータスと結果を返します。実行中の検索を確認するには、対応する get_* ツールをもう一度呼び出してください。

インストール

npx @reneturcios/sociallens get_usage

または、コンテナイメージを実行します。

docker run -i ghcr.io/cloudcorprecords/sociallens

コンテナはデフォルトで MCP サーバーとして起動します（下記を参照）。CLI として使用するには、CLI 引数を渡してください。

CLI

サブコマンド名は MCP ツール名に対応しています。

export ROLLI_API_TOKEN=...

sociallens list_keyword_searches --status completed
sociallens keyword_search --query "electric vehicles" --platforms x,reddit
sociallens get_keyword_search --id ks1
sociallens get_keyword_search_posts --id ks1
sociallens list_user_searches
sociallens user_search --query "@someone"
sociallens list_expert_searches
sociallens expert_search --query "climate science"
sociallens get_topic_tree
sociallens list_agent_runs --status running
sociallens start_agent_run --agent-id ag1 --input "weekly roundup"
sociallens create_agent_schedule --agent-id ag1 --cron-expression "0 9 * * *" --name daily
sociallens pause_agent_schedule --id s1
sociallens list_agent_schedule_runs --id s1
sociallens get_integration_setup
sociallens update_integration_setup --platform slack --enabled true
sociallens get_usage

sociallens --version

結果には上流の JSON ペイロードが出力されます。終了コードは、成功時が 0、呼び出し失敗時（トークンの未設定や上流 API のエラーを含む）が 1、使用方法のエラー時が 2 です。

MCP サーバー

1 つのバイナリで両方の機能を提供します。mcp サブコマンドで stdio MCP サーバーを起動します。

npx -y @reneturcios/sociallens mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "sociallens": {
      "command": "npx",
      "args": ["-y", "@reneturcios/sociallens", "mcp"],
      "env": { "ROLLI_API_TOKEN": "..." }
    }
  }
}

ツール

ツール	入力	機能
list_keyword_searches	status（任意）	キーワード検索の一覧を取得します。
keyword_search	query（必須）、platforms、start_date、end_date	キーワード検索を開始します。
get_keyword_search	id（必須）	キーワード検索を1件取得します。
list_user_searches	status（任意）	ユーザー検索の一覧を取得します。
user_search	query（必須）、platforms、start_date、end_date	ユーザー検索を開始します。
get_user_search	id（必須）	ユーザー検索を1件取得します。
list_expert_searches	status（任意）	エキスパート検索の一覧を取得します。
expert_search	query（必須）、platforms、start_date、end_date	エキスパート検索を開始します。
get_expert_search	id（必須）	エキスパート検索を1件取得します。
get_topic_tree	（なし）	トピックツリーを取得します。
get_keyword_search_posts	id（必須）	キーワード検索の投稿を取得します。
get_user_search_posts	id（必須）	ユーザー検索の投稿を取得します。
list_agent_runs	status（任意）	エージェントの実行一覧を取得します。
start_agent_run	agent_id（必須）、input	エージェントの実行を開始します。
get_agent_run	id（必須）	エージェントの実行を1件取得します。
cancel_agent_run	id（必須）	エージェントの実行をキャンセルします。
rerun_agent_run	id（必須）	エージェントの実行を再実行します。
update_agent_run	id（必須）、name、status	エージェントの実行を更新します。
delete_agent_run	id（必須）	エージェントの実行を削除します。
list_agent_schedules	status（任意）	エージェントのスケジュール一覧を取得します。
create_agent_schedule	agent_id、cron_expression（両方必須）、name	エージェントのスケジュールを作成します。
get_agent_schedule	id（必須）	エージェントのスケジュールを1件取得します。
update_agent_schedule	id（必須）、name、cron_expression、agent_id	エージェントのスケジュールを更新します。
delete_agent_schedule	id（必須）	エージェントのスケジュールを削除します。
pause_agent_schedule	id（必須）	エージェントのスケジュールを一時停止します。
resume_agent_schedule	id（必須）	エージェントのスケジュールを再開します。
list_agent_schedule_runs	id（必須）、status	スケジュールの実行一覧を取得します。
get_integration_setup	（なし）	インテグレーション設定を取得します。
update_integration_setup	platform、webhook_url、enabled	インテグレーション設定を更新します。
get_usage	（なし）	アカウントの使用状況を取得します。

platforms はプラットフォーム名の配列です。日付は start_date／end_date として YYYY-MM-DD 形式を使用します。

開発

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx

ライセンス

MIT — LICENSE を参照してください。