twitter-scraper

用途：通过 Apify 的 apidojo/tweet-scraper actor 搜索 Twitter/X 帖子，适用于查找推文、品牌提及追踪、竞品监控和推文分析。需要 APIFY_API_TOKEN 环境变量或 --token，并安装依赖 pip install requests。基本用法：运行 python3 skills/twitter-scraper/scripts/search_twitter.py，查询用 --query（必填）。日期过滤由脚本把 since:YYYY-MM-DD 与 until:YYYY-MM-DD 直接写入搜索串，利用 Twitter 原生高级搜索语法，以避免该 actor 内置日期参数不可靠的问题；--since 含当日，--until 不含当日。常用参数包括 --max-tweets（默认 50）、--keywords 额外关键词（逗号分隔，OR 逻辑）、--output（json 或 summary，默认 json）、--timeout（默认 300 秒）。脚本流程：构造带引号和日期操作符的搜索词，经 REST API 调用该 actor，轮询至运行结束再取数据集，按推文 ID/URL 去重，可选客户端关键词过滤，按点赞数降序输出 JSON 或摘要。输出字段含 id、text、fullText、likeCount、retweetCount、replyCount、viewCount、createdAt、author 和 twitterUrl。也可直接传 JSON 参数，如 searchTerms 带入带日期操作符的查询、maxTweets 与 searchMode: live。限制：文档未提供免费额度、收费价格、请求频率上限及适用平台等细节，暂未提供。