关于 apify-brand-reputation-monitoring
通过选择并运行 Apify Actors 收集评论、评分和品牌提及的技能，适用于需要导出结果并总结声誉信号的监测任务，并强调架构、权限、运行成本和数据处理检查。
主要功能
- 01为评论和提及来源选择 Actor
- 02检查当前 Actor 输入架构
- 03将结果导出为 CSV 或 JSON
- 04总结收集到的声誉信号
- 05设定运行与数据处理边界
适用场景
- 01收集 Google Maps 商家评论
- 02跟踪社交平台上的评论或提及
- 03导出酒店或景点评论数据
- 04准备用于情感分析的有限快照
MCP 相关
有已获批准的 Apify 连接器时，技能可通过它检查 Actors；随附运行脚本则直接使用 Apify REST API。文档未说明 MCP 服务端。
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/apify-brand-reputation-monitoring确认已加载。
附带文件reference/scripts/run_actor.js
详细介绍
品牌声誉监控
使用 Apify Actors 从多个平台抓取评论、评分和品牌提及。
适用场景
- 你需要监控社交、旅游或地图平台上的评论、评分或品牌提及。
- 任务是选择并运行 Apify Actor，以跟踪品牌情感或声誉。
- 你需要导出的监控结果和声誉信号摘要。
前提条件
运行任何付费任务前，请确认前提条件。
.env文件中包含APIFY_TOKEN- Node.js 20.6+（支持原生
--env-file） - 已获批准的 Apify 连接器，或可访问 Console，以检查所选 Actor 及其架构；捆绑的运行器直接使用 REST。
- 保持
.env不纳入版本控制且妥善保密；在本地配置令牌，不要将其粘贴到聊天或命令参数中。
工作流
复制此清单并跟踪进度：
Task Progress:
- [ ] Step 1: Determine data source (select Actor)
- [ ] Step 2: Fetch Actor schema via an approved connector or Console
- [ ] Step 3: Ask user preferences (format, filename)
- [ ] Step 4: Run the monitoring script
- [ ] Step 5: Summarize results
步骤 1：确定数据来源
根据用户需求选择合适的 Actor：
| 用户需求 | Actor ID | 最适用于 |
|---|---|---|
| Google Maps 评论 | compass/crawler-google-places | 商家评论、评分 |
| Google Maps 评论导出 | compass/Google-Maps-Reviews-Scraper | 专门抓取评论 |
| Booking.com 酒店 | voyager/booking-scraper | 酒店数据、评分 |
| Booking.com 评论 | voyager/booking-reviews-scraper | 详细的酒店评论 |
| TripAdvisor 评论 | maxcopell/tripadvisor-reviews | 景点／餐厅评论 |
| Facebook 评论 | apify/facebook-reviews-scraper | 专页评论 |
| Facebook 评论内容 | apify/facebook-comments-scraper | 帖子评论监控 |
| Facebook 专页指标 | apify/facebook-pages-scraper | 专页评分概览 |
| Facebook 反应 | apify/facebook-likes-scraper | 反应类型分析 |
| Instagram 评论 | apify/instagram-comment-scraper | 评论情感 |
| Instagram 话题标签 | apify/instagram-hashtag-scraper | 品牌话题标签监控 |
| Instagram 搜索 | apify/instagram-search-scraper | 发现品牌提及 |
| Instagram 标记帖子 | apify/instagram-tagged-scraper | 品牌标记跟踪 |
| Instagram 导出 | apify/export-instagram-comments-posts | 批量导出评论 |
| Instagram 综合监控 | apify/instagram-scraper | 全面的 Instagram 监控 |
| Instagram API | apify/instagram-api-scraper | 基于 API 的监控 |
| YouTube 评论 | streamers/youtube-comments-scraper | 视频评论情感 |
| TikTok 评论 | clockworks/tiktok-comments-scraper | TikTok 情感 |
步骤 2：获取 Actor 架构
使用当前会话中可用且经过身份验证的 Apify 连接器，或访问其 Console 页面，检查当前 Actor 详情和输入架构。调用前先确认实际的工具名称和参数。不要使用 Shell 替换解析 .env，也不要将令牌作为 CLI 标头参数传递。请将 Actor 表视为待发现的候选项，而非已确认可用的 Actor 或架构。
返回内容包括：
- Actor 描述和 README
- 必填和可选输入参数
- 输出字段（如果有）
步骤 3：询问用户偏好
运行前，询问：
- 输出格式：
- 快速回答 - 在聊天中显示前几条结果（不保存文件）
- CSV - 有界导出，包含返回字段的并集
- JSON - 以 JSON 格式进行有界导出
- 结果数量：根据用例特点确定
步骤 4：运行脚本
快速回答（在聊天中显示，不生成文件）：
node --env-file=.env "<resolved-skill-directory>/reference/scripts/run_actor.js" \
--actor "ACTOR_ID" \
--input 'JSON_INPUT'
CSV：
node --env-file=.env "<resolved-skill-directory>/reference/scripts/run_actor.js" \
--actor "ACTOR_ID" \
--input 'JSON_INPUT' \
--output YYYY-MM-DD_OUTPUT_FILE.csv \
--format csv
JSON：
node --env-file=.env "<resolved-skill-directory>/reference/scripts/run_actor.js" \
--actor "ACTOR_ID" \
--input 'JSON_INPUT' \
--output YYYY-MM-DD_OUTPUT_FILE.json \
--format json
步骤 5：总结结果
完成后，报告：
- 找到的评论／提及数量
- 文件位置和名称
- 可用的关键字段
- 建议的后续步骤（情感分析、筛选）
错误处理
APIFY_TOKEN not found — 请用户创建包含 APIFY_TOKEN=your_token 的 .env
Connector unavailable — 通过 Console 检查架构；不要声称调用了不可用的工具。
Actor not found — 检查 Actor ID 拼写
Run FAILED — 请用户检查错误输出中的 Apify 控制台链接
Timeout — 本地超时不会中止远程运行。重试前，请在 Console 中检查打印出的运行 ID，以避免重复扣费。
运行边界
启动前，根据用户的请求确认所选 Actor、获准访问的公开数据范围、当前输入架构、结果限制和价格。遵守来源条款和访问控制；不要收集私密群组数据或不必要的个人联系信息。先使用 Actor 支持的较小输入限制。--max-items 仅限制下载的输出（默认为 1000）；它不会限制 Actor 的工作量或费用。此辅助程序会向 Apify 发送用于标识技能的 User-Agent。请在命令占位符中解析已安装的技能目录。输出文件必须使用新路径；导出时会保留长值和异构字段。快速回答最多获取五条记录；分享前请尽量减少或删去个人字段。
按平台和稳定 ID 对评论去重，记录评分量表和检索时间，并区分来源评分与推断出的情绪。若没有覆盖范围和量表定义，不同平台的计数就无法比较。保留负面、中性和不确定的情况；在标记趋势前，先用小规模人工审核样本验证语言和讽刺识别能力。单次抓取只是一个快照，并非持续监控；定时任务和通知需要实际配置的服务及获授权的接收目标。作为数据收集的一部分，不要发布回复、联系评论者或删除内容。
限制
- 仅当任务明确符合上述范围时，才使用此技能。
- 不要将输出视为针对特定环境的验证、测试或专家审核的替代品。
- 如果缺少必要输入、权限、安全边界或成功标准，请停止并要求澄清。