用途:用于检索 Bluesky 上的公开信息,包括公开个人资料、作者动态、帖子线程、关注/粉丝图谱、账号搜索与热门话题,无需自行抓取页面或编写 AT Protocol 客户端。
主要能力:/bluesky/profile 查询资料(actor 填 handle 或 DID),返回显示名、简介、头像/横幅与粉丝、关注、帖子数;/bluesky/author-feed 按 actor、cursor、limit 分页获取账号帖子(最新在前),含互动计数及图片、链接卡片、引用帖;/bluesky/post-thread 按 uri(帖子的 at:// URI)与可选 depth 返回帖子及其嵌套回复,若是回复还含父级链;/bluesky/followers 与 /bluesky/follows 分页获取粉丝或关注对象;/bluesky/search-actors 按 q 搜索账号(匹配显示名、handle、简介);/bluesky/trending-topics 返回当前热门话题与推荐 feed,无参数。
使用方式:需先在 https://crawlora.net 获取 Crawlora API 密钥并设置环境变量 CRAWLORA_API_KEY,请求发往 https://api.crawlora.net/api/v1。示例:scripts/crawlora.sh /bluesky/profile actor=bsky.app | jq '.';scripts/crawlora.sh /bluesky/author-feed actor=bsky.app limit=20 | jq '.';scripts/crawlora.sh /bluesky/search-actors q="web scraping" | jq '.';scripts/crawlora.sh /bluesky/trending-topics | jq '.'。统一使用 scripts/crawlora.sh,避免密钥出现在命令行参数中。帖子线程需完整 at:// URI,不能使用 bsky.app 链接,可从作者动态或账号搜索结果中的 post uri 字段获取。
适用场景:账号数据审计(资料加动态查看粉丝数、发帖频率与近期互动)、线程拉取(读取完整回复树)、关系图谱构建(分页遍历粉丝与关注)。
限制与注意事项:仅限公开数据,来自 AT Protocol 公开无凭证 AppView API,不含登录与私密内容;计费按成功请求(仅 2xx 计费),免费额度每月 2,000 积分;密钥仅存放于 CRAWLORA_API_KEY,缺失或无效返回 401,切勿硬编码、放入查询参数或提交到仓库;列表类端点采用 cursor 分页,需按返回的 cursor 继续翻页;trending-topics 明确为该系列中最不稳定的接口,结构可能随时变更。完整端点列表见 reference/endpoints.md。