Threads Keyword Search MCP Server
Search Threads public posts by keyword and retrieve structured post data with filtering and optional new-post tracking.
Search up to 50 keywords or phrases and get one flat row per matching post, deduplicated across keywords.
Control matching with
phrase,all_words, oroffmodes.Limit results per keyword, and filter by post age, minimum likes, and whether replies are included.
Track only new posts across runs using
only_newandstate_key.Choose proxy mode and optionally set a maximum USD charge for the run.
Receive post text, author, publish date, likes, replies, reposts, quotes, and post link, plus one summary row per keyword.
Use read-only public Threads search without a Threads/Instagram login; requires an Apify token.
Provides keyword and phrase search over Threads posts, returning matching posts with filters for recency, likes, and replies, plus options for match mode, only-new deduplication, and summary rows.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Threads Keyword Search MCP Server Find Threads posts about cold email from the last 30 days with 50+ likes"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Threads Keyword Search MCP Server
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
Related MCP server: Threads API MCP Server
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
Node.js 18 or newer.
An Apify API token from console.apify.com/account/integrations, set as
APIFY_TOKEN. The server lists its tool without a token; a call needs one.
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.
Input | Type | Required | Description |
| array | no | Words or phrases to search Threads for, up to 50. |
| integer | no | Posts per keyword, up to 50 (Threads shows about 20 to 25). Default 25. |
| string | no | phrase, all_words, or off. Default phrase. |
| integer | no | Set aside posts older than this many days. |
| integer | no | Set aside posts with fewer likes. |
| boolean | no | Return matching replies too. Default true. |
| boolean | no | Skip posts an earlier run returned. Default false. |
| string | no | Name for the only new posts memory. |
| string | no | Optional cost cap for the run. |
| string | no | auto or residential. Default auto. |
Pricing
Pay per event on Apify, billed to your Apify account. Prices in USD.
Event | Free plan | Bronze | Silver | Gold |
| $0.0025 | $0.002375 | $0.00225 | $0.002125 |
| $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.
Available Tools
1 toolsearch_threads_postsSearch Threads posts by keywordARead-onlyIdempotent
Search Threads for keywords and return one flat row per post that contains the keyword: text, author, publish date, likes, replies, reposts, quotes, and the post link, plus one free summary row per keyword. By default a post is kept only when the keyword's words are in its text next to each other; a post found by several keywords is returned once. Threads shows a visitor who is not logged in about 20 to 25 posts per search. Reads the public Threads search page; no login or key. A run that does not succeed is returned as an error with its run ID. Read-only; requires an APIFY_TOKEN and is billed per post row.
Inputs: keywords, only_new, min_likes, state_key, +6 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
Only one tool exists, so there is no possibility of confusing it with another tool. Its purpose—searching Threads posts by keyword—is clear and singular.
The single tool name follows a clear verb_resource_action pattern (search_threads_posts) and uses consistent snake_case. There are no conflicting conventions to compare against.
A single tool is slightly below the typical 3-15 range, but it fits the server's narrow, explicitly search-focused purpose. The tool is well-scoped and earns its place rather than being redundant.
The tool covers the core search operation with detailed post fields and a summary row, which is appropriate for a read-only keyword search server. Minor gaps include no pagination, date/author filters, or post-detail retrieval, but these are workable limitations for the stated scope.
Maintenance
Related MCP Connectors
Threads public posts, replies and profiles, with view counts, keyword and account search.
Search public Threads posts by keyword for AI agents: text, author, likes, replies, reposts.
Publish, reply, moderate, search and read insights on your Threads (threads.com) account.
Search and read public Reddit and X posts, comments, threads, profiles and Articles; run monitors.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables professional Threads management with advanced analytics, AI-powered content optimization, and automation features.4559 npmMIT
- FlicenseAqualityDmaintenanceEnables AI agents to interact with Meta Threads by fetching profile details, recent posts, post and account analytics, and conversation reply trees, as well as exporting posts as JSON for archiving or embedding.7-
- AlicenseAqualityBmaintenanceEnables AI agents to manage a Threads profile through Meta's API, including posting, threads, replies, reply moderation, and insights.3030 npm4MIT
- FlicenseNot gradedqualityBmaintenanceEnables AI agents to interact with Threads via MCP, including sub-80ms keyword search, full nested discussion tree extraction, replying to any external thread, publishing posts, fetching user profiles and threads, trending topics, and engagement actions like likes and reposts.3-