用途:通过 X/Twitter API 读取推文与用户信息、搜索帖子、检查提及、摄取帖子内容,并使用 OAuth 1.0a 发布推文;X Articles 的写入通过 shitrat x 完成。
主要能力:只读端点(推文查询、公开用户元数据、近期搜索、有权限时的全归档搜索、回复/上下文摄取)可用应用 bearer token;发推、回复、关注、删除等账号操作需 OAuth 1.0a 签名。回复/上下文摄取建议先取根帖,再用 conversation_id:ROOT_ID is:reply -is:retweet 搜索回复,提取高信号回复并保留回执。
使用方式:只读时从 x_consumer_key 与 x_consumer_secret 派生 bearer token,再调用 /2/tweets/TWEET_ID 等端点。写入时用 requests-oauthlib 的 OAuth1Session,示例:uv run --with requests-oauthlib python3,配合 secrets lease 获取 CK、CS、AT、ATS。常用调用包括检查提及、获取时间线、发推、回复、近期搜索、按用户名查用户、关注、删除推文。X Articles 用 shitrat x me --account joelhooks 与 shitrat x article draft --title ... --html-file ... --cover ... --dry-run;正式创建需 --yes 且受 24 小时与每日 10 次上限约束,OAuth 1.0a 无法创建文章。
适用场景:读取与摄取 X 帖子、回复上下文分析、账号互动与发推、X Articles 起草。
限制:书签需 OAuth 2.0 PKCE 用户令牌(bookmark.read、tweet.read、users.read),OAuth 1.0a 会返回 403;OAuth 2.0 用户令牌约两小时过期;近期搜索仅覆盖近 7 天,全归档搜索需访问层级允许;tweet.fields=context_annotations 时 max_results 不得超过 100;使用后应仅撤销本任务获取的 lease id。