xfetch 是一个读取 X（Twitter）公开数据的技能，随附单个自包含 CLI，scripts/xfetch.py 直接调用 X 的 GraphQL API 并输出结构化数据，供 agent 解析。它使用用户自己的登录 Cookie，而非付费开发者 API。主要能力：查询用户资料、某用户的推文（含回复、媒体）、点赞、单条推文与线程、搜索（支持 from:、to:、since:、until:、filter:、min_faves: 等高级操作符）、关注者与正在关注，以及登录账号自己的首页时间线和书签。
用法：先安装 twikit，执行 python3 -m pip install -r scripts/requirements.txt，再以 python3 scripts/xfetch.py <command> … 调用。用 --format 选择输出：默认 pretty JSON、jsonl、csv 或 sqlite（--format sqlite --db out.db）。数据写入 stdout，状态与错误写入 stderr，退出码表示结果：0 成功、1 错误、2 未认证、3 限流（stderr 含 rate_limit_reset=<epoch>）、64 用法错误。
认证是首要失败点：所有数据命令都需要 auth_token 与 ct0，运行 auth check 判断；可通过 auth extract --browser（支持 chrome、firefox、safari、edge、brave 等）、auth import --file、auth set、环境变量 XFETCH_AUTH_TOKEN/XFETCH_CT0，或 auth login 提供凭证。不要编造或猜测 Cookie 值。
列表命令支持 -n、--all、--max-pages、--cursor、--delay；中断或限流时 stderr 会输出 next_cursor=，可凭此续拉。X 按账号限流，批量拉取需保留 --delay、优先 --max-pages，可用 --proxy。该工具只读取公开数据及登录账号可见内容，不发布、点赞或关注；使用者需自行遵守 X 服务条款与限流。DMs、lists、trends 未提供命令。Cookie 保存在 ~/.config/xfetch/，可用 auth clear 清除。