Rolli

ai.rolli由 rolli.ai 发布v1.2.1更新于 Oct 24, 2026

Social media search, expert discovery, and analytics across X, Reddit, YouTube, and more

已验证STDIO仅桌面效率与工作流网页搜索与抓取数据与分析

概览

AI 生成的概览

让助手在 X、Reddit、YouTube 等平台执行社交媒体关键词、用户与专家搜索，并管理 Rolli Agent 报告。

可以做什么
Rolli IQ 提供跨 X、Reddit、YouTube、Facebook、Instagram、Threads、Bluesky 等平台的社交媒体搜索与分析。工具可创建并获取关键词/话题标签搜索、用户资料搜索和专家搜索，返回状态、分析数据、帖子以及对话主题树。它还能管理 Rolli Agent 调查与定时报告，包括启动、取消、重跑、置顶、重命名和删除运行与计划，并支持 webhook 设置和 API 用量查询。
适用场景
当助手需要跨平台社交聆听、主题拆解、资料分析、专家发现或定期社交情报报告时适用。适合已使用 Rolli 账户的研究、营销和监测工作流。
运行要求
通过 npm 包 @rolli/mcp 以 stdio 在本地运行，需要 Node.js 和 npx。需要具备 API 访问权限的 Rolli 账户，API 令牌通过环境变量 ROLLI_API_TOKEN 提供。可选变量包括 ROLLI_USER_ID、ROLLI_POLL_INTERVAL_MS 和 ROLLI_MAX_POLL_MS。需要访问 Rolli API 的网络连接。
安装前请注意
该服务器需要密钥 ROLLI_API_TOKEN，需向服务商购买；请妥善保管，不要在不同工具之间共用。多个工具会写入或更改数据，包括创建和删除 Agent 运行与计划、更新集成设置以及设置 webhook URL。搜索和报告会将查询与账户数据发送到 Rolli 服务。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Rolli，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

[Rolli IQ]

rolli-mcp

MCP server for Rolli IQ — social media search and analytics across X, Reddit, YouTube, Facebook, Instagram, Threads, Bluesky, and more.

[Rolli MCP server]

Tools

ToolDescription
list_keyword_searchesList all keyword searches, filtered by status
keyword_searchCreate a keyword/hashtag search and return results when complete
get_keyword_searchGet keyword search results (status, analytics, posts)
list_user_searchesList all user searches, filtered by status
user_searchCreate a user profile search and return results when complete
get_user_searchGet user search results (profile, metrics, content analysis)
list_expert_searchesList all expert searches, filtered by status
expert_searchFind experts matching a natural-language query and return results when complete
get_expert_searchGet expert search results (recommended experts with AI-generated match summaries)
get_topic_treeGet conversation topic tree for a keyword search
get_keyword_search_postsGet raw posts from a keyword search
get_user_search_postsGet raw posts from a user search
list_agent_runsList Rolli Agent runs (AI-driven social intelligence investigations)
start_agent_runStart a Rolli Agent investigation and return the markdown report when complete
get_agent_runGet a Rolli Agent run by ID (progress while running, full report when complete)
cancel_agent_runCancel a pending or running Rolli Agent run
rerun_agent_runRetry a failed, waiting, or stuck Rolli Agent run
update_agent_runPin or rename a Rolli Agent run
delete_agent_runSoft-delete a completed or failed Rolli Agent run
list_agent_schedulesList Rolli Agent scheduled reports
create_agent_scheduleCreate a recurring Rolli Agent report (daily/weekly/monthly/once)
get_agent_scheduleGet a Rolli Agent schedule with its 10 most recent runs
update_agent_scheduleUpdate a Rolli Agent schedule
delete_agent_schedulePermanently delete a Rolli Agent schedule
pause_agent_schedulePause a Rolli Agent schedule
resume_agent_scheduleResume a paused Rolli Agent schedule
list_agent_schedule_runsList the full execution history of a Rolli Agent schedule
get_integration_setupGet current integration settings (webhook URL, name)
update_integration_setupSet the webhook URL for search completion notifications
get_usageGet API usage data and per-user breakdowns

Setup

You need a Rolli account with API access. Get your API token from rolli.ai.

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

Add to your MCP config (claude_desktop_config.json, .vscode/mcp.json, or equivalent):

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

ROLLI_USER_ID is optional and defaults to "rolli-mcp". Set it to override with your own user ID.

Optional Environment Variables

VariableDefaultDescription
ROLLI_USER_ID"rolli-mcp"User ID sent with API requests
ROLLI_POLL_INTERVAL_MS5000Polling interval (ms) when waiting for search results
ROLLI_MAX_POLL_MS600000Max time (ms) to wait before search timeout (default: 10 min)

Smithery

This server includes a smithery.yaml for deployment via Smithery. It will prompt for your API token during setup.

Usage Examples

Search for a keyword across social media:

"Search for posts about 'artificial intelligence' on Twitter and Reddit from the last week"

Analyze a user profile:

"Look up @elonmusk on Twitter and analyze their recent posts"

Get topic breakdown:

"Show me the topic tree for my keyword search #123"

Check API usage:

"How many searches have I used this month?"

Set up a webhook:

"Set my webhook URL to https://myapp.com/rolli-callback"

Optional X/Twitter Source Context

Rolli is useful for cross-platform social search, topic trees, user analysis, and scheduled social intelligence reports. If an agent also needs reviewed account-scoped X/Twitter source evidence before a Rolli investigation, collect that evidence in an approved OpenClaw workflow such as TweetClaw, then pass only the reviewed handles, post URLs, post IDs, excerpts, or summary notes into Rolli prompts.

Keep Rolli and TweetClaw credentials separate. Do not transfer API tokens, cookies, sessions, or account credentials between tools. Treat TweetClaw output as source context for Rolli searches and reports, not as publishing approval.

Development

sh
npm cinpm run lint    # ESLintnpm run build   # TypeScriptnpm test        # Vitest

CI runs on every push and PR to master. Releases published on GitHub automatically publish to npm (requires NPM_TOKEN repo secret).

License

MIT

来源：README.md，提交 f0ded75

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.2.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分