SuperAPI AI 工具集

bluesky-cascade-fetch

通用与其它

查看项目

更新于 10-16 03:39

技能介绍

用途:根据配置从 Bluesky 抓取种子帖子,并用 getPostThread 将每条种子展开为回复级联,同时按 UTC 时间窗过滤(起始包含、结束排除)。

主要能力:种子获取支持 searchPosts、getAuthorFeed、getFeed、getListFeed 四种来源模式;内置重试(429/500/502/503/504,指数退避)、遵守 Retry-After、最小请求间隔限流、max pages/posts/threads 安全上限;校验 JSON 内容类型、UTF-8 解码与对象解析,并检查种子 URI/时间戳、线程节点重复或孤儿、级联拓扑统计(max_depth、max_branching_factor)。

使用方式:需先配置环境变量,从 assets/config.example.env 开始,并执行 set -a; source assets/config.example.env; set +a。先校验配置 python3 scripts/bluesky_cascade_fetch.py check-config --pretty,再可带 --dry-run 试跑 fetch,正式抓取可指定 --source-mode、--query、--start-datetime、--end-datetime、--max-pages、--max-posts、--max-threads、--thread-depth、--thread-parent-height、--output-dir、--log-level、--log-file、--pretty 等参数。OpenClaw 中以 $bluesky-cascade-fetch 调用,保持单次原子、参数化调用。

适用场景:按时间窗做一次性主题搜索或多来源采集并获取回复级联结构,供后续分析或编排。

限制:脚本本身不包含定时调度或轮询循环,周期任务需外部编排;若 public.api.bsky.app 返回路由级 403,脚本会自动改用 --base-url https://api.bsky.app 重试,也允许手动覆盖;其余 API 速率与数据限制见 references 目录,具体数值暂未提供。