threads-research

Threads の調査

公開されている Threads のプロフィール、投稿、返信を検索し、キーワード検索を実行します — すべて Crawlora API から正規化された JSON として取得します。アプリのスクレイピングや 非公式クライアントライブラリは使用しません。

このスキルを使用する場面

• 「Threads での のプロフィール／フォロワー数は？」
• 「この Threads の投稿の本文と返信を取得して。」
• 「 は最近 Threads に何を投稿した？」
• 「Threads で に関する投稿を検索して。」
• Threads での競合他社のソーシャルリスニングやブランドへの言及のモニタリング。

セットアップ（初回のみ）

• https://crawlora.net で無料の Crawlora API キーを取得します（月 2,000 クレジット、カード不要）。
• ヘルパーを実行する前に、環境に CRAWLORA_API_KEY を設定します。
• ヘルパーは環境から CRAWLORA_API_KEY を読み取り、https://api.crawlora.net/api/v1 にリクエストを送信します。キーがない、または無効な場合は 401 が返されます。

仕組み

1. プロフィール — /threads/profile/{username} で公開プロフィールのメタデータ （自己紹介、各種件数）を取得します。
2. プロフィールの投稿 — /threads/profile/{username}/posts でプロフィールの 公開投稿を取得します。不透明な cursor を使ってページネーションします。
3. 個別の投稿 — /threads/post/{username}/{code} で投稿の本文、投稿者、正規 URL、 プレビュー画像を取得します。
4. 投稿への返信 — /threads/post/{username}/{code}/replies でその投稿への 公開返信を取得します。
5. 検索 — /threads/search でクエリに対する Threads 検索結果の公開初回ページを取得します。

エンドポイント、メソッド、パラメーターの一覧は、reference/endpoints.md を参照してください。

API の呼び出し

# Profile + posts:
scripts/crawlora.sh /threads/profile/zuck | jq '.'
scripts/crawlora.sh /threads/profile/zuck/posts | jq '.'

# Post + replies:
scripts/crawlora.sh /threads/post/zuck/C1abc2DEfGh | jq '.'
scripts/crawlora.sh /threads/post/zuck/C1abc2DEfGh/replies | jq '.'

# Search:
scripts/crawlora.sh /threads/search q="web scraping" | jq '.'

すべてのリクエストに scripts/crawlora.sh を使用してください。API キーがコマンドライン引数に含まれないようにします。

エンドポイントリファレンス

このスキルで使用する Threads の全エンドポイントについては、reference/endpoints.md を参照してください。

使用例

• プロフィールの概要： /threads/profile/{username} で自己紹介とフォロワー数を取得し、 次に /threads/profile/{username}/posts で最近のアクティビティを確認します。
• 投稿の詳細調査： 特定の投稿の本文を /threads/post/{username}/{code} で取得し、 次に /threads/post/{username}/{code}/replies でその投稿への反応を確認します。
• キーワードの一括検索： ブランド名やトピック名で /threads/search を検索し、 現在 Threads でどの程度公開の会話が行われているかを把握します。

注意事項と制限

• クレジット／成功時のみ課金： 2xx の場合にのみ課金されます。無料枠は月 2,000 クレジットです。 キーは https://crawlora.net で取得できます。
• 公開データのみ — 公開プロフィール／投稿が対象です。ログインや非公開コンテンツには対応していません。 Threads の利用規約を遵守してください。
• セキュリティ： キーの保存先は CRAWLORA_API_KEY のみです。ハードコード、クエリパラメーターへの指定、コミットは絶対にしないでください。
• 検索に継続用カーソルはありません — /threads/search が返すのはログアウト状態での検索結果の初回ページのみです。それより先のページを取得する方法はありません。
• 返信のページネーションは不透明で、カーソルがない場合もあります — /threads/post/{username}/{code}/replies は、Threads が返信の続きがあると報告していても、取得に使えるカーソルが提供されない場合があることを示します。
• プロフィールの投稿はカーソルでページネーションします — 最初のページより先を取得するには、前回の /threads/profile/{username}/posts の応答に含まれる cursor を渡します。