tracking-product-launch-buzz-on-twitter

追踪 Twitter 上的产品发布热度

使用 apidojo 抓取器追踪 Twitter 上的产品发布热度。属于 apidojo 情报技能库的一部分。

前提条件

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

输入

参数	类型	必填	默认值	备注
searchTerms	array	✅	[]	Twitter 高级搜索查询（例如 ["#AI lang:en", "from:NASA"]）
sort	string	可选	Top	排序方式：Latest、Top 或 Latest+Top
tweetLanguage	string	可选	—	ISO 639-1 语言代码（例如 en）
maxItems	number	可选	不限	返回推文的最大数量
onlyVerifiedUsers	boolean	可选	false	仅限已认证用户发布的推文
onlyTwitterBlue	boolean	可选	false	仅限 Twitter Blue 订阅用户发布的推文
onlyImage	boolean	可选	false	仅限带图片的推文
onlyVideo	boolean	可选	false	仅限带视频的推文
onlyQuote	boolean	可选	false	仅限引用推文
author	string	可选	—	筛选特定作者账号发布的推文
inReplyTo	string	可选	—	回复特定账号的推文
mentioning	string	可选	—	提及特定账号的推文
geotaggedNear	string	可选	—	特定地点附近的推文
withinRadius	string	可选	—	geotaggedNear 周边的半径
geocode	string	可选	—	纬度/经度 + 半径字符串
placeObjectId	string	可选	—	标记了某地点的推文
minimumRetweets	number	可选	—	最低转推数
minimumFavorites	number	可选	—	最低点赞数
minimumReplies	number	可选	—	最低回复数
start	string	可选	—	此日期之后发布的推文（YYYY-MM-DD）
end	string	可选	—	此日期之前发布的推文（YYYY-MM-DD）
includeSearchTerms	boolean	可选	false	将匹配的搜索词添加到每条推文中
customMapFunction	string	可选	—	用于转换每个输出对象的 JavaScript 函数

工作流

Progress:
- [ ] Step 1: Define parameters
- [ ] Step 2: Run tweet-scraper
- [ ] Step 3: Filter and classify results
- [ ] Step 4: Score by quality and relevance
- [ ] Step 5: Deliver output

步骤 2：运行 Actor

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

# Quick answer (prints table to chat)
node scripts/run_actor.js \
  --actor "apidojo~tweet-scraper" \
  --input '{"param": "value"}'

# Save as CSV
node scripts/run_actor.js \
  --actor "apidojo~tweet-scraper" \
  --input '{"param": "value"}' \
  --output YYYY-MM-DD_results.csv --format csv

# Save as JSON
node scripts/run_actor.js \
  --actor "apidojo~tweet-scraper" \
  --input '{"param": "value"}' \
  --output YYYY-MM-DD_results.json --format json

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

如果 Apify MCP 可用：

Tool: apify:run-actor
Actor: "apidojo~tweet-scraper"
Input:
{
  "searchTerms": ["[PRODUCT] launch", "[PRODUCT] just launched", "new [PRODUCT]", "[PRODUCT] release"],
  "maxItems": 100
}

REST API 备用方案：

curl -X POST \
  "https://api.apify.com/v2/acts/apidojo~tweet-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms": ["[PRODUCT] launch", "[PRODUCT] just launched", "new [PRODUCT]", "[PRODUCT] release"], "maxItems": 100}'

等待状态变为 SUCCEEDED。获取数据集：

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

步骤 3：分类结果

classification: VIRAL (> 1000 mentions/hour) | HIGH_BUZZ (100-1000/hour) | MODERATE (10-100/hour) | LOW (< 10/hour)

步骤 4：为每条结果评分

score = buzz_score = tweet_volume_24h * 0.35 + weighted_sentiment * 0.35 + influencer_mention_count * 0.30

步骤 5：边缘情况

• 产品发布推文会在 48h 内激增，随后热度衰减——应在发布后 24-72h 内运行以获取峰值信号；较早的发布会产生误导性的低数量结果

其他备用方案：

• 结果少于 20 条：扩大搜索词范围；移除次要筛选条件
• 没有结果：确认搜索词正确；尝试其他表述方式
• 数据质量问题：移除缺少关键字段的条目；在输出中注明数量

输出格式

# Tracking Product Launch Buzz On Twitter
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 状态。