finding-instagram-creators-by-location

場所からInstagramクリエイターを見つける

特定の場所（都市、施設、地域）から積極的に投稿しているInstagramクリエイターを特定します。同じ場所から繰り返し投稿しているクリエイターは、その場所に実際に拠点があり、地元とのつながりがあると考えられます。

前提条件

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

入力

パラメーター	型	必須	デフォルト	備考
startUrls	array	任意	[]	Instagramの場所ページのURL
locationIds	array	任意	[]	Instagramの場所ID
maxItems	number	任意	無制限	返す投稿の最大数
until	string	任意	—	日付フィルター（YYYY-MM-DD）
customMapFunction	string	任意	—	各出力オブジェクトを変換するJavaScript関数

ワークフロー

Progress:
- [ ] Step 1: Resolve location ID
- [ ] Step 2: Run instagram-location-scraper
- [ ] Step 3: Identify repeat creators
- [ ] Step 4: Score creator quality
- [ ] Step 5: Deliver local creator list

ステップ 1：場所IDを特定する

Instagramでは数値の場所IDを使用します。IDを見つけるには：

1. Instagramで場所を検索します（モバイルまたはデスクトップ）
2. 場所ページを開きます。URLの形式は instagram.com/explore/locations/[LOCATION_ID]/[name]/ です
3. 数値のIDを抽出します

ユーザーが名前しか指定していない場合は、Googleで検索します： site:instagram.com/explore/locations "[LOCATION_NAME]"

ステップ 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

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

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}'

ステップ 3：クリエイターの質をスコアリングする

場所の投稿を ownerUsername ごとにグループ化します。各クリエイターについて：

local_score = min(post_count_at_location / 5, 1) * 0.30  # repeat presence
            + (avg_likes / 100) * 0.25  # engagement quality
            + (avg_comments / 10) * 0.20  # comment depth
            + (has_website ? 1 : 0) * 0.15  # professional creator signal
            + (follower_count > 1000 ? 1 : 0) * 0.10

0～1の範囲に収めます。ランク：A ≥ 0.70 | B 0.40–0.69 | C < 0.40

ステップ 4：エッジケース

• 小規模な施設の場所IDが見つからない：代わりに都市または近隣地域を試します。スクレイピング後、キャプションに施設名が含まれる投稿で絞り込みます
• 観光客のアカウント（1回だけ訪問）が結果の大半を占める：post_count_at_location = 1 の投稿は、繰り返し投稿しているユーザーより優先度を下げて絞り込みます
• 場所から投稿しているビジネスアカウント：is_business_account = true の場合は別途フラグを付けます。これらはブランドアカウントであり、クリエイターによるUGCではありません
• 場所の投稿が30件未満：小規模または新しい施設です。min_followers のしきい値を500に下げ、より多くの結果を含めます

出力形式

# Instagram Local Creators: [LOCATION_NAME]
Posts scraped: [N] | Unique creators: [N] | Repeat locals (2+ posts): [N] | Date: [DATE]

## TIER A — Established Local Creators (2+ Location Posts)
| Creator | @Handle | Location Posts | Avg Likes | Avg Comments | Content Theme | Score |
|---------|---------|---------------|-----------|--------------|---------------|-------|
| [name] | @[handle] | [N] | [N] | [N] | [food/lifestyle/travel] | [0.XX] |

## TIER B — Active Local Voices
| Creator | @Handle | Location Posts | Avg Likes | Last Post |
|---------|---------|---------------|-----------|----------|

## Niche Breakdown at [LOCATION]
| Content Theme | # Posts | Top Creator |
|--------------|---------|------------|
| [food] | [N] | @[handle] |
| [travel] | [N] | @[handle] |

トラブルシューティング

都市の検索結果が非常に少ない：都市レベルの場所IDは、「[都市名]内」の一般的なタグを返します。より密度の高い結果を得るには、近隣地域やランドマークのIDを探してください。 結果の大半が観光客のアカウント：post_count_at_location >= 3 の層に注目してください。地元の人は同じ場所から繰り返し投稿します。 場所名に一致する都市が違う：世界中で同じ都市名が使われている場合があります。実行前にInstagramの場所ページを確認してください。