monitoring-instagram-brand-mentions
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseMonitoring Instagram Brand Mentions
监测Instagram品牌提及内容
Tracks all public Instagram posts mentioning a brand — via branded hashtags, @mentions, or product name keywords. Classifies mentions by sentiment and type (UGC, complaint, press coverage, competitor comparison).
追踪所有提及品牌的公开Instagram帖子——包括品牌话题标签、@提及或产品名称关键词。会按情感倾向和提及类型(UGC、投诉、媒体报道、竞品对比)对提及内容进行分类。
Prerequisites
前提条件
- environment variable set
APIFY_TOKEN - Optional: Apify MCP server installed
- 已设置环境变量
APIFY_TOKEN - 可选:已安装Apify MCP服务器
Inputs
输入参数
| Parameter | Type | Required | Default | Notes |
|---|---|---|---|---|
| array | ✅ | | Instagram URLs — profiles, hashtags, locations, audio pages, reels |
| string | Optional | — | Scrape posts until this date (YYYY-MM-DD) |
| number | Optional | Unlimited | Maximum posts to return |
| string | Optional | — | JavaScript function to transform each output object |
| 参数 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
| 数组 | ✅ | | Instagram链接——包括主页、话题标签、地点、音频页面、Reels |
| 字符串 | 可选 | — | 爬取截止日期(格式为YYYY-MM-DD) |
| 数字 | 可选 | 无限制 | 返回的最大帖子数量 |
| 字符串 | 可选 | — | 用于转换每个输出对象的JavaScript函数 |
Workflow
工作流程
Progress:
- [ ] Step 1: Build hashtag and keyword list
- [ ] Step 2: Run instagram-scraper for each hashtag
- [ ] Step 3: Classify mention type and sentiment
- [ ] Step 4: Identify top advocates and critics
- [ ] Step 5: Deliver brand health report进度:
- [ ] 步骤1:构建话题标签和关键词列表
- [ ] 步骤2:针对每个话题标签运行instagram-scraper
- [ ] 步骤3:分类提及类型和情感倾向
- [ ] 步骤4:识别核心品牌支持者和批评者
- [ ] 步骤5:生成品牌健康报告Step 1 & 2: Run instagram-scraper
步骤1 & 2:运行instagram-scraper
Recommended — run_actor.js (handles waiting, output, and file saving automatically):
bash
undefined推荐方式——run_actor.js(自动处理等待、输出和文件保存):
bash
undefinedQuick answer (prints table to chat)
快速输出(在聊天窗口打印表格)
node scripts/run_actor.js
--actor "apidojo~instagram-scraper"
--input '{"param": "value"}'
--actor "apidojo~instagram-scraper"
--input '{"param": "value"}'
node scripts/run_actor.js
--actor "apidojo~instagram-scraper"
--input '{"param": "value"}'
--actor "apidojo~instagram-scraper"
--input '{"param": "value"}'
Save as CSV
保存为CSV文件
node scripts/run_actor.js
--actor "apidojo~instagram-scraper"
--input '{"param": "value"}'
--output YYYY-MM-DD_results.csv --format csv
--actor "apidojo~instagram-scraper"
--input '{"param": "value"}'
--output YYYY-MM-DD_results.csv --format csv
node scripts/run_actor.js
--actor "apidojo~instagram-scraper"
--input '{"param": "value"}'
--output YYYY-MM-DD_results.csv --format csv
--actor "apidojo~instagram-scraper"
--input '{"param": "value"}'
--output YYYY-MM-DD_results.csv --format csv
Save as JSON
保存为JSON文件
node scripts/run_actor.js
--actor "apidojo~instagram-scraper"
--input '{"param": "value"}'
--output YYYY-MM-DD_results.json --format json
--actor "apidojo~instagram-scraper"
--input '{"param": "value"}'
--output YYYY-MM-DD_results.json --format json
> `APIFY_TOKEN` must be set in environment or `.env` file.
**If Apify MCP is available:**Tool: apify:run-actor
Actor: "apidojo~instagram-scraper"
Input:
{
"keywords": ["#[BRAND]", "#[BRAND]review", "#[BRAND]community"],
"maxItems": 100
}
**REST API fallback:**
```bash
curl -X POST "https://api.apify.com/v2/acts/apidojo~instagram-scraper/runs?token=$APIFY_TOKEN" -H "Content-Type: application/json" -d '{"keywords": ["#[brand]", "#[brand]review"], "maxItems": 100}'Run for each hashtag cluster. Merge results and deduplicate by .
postUrlnode scripts/run_actor.js
--actor "apidojo~instagram-scraper"
--input '{"param": "value"}'
--output YYYY-MM-DD_results.json --format json
--actor "apidojo~instagram-scraper"
--input '{"param": "value"}'
--output YYYY-MM-DD_results.json --format json
> 必须在环境变量或`.env`文件中设置`APIFY_TOKEN`。
**如果Apify MCP可用:**工具:apify:run-actor
Actor: "apidojo~instagram-scraper"
输入:
{
"keywords": ["#[BRAND]", "#[BRAND]review", "#[BRAND]community"],
"maxItems": 100
}
**REST API备选方案:**
```bash
curl -X POST "https://api.apify.com/v2/acts/apidojo~instagram-scraper/runs?token=$APIFY_TOKEN" -H "Content-Type: application/json" -d '{"keywords": ["#[brand]", "#[brand]review"], "maxItems": 100}'针对每个话题标签组运行爬虫。合并结果并通过去重。
postUrlStep 2: Classify Mentions
步骤2:分类提及内容
Mention type:
UGC = post contains product photo + brand mention; author is not verified
COMPLAINT = caption contains negative indicators: "broken", "disappointed", "scam", "refund", "terrible", "never again"
POSITIVE_REVIEW = caption contains: "love", "amazing", "best", "recommend", "obsessed"
PRESS/EDITORIAL = author is verified OR follower_count > 100K
COMPETITOR_COMPARISON = caption mentions competitor brand alongside this brandSentiment: Apply same lexical classification as Twitter sentiment skill (positive/negative/neutral indicators).
提及类型:
UGC = 帖子包含产品照片+品牌提及;作者未认证
COMPLAINT = 文案包含负面词汇:"broken"、"disappointed"、"scam"、"refund"、"terrible"、"never again"
POSITIVE_REVIEW = 文案包含正面词汇:"love"、"amazing"、"best"、"recommend"、"obsessed"
PRESS/EDITORIAL = 作者已认证 或 粉丝数>10万
COMPETITOR_COMPARISON = 文案同时提及本品牌和竞品品牌情感倾向: 采用与Twitter情感分析工具相同的词汇分类方式(正面/负面/中性词汇)。
Step 3: Score Reach
步骤3:计算传播范围得分
mention_reach = likes + comments * 5 + (followers_of_author / 100)mention_reach = 点赞数 + 评论数*5 + (作者粉丝数/100)Step 4: Edge Cases
步骤4:边缘情况处理
- Official brand account's own posts in results: Drop posts where = brand's own handle
ownerUsername - Hashtag is overloaded (> 1M posts): Use long-tail branded hashtags instead; or filter by date
- Sentiment misclassified for complex posts: Flag posts with both positive and negative indicators as ; report count
MIXED - Foreign language mentions dominant: Report language distribution; flag non-English mentions separately
- 结果中包含品牌官方账号自身帖子:过滤掉等于品牌官方账号的帖子
ownerUsername - 话题标签过载(帖子数>100万):改用长尾品牌话题标签;或按日期过滤
- 复杂帖子情感分类错误:将同时包含正面和负面词汇的帖子标记为;统计这类帖子的数量
MIXED - 外文提及占主导:报告语言分布情况;单独标记非英文提及内容
Output Format
输出格式
undefinedundefinedInstagram Brand Mention Monitor: [BRAND]
Instagram品牌提及监测报告:[BRAND]
Posts collected: [N] | Period: [DATE_RANGE] | Date: [DATE]
收集到的帖子数量:[N] | 监测周期:[DATE_RANGE] | 报告日期:[DATE]
Mention Type Distribution
提及类型分布
UGC: [N] | Positive Reviews: [N] | Complaints: [N] | Press: [N] | Comparisons: [N]
UGC:[N] | 正面评价:[N] | 投诉:[N] | 媒体报道:[N] | 竞品对比:[N]
Sentiment Summary
情感倾向汇总
Positive: [X%] | Negative: [X%] | Neutral: [X%]
Weighted by reach: Positive [X%] | Negative [X%]
正面:[X%] | 负面:[X%] | 中性:[X%]
按传播范围加权:正面 [X%] | 负面 [X%]
Top UGC Posts (Most Liked)
热门UGC帖子(点赞量最高)
| Creator | @Handle | Likes | Type | Caption Excerpt | Post URL |
|---|
| 创作者 | @账号 | 点赞数 | 类型 | 文案摘要 | 帖子链接 |
|---|
Complaints to Address
需要处理的投诉
| Creator | Likes | Complaint Summary | Post URL |
|---|
| 创作者 | 点赞数 | 投诉摘要 | 帖子链接 |
|---|
Top Brand Advocates (Most Frequent Positive Posters)
核心品牌支持者(发布正面内容最多)
- @[handle] — [N] positive posts | [N] avg likes
undefined- @[账号] — [N]条正面帖子 | 平均点赞数[N]
undefinedTroubleshooting
故障排除
Hashtag returns generic posts: The brand hashtag may be ambiguous (e.g. "#apple"). Use or for precision.
Mostly competitor posts: This may indicate your brand is being used in comparison posts — analyze category for positioning insights.
Sentiment skewed by a single viral negative post: Check vs. raw sentiment; one viral post can shift the raw numbers.
#[brand]official#[brand][product]COMPETITOR_COMPARISONweighted sentiment话题标签返回无关帖子:品牌话题标签可能存在歧义(例如"#apple")。改用或来提高精准度。
结果中多为竞品帖子:这可能表明你的品牌被用于对比帖子中——分析类别以获取品牌定位洞察。
单条 viral 负面帖子导致情感倾向偏差:对比查看“加权情感倾向”和“原始情感倾向”;一条 viral 帖子可能会影响原始数据结果。
#[brand]official#[brand][product]COMPETITOR_COMPARISON