scraping-instagram-location-content

Instagram の位置情報付きコンテンツのスクレイピング

特定の場所がタグ付けされた、公開 Instagram 投稿をすべて収集します。UGC の収集、会場について投稿する訪問者の発見、特定の場所に本当の愛着を持つクリエイターの発掘に役立ちます。

前提条件

• APIFY_TOKEN 環境変数が設定されていること
• オプション：Apify MCP サーバーがインストールされていること

入力

パラメーター	型	必須	デフォルト	備考
startUrls	配列	任意	[]	Instagram の位置情報ページの URL
locationIds	配列	任意	[]	Instagram の位置情報 ID
maxItems	数値	任意	無制限	取得する投稿の最大数
until	文字列	任意	—	日付フィルター（YYYY-MM-DD）
customMapFunction	文字列	任意	—	各出力オブジェクトを変換する JavaScript 関数

ワークフロー

Progress:
- [ ] Step 1: Find the Instagram location ID for the target venue
- [ ] Step 2: Run instagram-location-scraper
- [ ] Step 3: Fetch and filter posts
- [ ] Step 4: Identify top creators and posts
- [ ] Step 5: Deliver UGC report or creator list

ステップ 1：位置情報 ID を探す

Instagram の位置情報タグには、テキストの名前ではなく数値の位置情報 ID が使われます。確認するには：

1. Instagram のモバイルアプリで場所を検索します
2. 位置情報ページを開きます。URL の形式は instagram.com/explore/locations/[LOCATION_ID]/[location-name]/ です
3. 数値の LOCATION_ID をコピーします

または、ユーザーに Instagram の位置情報 URL 全体を尋ね、そこから ID を抽出します。

ユーザーが名前しか知らない場合（例：「Eiffel Tower Paris」）： site:instagram.com/explore/locations "[venue name]" を使って Google で簡単に検索し、位置情報ページの URL を見つけて ID を抽出します。

ステップ 2：Actor を実行する

推奨 — run_actor.js（待機、出力、ファイル保存を自動で処理します）：

# Quick answer (prints table to chat)
node scripts/run_actor.js \
  --actor "apidojo~instagram-location-scraper" \
  --input '{"param": "value"}'

# Save as CSV
node scripts/run_actor.js \
  --actor "apidojo~instagram-location-scraper" \
  --input '{"param": "value"}' \
  --output YYYY-MM-DD_results.csv --format csv

# Save as JSON
node scripts/run_actor.js \
  --actor "apidojo~instagram-location-scraper" \
  --input '{"param": "value"}' \
  --output YYYY-MM-DD_results.json --format json

環境または .env ファイルで APIFY_TOKEN を設定する必要があります。

Apify MCP を利用できる場合：

Tool: apify:run-actor
Actor: "apidojo~instagram-location-scraper"
Input:
{
  "locationIds": ["[LOCATION_ID]"],
  "maxItems": 100
}

REST API による代替手段：

curl -X POST \
  "https://api.apify.com/v2/acts/apidojo~instagram-location-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "locationIds": ["[LOCATION_ID]"],
    "maxItems": 100
  }'

SUCCEEDED になるまで待ちます。結果を取得します。

ステップ 3：投稿をフィルタリングする

データセットから、投稿ごとに以下を抽出します：

• url — 投稿へのリンク
• caption — 投稿のテキスト
• ownerUsername — クリエイターのユーザー名
• likesCount — 投稿の「いいね」数
• commentsCount — 投稿のコメント数
• timestamp — 投稿日時
• isVideo — true/false（リールか写真か）

フィルターの選択肢（どれを適用するかユーザーに尋ねます）：

• 日付範囲 — 最近の投稿のみ（例：過去 90 日間）
• 最小「いいね」数 — 質の高い投稿を抽出します（例：50 件以上）
• 投稿者の最小フォロワー数 — 実際にオーディエンスを持つクリエイターの投稿を抽出します

ステップ 4：人気のコンテンツとクリエイターを特定する

「いいね」数とコメント数の合計で投稿をランク付けします。再投稿または紹介候補として上位 10 件の投稿を特定します。

その場所で複数回投稿しているクリエイターは、本当のファンである可能性が高いため、インフルエンサーへのアプローチ候補として記録します。

ユニークなクリエイター数と投稿総数を算出します（再訪問者の傾向を把握できます）。

ステップ 5：レポートを作成する

出力形式

# Instagram Location Content: [VENUE NAME]
Location ID: [ID] | Posts collected: [N] | Date: [DATE]

## Overview
Total posts at this location: [N] (based on sample)
Unique creators: [N]
Date range of posts: [oldest] – [newest]
Avg engagement per post: [N] likes + [N] comments

## Top 10 Posts (by Engagement)
| # | Creator | Likes | Comments | Date | Type | Post URL |
|---|---------|-------|----------|------|------|----------|
| 1 | @[handle] | [N] | [N]   | [date] | [Photo/Reel] | [url] |

## Top Creators at This Location
Creators who appear most frequently in location posts:
1. @[handle] — [N] posts here | [N] followers (if available)
2. @[handle] — [N] posts here
3. @[handle] — [N] posts here

## Caption Themes
Common topics in captions at this location:
- [Theme] (e.g., "date night", "anniversary") — [N] posts
- [Theme] (e.g., "work trip") — [N] posts

## Outreach Picks
Top creators whose content could be repurposed as UGC or who are strong partnership candidates:
1. @[handle] — [post URL] — "[caption excerpt]"

トラブルシューティング

位置情報 ID が見つからない： 小規模な会場は Instagram の位置情報として登録されていない場合があります。代わりに近くのランドマークや都市を試してください。 投稿が非常に少ない： 人通りの少ない会場では、位置情報がタグ付けされた投稿が限られることがあります。「いいね」の最小数フィルターを下げてください。 別の場所の投稿が含まれる： Instagram の位置情報の照合は、名前が似た会場では不正確になることがあります。上位の結果を手動で確認してください。