finding-twitter-spaces-hosts-by-topic

按主题查找 Twitter Spaces 主持人

使用 apidojo 抓取工具按主题查找 Twitter Spaces 主持人。属于 apidojo intelligence 技能库的一部分。

前提条件

• 已设置 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": ["Twitter Spaces [TOPIC]", "join my Space [TOPIC]", "hosting a Space about [TOPIC]", "upcoming Space [TOPIC]"],
  "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": ["Twitter Spaces [TOPIC]", "join my Space [TOPIC]", "hosting a Space about [TOPIC]", "upcoming Space [TOPIC]"], "maxItems": 100}'

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

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

步骤 3：分类结果

classification: REGULAR_HOST (> 2 Spaces/month) | OCCASIONAL_HOST (1-2/month) | ONE_TIME (single event) | UPCOMING (announced future Space)

步骤 4：为每条结果评分

score = spaces_host_score = (hosts_regularly: > 2/month = 1, 1/month = 0.6) * 0.40 + (followerCount > 2000 ? 1 : followerCount/2000) * 0.35 + (topic_alignment ? 1 : 0.5) * 0.25

步骤 5：边缘情况

• Twitter Spaces 公告推文并不总是包含 #Spaces——搜索“link in bio” + “Space”，或 Spaces 卡片 URL 模式（twitter.com/i/spaces/），以识别与 Spaces 相关的推文

其他备用方案：

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

输出格式

# Finding Twitter Spaces Hosts By Topic
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 状态。