用途:查询 X(原 Twitter)的公开信息,包括公开主页资料、近期帖子以及单条帖子的内容与互动数据,结果以规范化 JSON 返回,无需浏览器自动化,也无需官方 X API 访问权限。
主要能力:
- 主页查询——GET /x/profile/{username},返回某 X 用户名的公开资料详情,包括可见计数与可用的资料媒体。
- 主页帖子——GET /x/profile/{username}/posts,返回首个公开主页载荷中的帖子(默认 20 条,limit 最多 50)。不翻页回复、纯媒体标签页或搜索结果。
- 帖子详情——GET /x/post/{id},按数字帖子 id 返回单条公开帖子,含作者、正文、可见指标,以及引用帖预览。可传 username 要求作者匹配(不匹配返回 404)。
使用方式:一次性设置需在运行辅助脚本前把 CRAWLORA_API_KEY 写入环境变量;辅助脚本从环境变量读取该密钥并向 https://api.crawlora.net/api/v1 发送请求,密钥缺失或无效返回 401。所有请求应使用 scripts/crawlora.sh,以避免密钥出现在命令行参数中。示例:scripts/crawlora.sh /x/profile/nasa | jq '.';scripts/crawlora.sh /x/profile/nasa/posts limit=30 | jq '.';scripts/crawlora.sh /x/post/1234567890 username=nasa | jq '.'。端点清单见 reference/endpoints.md。
适用场景:判断某账号是否值得跟踪前查看其粉丝/关注数等主页快照;检查近期发帖节奏与话题;根据他处分享的链接查询单条帖子的文本与指标,并可用 username= 校验作者。
限制:仅公开数据,不涉及登录或私密内容,需遵守 X 条款。计费为按成功付费,仅 2xx 计费,免费额度每月 2,000 credits,密钥在 https://crawlora.net 获取。该技能不提供 X 搜索或趋势端点;主页帖子为单页、不做游标翻页,limit 1–50、默认 20,无法继续向前遍历时间线;帖子查询仅支持数字 id,不支持推文 URL 片段或用户名,传 username 可防止 id 冲突/不匹配。密钥只应保存在 CRAWLORA_API_KEY,切勿硬编码、放入查询参数或提交到仓库。