mcp-threads-keyword-search

本地服务

github.com/mambalabsdev社交媒体01 周前更新

代码仓库

关于 mcp-threads-keyword-search

mcp-threads-keyword-search 是用于按关键词查找公开 Threads 帖子的 MCP 服务，适合社交媒体监测和调研。它支持精确短语匹配、筛选条件，以及记录此前运行已返回的帖子。

主要功能

01按关键词搜索 Threads 帖子
02匹配精确短语或全部词语
03按时间、点赞数和回复筛选
04多个关键词命中时仅返回一次
05记录此前运行返回的帖子

适用场景

01查找近期讨论某主题的帖子
02监测竞争对手相关提及
03收集帖子及其点赞数

MCP 相关

向 MCP 客户端提供 search_threads_posts 工具。该服务启动 Apify Actor 运行并返回数据集行。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "com-mambabuilt-mcp-threads-keyword-search": {
      "command": "npx",
      "args": [
        "-y",
        "@mambalabsdev/mcp-threads-keyword-search"
      ],
      "env": {
        "APIFY_TOKEN": "<APIFY_TOKEN>"
      }
    }
  }
}

启动命令npx -y @mambalabsdev/mcp-threads-keyword-search

需要配置的环境变量

APIFY_TOKEN密钥Apify API token from https://console.apify.com/account/integrations

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@mambalabsdev/mcp-threads-keyword-search1.0.1stdio

工具

收录的工具列表 · 更新于 1 周前

参数	类型	必填	说明
keywords	array	否	用于搜索 Threads 的词语或短语，最多 50 个。
only_new	boolean	否	跳过之前运行已返回的帖子（免费）。默认值为 false。
min_likes	integer	否	排除点赞数少于此值的帖子。
state_key	string	否	仅用于新帖子记忆的可选名称。
match_mode	enum	否	phrase 会在关键词中的词语连续出现在帖子文本中时保留帖子；all_words 会在每个词语都出现在文本任意位置时保留；off 会保留所有结果。默认值为 phrase。phrase \| all_words \| off
proxy_mode	enum	否	auto 使用 Apify 代理池，并在必要时回退到 residential；residential 则在每次搜索中都使用住宅地址。不影响价格。默认值为 auto。auto \| residential
since_days	integer	否	排除早于此天数的帖子。
max_charge_usd	string	否	可选。运行会在费用超过此金额前停止。
include_replies	boolean	否	同时返回匹配的回复。默认值为 true。
max_posts_per_keyword	integer	否	每个关键词返回的帖子数。默认值为 25。

详细介绍

Threads 关键词搜索 MCP 服务

这是一个 MCP 服务，用于调用 Mamba Labs 在 Apify 上的按关键词搜索 Threads 帖子，精确匹配 Actor。搜索 Threads 关键词，并为每条包含关键词的帖子返回一行扁平数据。

功能介绍

搜索每个关键词时，采用未登录访客使用 Threads 搜索的方式，每次搜索会显示约 20 到 25 条帖子。默认情况下，只有当关键词中的词语按顺序相邻出现在帖子文本中时，才会保留该帖子，因此不会收取关系较弱的结果的费用。被多个关键词找到的帖子只返回一次，并附上它匹配的所有关键词。支持按发布时间、点赞数和回复数筛选，也支持为定时任务记录仅获取新帖的记忆。每个关键词还会返回一行免费摘要。不会使用 Threads 或 Instagram 账号、登录信息或密钥。

所有操作都在 Apify 上运行。此软件包是一个轻量客户端，用于启动 Actor 运行、等待运行完成并返回数据集中的行。

快速开始

你需要 Node.js 18 或更高版本，以及拥有 API 令牌的 Apify 账号。

将以下内容添加到 Claude Desktop 配置文件（claude_desktop_config.json）、Cursor 或任何 MCP 客户端中：

{
  "mcpServers": {
    "mamba-threads-keyword-search": {
      "command": "npx",
      "args": [
        "-y",
        "@mambalabsdev/mcp-threads-keyword-search"
      ],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

重启客户端。此时会显示 search_threads_posts 工具。

前置条件

Node.js 18 或更高版本。
从 console.apify.com/account/integrations 获取 Apify API 令牌，并将其设为 APIFY_TOKEN。服务无需令牌也会列出其工具；调用工具时则需要令牌。

示例提示词

“查找过去 30 天内关于冷邮件的 Threads 帖子。”
“本周有哪些 Threads 帖子提到了我们的竞争对手名称？”
“收集关于 hubspot 替代方案的 Threads 帖子及其点赞数。”

工具

search_threads_posts。只有一个工具。参数示例：

{
  "keywords": [
    "cold email",
    "hubspot alternative"
  ],
  "match_mode": "phrase",
  "since_days": 30
}

输入项

Actor 面向购买者的所有输入项。省略的输入项将采用 Actor 自身的默认值。

输入项	类型	必填	描述
`keywords`	数组	否	要在 Threads 中搜索的词语或短语，最多 50 个。
`max_posts_per_keyword`	整数	否	每个关键词的帖子数，最多 50 条（Threads 通常显示约 20 到 25 条）。默认值为 25。
`match_mode`	字符串	否	phrase、all_words 或 off。默认值为 phrase。
`since_days`	整数	否	排除早于指定天数的帖子。
`min_likes`	整数	否	排除点赞数更少的帖子。
`include_replies`	布尔值	否	同时返回匹配的回复。默认值为 true。
`only_new`	布尔值	否	跳过之前运行已返回的帖子。默认值为 false。
`state_key`	字符串	否	用于标识仅获取新帖记忆的名称。
`max_charge_usd`	字符串	否	运行的可选费用上限。
`proxy_mode`	字符串	否	auto 或 residential。默认值为 auto。

定价

在 Apify 上按事件付费，费用计入你的 Apify 账号。价格以 USD 计。

事件	免费计划	Bronze	Silver	Gold
`post-row`，每条包含关键词的 Threads 帖子	$0.0025	$0.002375	$0.00225	$0.002125
`apify-actor-start`，每次运行启动	$0.0015	$0.0015	$0.0015	$0.0015