用途:通过 Apify 的 apidojo/tweet-scraper actor 搜索 Twitter/X 帖子,适用于查找推文、追踪品牌提及、监控竞争对手或分析推文数据。
主要能力:脚本会构建带引号的搜索词并附加日期操作符,通过 REST API 调用 Apify actor,轮询至运行完成后获取数据集,按推文 ID/URL 去重,可选客户端关键词过滤,按点赞数降序排序,输出 JSON 或摘要。
使用方式:需设置 APIFY_API_TOKEN 环境变量(或使用 --token 参数),并安装依赖 pip install requests。示例:python3 skills/twitter-scraper/scripts/search_twitter.py --query "YourCompany" --since 2026-02-15 --until 2026-02-23。常用参数包括 --query(必填)、--since、--until、--max-tweets(默认 50)、--keywords、--output(json 或 summary)、--token、--timeout(默认 300 秒)。
日期过滤:actor 内置日期参数不可靠,脚本将 since:YYYY-MM-DD 和 until:YYYY-MM-DD 直接嵌入搜索查询字符串,使用 Twitter 原生高级搜索语法,确保服务端日期过滤正确。
输出:返回按点赞数排序的 JSON 数组,每条推文包含 id、text、fullText、likeCount、retweetCount、replyCount、viewCount、createdAt、author、twitterUrl 等字段。
限制:依赖 Apify 服务与有效 token;日期参数需通过查询字符串嵌入;关键词过滤在客户端进行;其他平台支持、收费与价格信息暂未提供。