mcp-threads-keyword-search

Threads キーワード検索 MCP サーバー

Apify 上の Mamba Labs の キーワードによる Threads 投稿検索（完全一致） アクター向け MCP サーバーです。Threads をキーワードで検索し、該当する投稿ごとに 1 行のフラットなデータを取得します。

内容

• できること
• クイックスタート
• 前提条件
• プロンプトの例
• ツール
• 入力
• 料金
• アクターのドキュメント全文
• ライセンス

できること

各キーワードは、ログインしていない訪問者が Threads 検索を利用したときと同じ方法で検索されます。検索結果には、1 回の検索につき約 20〜25 件の投稿が表示されます。デフォルトでは、キーワードの各単語が投稿本文に隣り合って順番どおりに含まれている場合にのみ、その投稿を保持します。そのため、関連性が緩やかな結果は除外され、料金も発生しません。複数のキーワードで見つかった投稿は、該当するすべてのキーワードとともに 1 回だけ返されます。投稿の経過日数、「いいね！」数、返信数によるフィルターのほか、定期実行向けに新しい投稿のみを取得する機能もあります。キーワードごとに無料のサマリー行も 1 行返されます。Threads や Instagram のアカウント、ログイン、キーは使用しません。

すべての処理は Apify 上で実行されます。このパッケージは、アクターの実行を開始して完了を待ち、データセットの行を返す薄いクライアントです。

クイックスタート

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。ツールは 1 つです。引数の例：

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

入力

アクターの購入者向け入力項目すべてです。省略した入力には、アクター独自のデフォルト値が使用されます。

入力	型	必須	説明
keywords	array	いいえ	Threads で検索する単語またはフレーズ。最大 50 件。
max_posts_per_keyword	integer	いいえ	キーワードごとの投稿数。最大 50 件（Threads では約 20〜25 件が表示されます）。デフォルトは 25 です。
match_mode	string	いいえ	phrase、all_words、または off。デフォルトは phrase です。
since_days	integer	いいえ	指定した日数より古い投稿を除外します。
min_likes	integer	いいえ	「いいね！」数が指定値より少ない投稿を除外します。
include_replies	boolean	いいえ	条件に一致する返信も返します。デフォルトは true です。
only_new	boolean	いいえ	以前の実行で返された投稿をスキップします。デフォルトは false です。
state_key	string	いいえ	新しい投稿のみを取得するためのメモリの名前です。
max_charge_usd	string	いいえ	実行に設定する任意の料金上限です。
proxy_mode	string	いいえ	auto または residential。デフォルトは auto です。

料金

Apify でイベントごとに課金され、Apify アカウントに請求されます。価格は USD です。

イベント	Free プラン	Bronze	Silver	Gold
post-row、キーワードを含む Threads 投稿 1 件あたり	$0.0025	$0.002375	$0.00225	$0.002125
apify-actor-start、実行開始 1 回あたり	$0.0015	$0.0015	$0.0015	$0.0015

サマリー行、拒否された入力、フィルターで除外された投稿、すでに配信済みの投稿は無料です。Apify のプロキシ通信費を含め、実行にかかるプラットフォーム料金は Mamba Labs が負担します。

アクターのドキュメント全文

apify.com/mambalabs/threads-keyword-search

License

MIT. See LICENSE.