building-full-social-audit-for-brand

用途

该技能用于为品牌构建跨主要社交媒体平台的综合社交审计。它基于 apidojo 的多平台抓取器（Apify Actors）执行，属于 apidojo 情报技能库。当用户要求对品牌进行完整社交审计时触发。

主要能力

通过 apidojo 的抓取器收集社交媒体数据，支持 Twitter 用户抓取（twitter-user-scraper）。
支持提取关注者列表、关注列表、推文转发者等。
对结果进行过滤、分类与评分，输出审计表格。
支持将结果保存为 CSV 或 JSON 格式。

使用方式

前置条件

设置 APIFY_TOKEN 环境变量。
可选：安装 Apify MCP 服务器。

输入参数

参数	类型	必填	默认值	说明
startUrls	array	可选	[]	Twitter 个人资料或推文 URL
twitterHandles	array	可选	[]	Twitter 用户名（不含 @）
twitterUserIds	array	可选	[]	Twitter 用户 ID
getFollowers	boolean	可选	false	提取关注者列表
getFollowing	boolean	可选	false	提取关注列表
getRetweeters	boolean	可选	false	提取推文 URL 的转发者
includeUnavailableUsers	boolean	可选	false	包含不可用/被封禁用户
maxItems	number	可选	无限制	返回的最大用户数
customMapFunction	string	可选	—	用于转换每个输出对象的 JavaScript 函数

工作流

定义参数
运行 twitter-user-scraper
过滤并分类结果
按质量与相关性评分
交付输出

运行 Actor

推荐使用 run_actor.js（自动处理等待、输出和文件保存）：

# 快速回答（在聊天中打印表格）
node scripts/run_actor.js \
  --actor "apidojo~twitter-user-scraper" \
  --input '{"param": "value"}'

# 保存为 CSV
node scripts/run_actor.js \
  --actor "apidojo~twitter-user-scraper" \
  --input '{"param": "value"}' \
  --output YYYY-MM-DD_results.csv --format csv

# 保存为 JSON
node scripts/run_actor.js \
  --actor "apidojo~twitter-user-scraper" \
  --input '{"param": "value"}' \
  --output YYYY-MM-DD_results.json --format json

APIFY_TOKEN 必须在环境或 .env 文件中设置。

如果 Apify MCP 可用：

工具：apify:run-actor
Actor："apidojo~twitter-user-scraper"
输入：

{
  "searchTerms": "@[BRAND_HANDLE]" (run per platform),
  "maxItems": 100
}

REST API 回退：

curl -X POST \
  "https://api.apify.com/v2/acts/apidojo~twitter-user-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms": "@[BRAND_HANDLE]" (run per platform), "maxItems": 100}'

等待 SUCCEEDED。获取数据集：

curl "https://api.apify.com/v2/actor-runs/$RUN_ID/dataset/items?token=$APIFY_TOKEN"

分类结果

分类标准：STRONG（分数 > 4%）| AVERAGE（2-4%）| WEAK（1-2%）| MINIMAL（< 1%）

评分

score = brand_social_score = avg(platform_engagement_rate * platform_weight)，权重：Twitter=0.20，Instagram=0.30，TikTok=0.30，YouTube=0.20

边界情况

品牌可能不在所有平台上——将缺失平台记为战略缺口；将加权分数调整为仅现有平台的总和。
其他回退：
- 结果少于 20 条：扩大搜索词；移除次要过滤器。
- 无结果：验证搜索词是否正确；尝试替代措辞。
- 数据质量问题：移除缺少关键字段的条目；在输出中注明数量。

输出格式

# Building Full Social Audit For Brand
Results: [N] | Date: [DATE]

| # | [Key Field] | [Metric 1] | [Metric 2] | [Classification] | [Score] |
|---|------------|-----------|-----------|-----------------|---------|
| 1 | [value] | [value] | [value] | [type] | [0.XX] |

## Summary
Top result: [description]
Key finding: [insight]

故障排除

结果太少：扩大主要搜索词；移除限制性过滤器。
结果质量低：应用最低分数阈值（≥ 0.50）以过滤噪声。
Actor 运行失败：验证 API 密钥；在 apify.com/apidojo 检查 actor 状态。

适用场景

适用于需要对品牌进行跨平台社交媒体审计的场景，例如品牌健康检查、竞品分析、营销效果评估等。

限制

需要 APIFY_TOKEN 环境变量。
依赖 apidojo 的 Apify Actors，具体可用平台和抓取能力受限于这些 Actor。
评分权重和分类阈值由技能预设，可能不适用于所有品牌。
资料中未提供收费、价格、平台覆盖范围等详细信息。