social-media-research

ソーシャルメディア調査

11 のソーシャルプラットフォームで公開プロフィール、投稿、エンゲージメントを調べ、キーワード／ハッシュタグ検索を実行し、トレンドのトピックを追跡できます。すべて Crawlora API の正規化された JSON 形式で取得するため、アプリのスクレイピングや非公式クライアントライブラリは不要です。

ツールの対象範囲とデータフロー

このスキルが実行を求めるコマンドは、任意のシェルヘルパーのみです。ヘルパーは、ドキュメントに記載された許可リスト内の Crawlora ルートにのみ GET リクエストを送信します。呼び出されると、CRAWLORA_API_KEY を読み取り、HTTPS 経由で api.crawlora.net に x-api-key ヘッダーとして送信します。ソーシャルプラットフォームにキーを送信することはありません。TMPDIR の下に権限を 600 に設定した curl 設定ファイルを一時的に書き込み、コマンドの終了時に削除します。他の環境変数を調べたり、ファイルを列挙したり、ソフトウェアをインストールしたり、昇格した権限で実行したりすることはありません。検索語句、公開ハンドル、URL、その他リクエストされた対象は Crawlora に送信されます。機密性の高い調査や個人情報を送信しないでください。

Facebook Marketplace ルートが返すのは公開リスティングであり、ソーシャル投稿ではありません。Reddit のリードルートは、商品やサービスの購入意向を示す公開投稿を順位付けします。明示的にリードの発見を依頼された場合にのみ使用し、投稿単位のスコアリングについて開示してください。また、機微な特性を推測したり、重大な影響を伴う意思決定の対象として個人を選定したりしないでください。

このスキルを使う場面

• 「 での のプロフィール／フォロワー数／最近の投稿は？」
• 「この投稿のエンゲージメント（いいね、コメント、シェア）を取得して。」
• 「<topic/hashtag> についての投稿を で検索して。」
• 「現在 でトレンドになっているのは？」
• 競合のソーシャルリスニング、インフルエンサー調査、ブランドへの言及のモニタリング。

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

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

仕組み

プラットフォームを選び、次に実行する処理を選びます。

1. プロフィール — /instagram/profile/{username}、/tiktok/profile/{handler}、 /threads/profile/{username}、/bluesky/profile、/x/profile/{username}、 /pinterest/user/{username}、/linkedin/company/{id}、 /facebook/{page}、/reddit/user/{username}/posts。
2. 投稿／フィード — /instagram/reels/{id}、/tiktok/posts、 /threads/profile/{username}/posts、/bluesky/author-feed、 /x/profile/{username}/posts、/pinterest/user/{username}/pins、 /reddit/subreddit/{subreddit}/posts。
3. 単一の投稿／ピン／ピンの詳細 — /instagram/post/{id}/{post_id}、 /tiktok/post/{id}、/threads/post/{username}/{code}（＋ /replies）、 /bluesky/post-thread、/x/post/{id}、/pinterest/pin/{id}、 /reddit/post/{id}（＋ /reddit/comments/{id}）。
4. 検索と発見 — /tiktok/search、/tiktok/search_hashtag、 /bluesky/search-actors、/pinterest/search、/reddit/search、 /facebook/marketplace/search（ソーシャル投稿ではなくリスティング）、および リファレンスに記載されている Bilibili と Patreon の公開ディスカバリーエンドポイント。
5. トレンド — /tiktok/trending、/tiktok/creative-center/hashtags、 /bluesky/trending-topics、/reddit/trends、/reddit/subreddits/posts （複数のサブレディットの人気フィード）。

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

API の呼び出し

# Profile + posts:
scripts/crawlora.sh /tiktok/profile/nasa | jq '.'
scripts/crawlora.sh /reddit/user/spez/posts | jq '.'

# Search:
scripts/crawlora.sh /tiktok/search keyword="ai agents" | jq '.'
scripts/crawlora.sh /reddit/search q="web scraping" | jq '.'

# Trending:
scripts/crawlora.sh /tiktok/trending | jq '.'
scripts/crawlora.sh /bluesky/trending-topics | jq '.'

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

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

このスキルが使用する Instagram、 TikTok、Threads、Bluesky、X、Pinterest、LinkedIn、Facebook、Reddit、Bilibili、 Patreon のすべてのエンドポイントについては、reference/endpoints.md を参照してください。

例

• 競合他社のソーシャルメディア監査： 競合他社が活動している各プラットフォームでプロフィールと最近の投稿を取得し、フォロワー数と投稿頻度を比較します。
• ブランドの言及調査： 同じブランド名／製品名で /reddit/search、/tiktok/search、/pinterest/search を検索し、キャプションやコメントから投稿数と感情を示す手がかりを集計します。
• インフルエンサーの審査： 提携前に、プロフィールと最近の投稿からフォロワー数、エンゲージメント率（投稿あたりの「いいね」とコメント数）、投稿の一貫性を確認します。
• トレンドトピックの調査： /tiktok/trending、/bluesky/trending-topics、/reddit/trends を使って、同日のクロスプラットフォームスナップショットを取得します。

注意事項と制限

• クレジット／成功時のみ課金： 2xx の場合にのみ課金されます。無料プランは月 2,000 クレジットです。 キーは https://crawlora.net で取得してください。
• 公開データのみ — 公開プロフィールと投稿が対象です。ログインや非公開コンテンツには対応していません。 各プラットフォームの利用規約を遵守してください。
• セキュリティ： キーは CRAWLORA_API_KEY のみに保存してください。ハードコード、クエリパラメーターへの追加、コミットは行わないでください。
• プラットフォームごとにカバレッジが異なります：X と Instagram で公開されるデータ（プロフィールと最近の投稿）は、TikTok や Reddit（全検索とトレンド）より限定的です。エンドポイントが存在すると想定する前に reference/endpoints.md を確認してください。
• リスト形式のエンドポイントはカーソルまたはページでページネーションされます。最初のページより先を取得するには、返されたカーソルをたどってください。