mcpField
F
finding-restaurant-brands-on-instagram

finding-restaurant-brands-on-instagram

github.com/apidojo-ioMarketing & growth1756 installsUpdated 24w ago
Repository

About finding-restaurant-brands-on-instagram

This skill gathers Instagram posts from profiles, hashtags, locations, audio pages, or Reels to identify restaurant-brand prospects. It supports Apify actor runs and ranks accounts using engagement, follower count, and business details in the bio.

Key features

  1. 01Scrape posts from Instagram URLs
  2. 02Limit results by date or item count
  3. 03Transform output with a custom JavaScript function
  4. 04Score and classify accounts as prospects
  5. 05Export results as CSV or JSON

Use cases

  1. 01Find restaurant brands through niche hashtags
  2. 02Rank candidate accounts by engagement and business details
  3. 03Save prospect research for follow-up

MCP support

When Apify MCP is available, use its call_actor tool to run the apidojo~instagram-scraper actor.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/apidojo-io/apidojo-skills --skill finding-restaurant-brands-on-instagram

After installing, type/finding-restaurant-brands-on-instagramin Claude Code to confirm it loaded.

Details

From the project README

Finding Restaurant Brands On Instagram

Inputs

ParameterTypeRequiredDefaultNotes
startUrlsarray✅[]Instagram URLs — profiles, hashtags, locations, audio pages, reels
untilstringOptional—Scrape posts until this date (YYYY-MM-DD)
maxItemsnumberOptionalUnlimitedMaximum posts to return
customMapFunctionstringOptional—JavaScript function to transform each output object

How to Run

Using run_actor.js (recommended)
# Quick answer (table)
node scripts/run_actor.js --actor "apidojo~instagram-scraper" --input '{"startUrls": ["https://www.instagram.com/explore/tags/restaurantowner/"], "maxItems": 100}'

# Save as CSV
node scripts/run_actor.js --actor "apidojo~instagram-scraper" --input '{"startUrls": ["https://www.instagram.com/explore/tags/restaurantowner/"], "maxItems": 100}' --output results.csv --format csv

# Save as JSON
node scripts/run_actor.js --actor "apidojo~instagram-scraper" --input '{"startUrls": ["https://www.instagram.com/explore/tags/restaurantowner/"], "maxItems": 100}' --output results.json --format json
REST API fallback
curl -X POST "https://api.apify.com/v2/acts/apidojo~instagram-scraper/runs" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"startUrls": ["https://www.instagram.com/explore/tags/restaurantowner/"], "maxItems": 100}'

If Apify MCP is available: Use the Apify MCP call_actor tool with actor apidojo~instagram-scraper and the input above.

Scoring & Ranking

Score each account by:

  • engagement_rate = (likeCount + commentCount) / followerCount → weight 0.4
  • followerCount → normalized 0-1, weight 0.3
  • has_business_bio (bio contains phone/website/address keywords) → weight 0.3
score = 0.4 * min(engagement_rate / 0.05, 1.0) + 0.3 * min(followerCount / 50000, 1.0) + 0.3 * int(has_business_bio)

Classification

ScoreTierLabel
≥ 0.70APRIME_PROSPECT
0.40–0.69BWARM_LEAD
< 0.40CLOW_PRIORITY

Edge Cases

  • Hashtag too broad: #food returns millions of posts from consumers, not businesses. Use niche tags like #restaurantowner or #foodbiz.
  • No business in bio: Filter by accounts that have website links or phone in bio.
  • Consumer accounts mixed in: Filter by followerCount > 500 and postCount > 20.
  • Private account: No post data — skip.
  • Duplicate accounts: Same brand may post under multiple hashtags — deduplicate by username.

Comments

Markdown supported