用途:XActions CLI 是 X/Twitter 数据抓取与自动化命令行工具,入口为 src/cli/index.js,配置存于 ~/.xactions/config.json。
安装与认证:使用 npm install -g xactions 全局安装。通过 xactions login 交互式输入 auth_token cookie 完成认证,xactions logout 删除已保存 cookie,xactions info 查看当前认证状态与配置。auth_token 可从浏览器 DevTools(F12)→ Application → Cookies → x.com 中复制。
抓取命令:支持 profile、followers、following、non-followers、tweets、search、hashtag、thread、media 等子命令,多数支持 -l/--limit 限制数量、-o/--output 选择 json 或 csv,导出文件命名为 {username}_{command}.{ext},默认在终端彩色格式化输出。
MCP 配置:xactions mcp-config 可为 Claude Desktop 生成配置,--client 支持 cursor、windsurf、vscode,--write 直接写入文件,命令会自动检测操作系统并生成正确路径。
可编程 API:CLI 封装了同名库 API,可导入 createBrowser、createPage、loginWithCookie、scrapeProfile、scrapeFollowers、scrapeFollowing、scrapeTweets、searchTweets、scrapeHashtag、scrapeThread、scrapeMedia、exportToJSON、exportToCSV 等函数。
限制与排错:未认证需先运行 xactions login;浏览器无法启动可执行 npx puppeteer browsers install chrome;抓取为空可能因账号私密或 auth_token 过期;命令未找到可重新安装;MCP 配置路径错误可用 --client 指定 IDE。相关技能包括 twitter-scraping 与 xactions-mcp-server。