finding-twitter-spaces-hosts-by-topic

用途

该技能用于按主题查找 Twitter Spaces 主播。它调用 apidojo 的 Twitter 抓取器（apidojo~tweet-scraper），通过搜索与 Spaces 相关的推文来识别在特定领域举办 Spaces 的主播，属于 apidojo 智能技能库的一部分。

主要能力

按主题关键词搜索 Twitter Spaces 相关推文，识别主播。
支持丰富的输入参数：搜索词数组（searchTerms，必填）、排序方式（sort：Latest、Top 或 Latest+Top）、推文语言（tweetLanguage，ISO 639-1）、最大返回条数（maxItems）、仅认证用户（onlyVerifiedUsers）、仅 Twitter Blue 订阅者（onlyTwitterBlue）、仅含图片（onlyImage）、仅含视频（onlyVideo）、仅引用推文（onlyQuote）、指定作者（author）、回复特定账号（inReplyTo）、提及特定账号（mentioning）、地理位置相关（geotaggedNear、withinRadius、geocode、placeObjectId）、最低转推数（minimumRetweets）、最低点赞数（minimumFavorites）、最低回复数（minimumReplies）、时间范围（start、end，格式 YYYY-MM-DD）、是否在每条推文中附加匹配的搜索词（includeSearchTerms）、自定义映射函数（customMapFunction，JavaScript 函数）。
对结果进行分类：REGULAR_HOST（每月超过 2 次 Spaces）、OCCASIONAL_HOST（每月 1-2 次）、ONE_TIME（单次活动）、UPCOMING（已宣布的未来 Space）。
对每条结果评分：spaces_host_score = (hosts_regularly: > 2/月 = 1, 1/月 = 0.6) * 0.40 + (followerCount > 2000 ? 1 : followerCount/2000) * 0.35 + (topic_alignment ? 1 : 0.5) * 0.25。
输出格式为表格，包含序号、关键字段、指标、分类和评分，并附摘要（最佳结果与关键发现）。

使用方式

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

工作流程：

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

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

快速回答（在聊天中打印表格）：

node scripts/run_actor.js \
  --actor "apidojo~tweet-scraper" \
  --input '{"param": "value"}'

保存为 CSV：

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

保存为 JSON：

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

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

如果 Apify MCP 可用：

工具：apify:run-actor
Actor："apidojo~tweet-scraper"
输入示例：

{
  "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"

适用场景

寻找特定领域（如 AI、科技、健康等）的 Twitter Spaces 主播。
社群运营者发掘可合作或关注的主播。
内容研究者分析某主题下的 Spaces 活动情况。

限制与边界情况

Twitter Spaces 公告推文不一定包含 #Spaces 标签，可搜索 'link in bio' + 'Space' 或 Spaces 卡片 URL 模式（twitter.com/i/spaces/）来识别。
结果少于 20 条时：扩大搜索词，移除次要过滤条件。
无结果时：验证搜索词是否正确，尝试其他表述。
数据质量问题：移除缺少关键字段的条目，并在输出中注明数量。
结果过少：放宽主要搜索词，移除限制性过滤条件。
低质量结果：应用最低评分阈值（≥ 0.50）过滤噪声。
Actor 运行失败：验证 API 密钥，检查 actor 状态（apify.com/apidojo）。

输出格式

# 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]