用途
该技能用于从指定 Twitter/X 账号抓取公开推文数据，属于原始数据采集工具，不预设有具体分析场景，返回完整数据集供下游处理。底层使用 apidojo 在 Apify 平台上的 Twitter Profile Scraper。
主要能力
输入参数包括：
- startUrls：Twitter 主页 URL 数组，支持 x.com 或 twitter.com 格式，可选。
- twitterHandles：Twitter 用户名数组（不含 @），可选。
- start / end：推文日期范围，格式为 YYYY-MM-DD 或 YYYY-MM-DD_HH:MM:SS_UTC，可选。
- includeNativeRetweets：是否包含原生转推，默认 false。
- onlyImages：是否仅含图片的推文，默认 false。
- getReplies：是否包含推文回复，默认 false。
- minReplyCount：最小回复数阈值，可选。
- getAboutData：是否获取完整账号简介数据，默认 false。
- maxItems：最大返回推文数，默认不限。
- customMapFunction：用于转换每个输出对象的 JavaScript 函数，可选。
输出字段包含 type（始终为 tweet）、id、url（x.com）、twitterUrl（twitter.com）、text、retweetCount、replyCount、likeCount、quoteCount、bookmarkCount、createdAt、lang、isReply、isRetweet、isQuote、source，以及作者相关字段 author.userName、author.name、author.isVerified、author.isBlueVerified、author.profilePicture、author.followers。
使用方式
推荐使用 run_actor.js 脚本运行：
快速回答（表格）
node scripts/run_actor.js --actor "apidojo~twitter-profile-scraper" --input '{"twitterHandles": ["elonmusk"], "maxItems": 100}'
保存为 CSV
node scripts/run_actor.js --actor "apidojo~twitter-profile-scraper" --input '{"twitterHandles": ["elonmusk"], "maxItems": 100}' --output results.csv --format csv
保存为 JSON
node scripts/run_actor.js --actor "apidojo~twitter-profile-scraper" --input '{"twitterHandles": ["elonmusk"], "maxItems": 100}' --output results.json --format json
REST API 备用方式：
curl -X POST "https://api.apify.com/v2/acts/apidojo~twitter-profile-scraper/runs"
-H "Authorization: Bearer $APIFY_TOKEN"
-H "Content-Type: application/json"
-d '{"twitterHandles": ["elonmusk"], "maxItems": 100}'
若可用 Apify MCP，则使用 Apify MCP 的 call_actor 工具，actor 为 apidojo~twitter-profile-scraper，并传入上述输入。
适用场景
适用于需要对特定 Twitter/X 账号进行推文数据采集并进行后续分析的场景，例如内容研究、互动指标统计等。具体分析用途由使用者自行决定。
限制与边界情况
- 私密账号：返回 0 条推文，应告知用户该账号为私密账号。
- 账号被封禁：返回错误，该用户名可能已被封禁。
- 非常活跃的账号：建议使用 maxItems 限制条数以控制成本，额外每条推文费用为 $0.0004。
- 日期范围：查询至少需要 50 条结果才能运行；若范围内推文过少，应放宽日期范围。
- 结果中的转推：Actor 会返回包括转推在内的所有公开推文。
关于该技能的定价、平台限制或其他未在上述资料中明确说明的事项，暂未提供。