Back to Browse

Threads Keyword Search MCP Server

Developer ToolsModerate7.6MCP RegistryLocal
Free

Server data from the Official MCP Registry

Threads posts by keyword with exact phrase matching, author, date, likes, and link, no login

About

Threads posts by keyword with exact phrase matching, author, date, likes, and link, no login

Security Report

7.6
Moderate7.6Low Risk

This is a thin MCP wrapper that starts an Apify actor run, polls it to completion, and returns dataset rows for keyword searches of public Threads posts. It requires an APIFY_TOKEN bearer token read from the environment, with no hardcoded secrets, and its only network calls go to api.apify.com, which matches its stated purpose. The only notes are minor: the token is sent to a third-party platform by design and the tool returns raw dataset JSON without sanitization. Supply chain analysis found 1 known vulnerability in dependencies (0 critical, 1 high severity). Package verification found 1 issue.

7 files analyzed · 5 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Apify API token from https://console.apify.com/account/integrationsRequired

Environment variable: APIFY_TOKEN

How to Install

Add this to your MCP configuration file:

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

Documentation

View on GitHub

From the project's GitHub README.

Threads Keyword Search MCP Server

npm version license

An MCP server for the Mamba Labs Threads Posts by Keyword, Exact Match actor on Apify. Search Threads for keywords and get one flat row per post that contains them.

What's Inside

What it does

Each keyword is searched the way Threads search works for a visitor who is not logged in, which shows about 20 to 25 posts per search. By default a post is kept only when the keyword's words are in its text, next to each other and in order, so loosely related results are set aside and not charged. A post found by several keywords is returned once with every keyword it matched. Filters for age, likes, and replies, and an only new posts memory for schedules. Each keyword also returns one free summary row. No Threads or Instagram account, login, or key is used.

All of the work runs on Apify. This package is a thin client that starts the actor run, waits for it, and hands back the dataset rows.

Quick start

You need Node.js 18 or newer and an Apify account with an API token.

Add this to your Claude Desktop config (claude_desktop_config.json), Cursor, or any MCP client:

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

Restart the client. The search_threads_posts tool appears.

Prerequisites

Example prompts

  • "Find Threads posts about cold email from the last 30 days."
  • "Which Threads posts mention our competitor by name this week?"
  • "Collect Threads posts about hubspot alternatives with their like counts."

Tool

search_threads_posts. One tool. Example arguments:

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

Inputs

Every buyer facing input of the actor. Omitted inputs take the actor's own defaults.

InputTypeRequiredDescription
keywordsarraynoWords or phrases to search Threads for, up to 50.
max_posts_per_keywordintegernoPosts per keyword, up to 50 (Threads shows about 20 to 25). Default 25.
match_modestringnophrase, all_words, or off. Default phrase.
since_daysintegernoSet aside posts older than this many days.
min_likesintegernoSet aside posts with fewer likes.
include_repliesbooleannoReturn matching replies too. Default true.
only_newbooleannoSkip posts an earlier run returned. Default false.
state_keystringnoName for the only new posts memory.
max_charge_usdstringnoOptional cost cap for the run.
proxy_modestringnoauto or residential. Default auto.

Pricing

Pay per event on Apify, billed to your Apify account. Prices in USD.

EventFree planBronzeSilverGold
post-row, per Threads post that contains your keyword$0.0025$0.002375$0.00225$0.002125
apify-actor-start, per run start$0.0015$0.0015$0.0015$0.0015

Summary rows, refused input, posts set aside by your filters, and already delivered posts are free. Mamba Labs pays the platform costs of the run, Apify proxy traffic included.

Full actor documentation

apify.com/mambalabs/threads-keyword-search

License

MIT. See LICENSE.

Reviews

No reviews yet

Be the first to review this server!