用途:通过 Apify 的 apidojo/tweet-scraper actor 搜索并抓取 Twitter/X 帖子,适合查找推文、追踪品牌提及、监控竞品或分析推文。
主要能力:脚本会将查询加引号并附加 since:YYYY-MM-DD 与 until:YYYY-MM-DD 日期操作符,调用 Apify REST API,轮询至运行完成,取回数据集,按推文 ID/URL 去重,可做客户端关键词过滤,按点赞数降序输出 JSON 或 summary。作者说明 actor 内置日期参数不可靠,故用 Twitter 原生高级搜索语法嵌入日期。
使用方式:需设置 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;摘要输出加 --output summary。
CLI 参数:--query 必填;--since 起始日期(含);--until 结束日期(不含);--max-tweets 默认 50;--keywords 逗号分隔的附加关键词(OR 逻辑);--output 默认 json,可选 summary;--token 默认读环境变量;--timeout 默认 300 秒。
输出:JSON 数组按点赞排序,字段含 id、text、fullText、likeCount、retweetCount、replyCount、viewCount、createdAt、author、twitterUrl。
限制:依赖 Apify 账号与令牌,收费、配额与平台限制暂未提供;日期参数由查询字符串实现;脚本为 Python 实现。