概要
AIからThreadsプロファイルを実行します:投稿、返信、会話全体やメンションを読み、投稿やアカウントのインサイト、キーワード検索や公開プロファイルを行い、テキスト、画像、動画、カルーセルの投稿や返信を公開し、返信を非表示または承認します。1つの長期有効なThreadsユーザートークン。
ガイド付きセットアップ
Threads を Cursor に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Threads を接続して、MCP URL を Cursor に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Threads のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセスしてください。 サインインし、Connectors → Threadsをクリックし、認証情報を貼り付け、MCP APIキーを作成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Threads + Cursor
AIからThreadsプロファイルを実行します:投稿、返信、会話全体やメンションを読み、投稿やアカウントのインサイト、キーワード検索や公開プロファイルを行い、テキスト、画像、動画、カルーセルの投稿や返信を公開し、返信を非表示または承認します。1つの長期有効なThreadsユーザートークン。
前提条件
コネクタに組み込まれている完全なセットアップ手順を参照してください(コネクタを選択するとアプリ内ストアで表示されます)。このコネクタに必要な環境変数は次のとおりです:
THREADS_ACCESS_TOKEN
ステップ1 — 認証情報を取得する
セットアップには約15分かかります。Threads APIにアクセスするユースケースを持つMetaアプリと、コネクタが動作するプロファイルの長期有効なThreadsユーザートークンが必要です。アプリを承認した任意のThreadsプロファイル(個人アカウントを含む)で動作します。
- developers.facebook.com/apps/creationでThreads APIにアクセスするユースケースを持つMetaアプリを作成します。ユースケースのカスタマイズページで必要な権限を追加します:
threads_basic(常に)、threads_content_publish、threads_read_replies、threads_manage_replies、threads_manage_insights、さらにthreads_manage_mentions、threads_keyword_search、threads_profile_discovery、threads_location_tagging、threads_deleteを使用する場合はそれらも追加します。 - アプリが開発中の間は、そのアプリの関係者のみが承認できます。App roles → Roles → Add People → Threads Testerの下にプロファイルを追加し、Threadsで招待を受け入れます(Settings → Account → Website permissions → Invites)。
- ユーザートークンを取得します:Graph API Explorerでアプリを選択し、ホストを
threads.netに切り替え、権限を選択してGenerate Threads Access Tokenをクリックします。このトークンは1時間有効です。 https://graph.threads.net/access_token?grant_type=th_exchange_token&client_secret=<Threads app secret>&access_token=<short-lived token>を開いて長期有効なトークン(60日間)に交換します。ThreadsアプリのシークレットはApp settings → Basicの下にあります。回答からaccess_tokenをコピーします。THREADS_ACCESS_TOKENに貼り付けますが、Bearerという単語は含めません(THで始まります)。コネクタをインストールし、threads_get_profileを実行して接続を確認します:プロファイルのユーザーIDとハンドルが返されます。
トークンは60日間有効です:Threadsはこの種のコネクタにリフレッシュトークンを提供しないため、貼り付けたトークンが唯一の認証情報です。60日が経過する前に(発行から少なくとも24時間後に)https://graph.threads.net/refresh_access_token?grant_type=th_refresh_token&access_token=<current token>を開いてリフレッシュし、新しいトークンをコネクタに貼り付けます。期限切れのトークンは更新できません:ステップ3と4を繰り返します。Access Token Debuggerでトークンの有効期限を確認できます。
クラウドとセルフホスティングは同じ方法で動作します:Metaでトークンを作成し、貼り付けます。AnythingMCPで設定するリダイレクトURLはありません。
開始する場所:threads_get_profile、次にプロファイルの投稿のためにthreads_list_postsを使用します。接続されたプロファイルに対して動作するツールはmeを使用するため、ユーザーIDを渡す必要はありません。返信については、threads_list_repliesが投稿へのトップレベルの返信を返し、threads_get_conversationがその下のすべてを返します。replied_toを使用してツリーを再構築します。threads_list_mentionsとthreads_list_my_repliesがプロファイルの活動の残りをカバーします。
インサイト:threads_get_post_insightsは1つの投稿のビュー、いいね、返信、リポスト、引用、シェアを返します;threads_get_account_insightsは一定期間のプロファイルの合計、1日あたりのビュー、100人のフォロワーからのフォロワーの人口統計を返します。インサイトは接続されたプロファイル自身の投稿にのみ存在します。
ディスカバリー:threads_search_postsはキーワードやトピックタグで検索します(承認されたthreads_keyword_search権限がない場合、プロファイル自身の投稿のみを検索します;24時間あたり2,200回の検索)。threads_lookup_profileとthreads_list_profile_postsは正確なユーザー名で公開プロファイルを読み取り、threads_search_locationsはタグ付けするための場所IDを見つけます。
公開はすぐに行われます:AIは正確なテキストとメディアを表示し、投稿する前に「はい」を待ちます。テキスト投稿または返信は1回の呼び出しで行われ、threads_post_text(最大500文字;reply_to_idを指定すると返信になります)。画像または動画の投稿は、公開メディアURLを使用してthreads_create_containerを必要とし、動画の場合はthreads_get_container_statusを使用してFINISHEDになるまで待ちます(平均約30秒)、その後threads_publishを実行します。カルーセルは2から20のアイテムコンテナで、1つのCAROUSELコンテナにそれらのIDとテキストを含め、次にthreads_publishを実行します。threads_repostは投稿をリポストします。threads_get_publishing_limitはクォータを表示します:24時間ごとに250の投稿、1,000の返信、100の削除。
モデレーション:threads_hide_replyはプロファイルの投稿に対するトップレベルの返信を非表示または表示します。返信承認がオンになっている投稿に対しては、threads_list_pending_repliesとthreads_manage_pending_replyが保留中の返信を承認または無視します。
インストール時にオフになっています:threads_delete_post(投稿、返信、リポストを完全に削除します)。削除は元に戻せず、threads_delete権限が必要です。AIが削除を行う必要がある場合のみ、コネクタページでオンにしてください;すべての呼び出しを確認するように求められます。公開、リポスト、返信の非表示、返信の承認はオンになっています(threads_post_text、threads_create_container、threads_publish、threads_repost、threads_hide_reply、threads_manage_pending_reply)。
ページングとID:リストはdataとpaging.cursorsを返します;AIはpaging.cursors.afterをafterとして渡し、最大100アイテムを1ページに表示します。IDは数字の文字列で、変更せずに渡されます。sinceとuntilはUnix秒または日付を取ります。
一般的なエラー:190はトークンが期限切れまたは取り消されたことを意味します(ユーザーがアプリを削除したか、パスワードを変更した)、またはFacebookまたはInstagramのトークンであり、Threadsのトークンではありません:新しいものを作成します(ステップ3と4)。10または200は権限が不足していることを意味します:ユースケースに追加し、トークンを再生成します。4、17、32または613はレート制限です:数分待ちます。ERRORのコンテナは通常、MetaがメディアURLをダウンロードできなかったことを意味します(公開されている必要があり、リダイレクトしてはいけません)またはフォーマットがサポートされていません。
カバーされていないもの:トークンを所有するプロファイル以外の他のThreadsプロファイル(2つ目のプロファイル用に2つ目のコネクタを追加)、およびFacebookとInstagramのAPI。
ステップ2 — アダプタをインストールする
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
ステップ3 — Cursorにコネクタを追加する
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL(
https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、
YOUR_MCP_API_KEYと置き換えます。 - ファイルを保存し、Cursor を再起動します。
- Cursor → Settings → MCP を開き、
anythingmcpが一覧にあり接続済みであることを確認します。 - チャットを始めましょう — エージェントが
Threadsのツールを呼び出せるようになりました。
利用可能なツール
| ツール | 何をするか |
|---|---|
threads_get_profile | 接続されたThreadsプロファイル:id、ユーザー名、表示名、経歴、プロフィール画像URL、is_verified |
threads_get_publishing_limit | プロファイルが使用した24時間のクォータ:投稿(クォータ使用量250、カルーセルは1回カウント)、返信(reply_quota_usage… |
threads_list_posts | 接続されたプロファイルが公開した投稿をリスト表示し、新しいものから順に:id、テキスト、メディアタイプとURL、パーマリンク、タイムスタンプ、引用およびリポストリンク… |
threads_get_post | メディアIDによる1つのThreads投稿または返信:テキスト、メディアタイプとURL、パーマリンク、所有者、タイムスタンプ、カルーセルの子要素、引用またはリポスト… |
threads_list_my_replies | 接続されたプロファイルが任意の投稿に書いた返信をリスト表示し、新しいものから順に、各返信がどの投稿に対するものか(replied_to、root_post) |
threads_list_mentions | 接続されたプロファイルに言及した他のプロファイルによる公開投稿をリスト表示し、新しいものから順に |
threads_list_replies | 投稿へのトップレベルの返信をリスト表示(返信への返信ではない)、デフォルトでは新しいものから順に、ユーザー名、テキスト、タイムスタンプ、hide_statusなどを含む |
threads_get_conversation | 投稿の下の全会話を1つのフラットリストとして表示:トップレベルおよびネストされた返信、各返信にはreplied_toとroot_postが含まれ、ツリーを再構築できます… |
threads_list_pending_replies | 返信承認がオンになっている投稿で承認待ちの返信をリスト表示します(enable_reply_approvals)。… |
threads_hide_reply | 接続されたプロファイルの投稿に対するトップレベルの返信を非表示または表示します |
threads_manage_pending_reply | 保留中の返信を承認または無視します(threads_list_pending_repliesから) |
threads_get_post_insights | 接続されたプロファイルの投稿の生涯にわたるエンゲージメント:ビュー、いいね、返信、リポスト、引用、シェア |
threads_get_account_insights | 一定期間の接続されたアカウントのプロファイルレベルのインサイト:ビュー(1日あたり)、いいね、返信、リポスト、引用、リンククリックなど… |
threads_search_posts | キーワードやトピックタグで公開Threads投稿を検索し、最も人気のある(TOP)または最新の(RECENT)、オプションでテキスト、画像、または動画投稿のみ… |
threads_lookup_profile | 正確なユーザー名による他のThreadsユーザーの公開プロファイル:名前、経歴、プロフィール画像、is_verified、follower_countおよびいいね… |
threads_list_profile_posts | 正確なユーザー名による他のThreadsプロファイルの最近の公開投稿、新しいものから順に |
threads_search_locations | 投稿にタグ付けする場所を名前または座標で見つけます;名前、住所、都市、国、座標を持つ場所IDを返します |
threads_post_text | テキスト投稿またはテキスト返信を1ステップで公開します(auto_publish_text):接続されたプロファイルで即座に公開されます |
threads_create_container | 画像、動画、またはカルーセル投稿(または返信)を公開するためのステップ1:公開URLからメディアコンテナを作成します |
threads_get_container_status | 公開前のメディアコンテナのステータス:IN_PROGRESS(処理中、数秒後に再確認)、FINISHED(公開準備完了) |
threads_publish | 公開のステップ2:接続されたプロファイルでFINISHEDメディアコンテナを公開します |
threads_repost | 接続されたプロファイルで公開されたThreads投稿をリポストします(リポストボタンのように) |
threads_delete_post | 接続されたプロファイルの投稿、返信、またはリポストを完全に削除します |
例のプロンプト
- "過去30日間の私のThreads投稿の中で、最も多くのビューを獲得したのはどれで、各投稿には何件の返信がありましたか?"
- "私の最新の投稿の下にある全会話を表示し、人々が何を尋ねているか要約してください。"
- "その投稿の下でのトップの質問に対する返信をドラフトし、公開する前に私に見せてください。"
- "今月の私のプロファイルビューとフォロワーはどのように変化しましたか?"
- "私たちの製品名に関する最近のThreads投稿を見つけ、それを書いたアカウントをリストアップしてください。"
FAQ
トークンが期限切れになるとどうなりますか? 呼び出しはエラー190で失敗します。60日が経過する前にgrant_type=th_refresh_tokenでトークンをリフレッシュし、新しいトークンをコネクタに貼り付けます;期限切れ後は新しいトークンを生成し、再度交換します。
投稿を削除できますか? コネクタページでthreads_delete_postをオンにし、トークンにthreads_delete権限がある場合のみ可能です。インストール時はオフになっています。
Cursor の無料プランでカスタム MCP サーバーは使えますか? はい — MCP は Hobby、Pro、Business の各プランで利用できます。
次のステップ
このガイドは役に立ちましたか?