sociallens

sociallens

sociallens 可调用 Rolli IQ 的社交媒体搜索与分析 API：关键词、用户和专家搜索，以及搜索到的帖子、主题树、Agent 运行、Agent 计划、集成设置和账户用量。一个二进制文件同时提供命令行界面和 stdio MCP 服务。

使用前必须提供 API 令牌。设置 ROLLI_API_TOKEN；如果未设置或为空，所有工具都会在发出请求前报错。ROLLI_USER_ID 是可选的，默认值为 rolli-mcp；每次请求都会发送其值。可以通过 SOCIALENS_API_URL 覆盖 API 基础 URL；未设置时，请求会发送到 https://api.rolli.ai。

有一点与原始服务不同，值得提前了解：原始服务会持续轮询，直到搜索完成（最长可能需要十分钟）。sociallens 每次工具调用只发送一个请求，并返回 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；调用失败时为 1（包括缺少令牌或上游 API 错误）；用法错误时为 2。

MCP 服务

同一个二进制文件提供两种接口。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（必填）	获取一个关键词搜索。
list_user_searches	status（可选）	列出用户搜索。
user_search	query（必填）、platforms、start_date、end_date	启动用户搜索。
get_user_search	id（必填）	获取一个用户搜索。
list_expert_searches	status（可选）	列出专家搜索。
expert_search	query（必填）、platforms、start_date、end_date	启动专家搜索。
get_expert_search	id（必填）	获取一个专家搜索。
get_topic_tree	（无）	获取主题树。
get_keyword_search_posts	id（必填）	获取关键词搜索的帖子。
get_user_search_posts	id（必填）	获取用户搜索的帖子。
list_agent_runs	status（可选）	列出 Agent 运行记录。
start_agent_run	agent_id（必填）、input	启动 Agent 运行。
get_agent_run	id（必填）	获取一条 Agent 运行记录。
cancel_agent_run	id（必填）	取消 Agent 运行。
rerun_agent_run	id（必填）	重新运行 Agent。
update_agent_run	id（必填）、name、status	更新 Agent 运行记录。
delete_agent_run	id（必填）	删除 Agent 运行记录。
list_agent_schedules	status（可选）	列出 Agent 计划任务。
create_agent_schedule	agent_id、cron_expression（均为必填）、name	创建 Agent 计划任务。
get_agent_schedule	id（必填）	获取一个 Agent 计划任务。
update_agent_schedule	id（必填）、name、cron_expression、agent_id	更新 Agent 计划任务。
delete_agent_schedule	id（必填）	删除 Agent 计划任务。
pause_agent_schedule	id（必填）	暂停 Agent 计划任务。
resume_agent_schedule	id（必填）	恢复 Agent 计划任务。
list_agent_schedule_runs	id（必填）、status	列出计划任务的运行记录。
get_integration_setup	（无）	获取集成设置。
update_integration_setup	platform、webhook_url、enabled	更新集成设置。
get_usage	（无）	获取账户用量。

platforms 是平台名称数组。日期使用 YYYY-MM-DD 格式，作为 start_date / end_date。

开发

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。