什么是ScrapeFun
ScrapeFun 是一个专为 OpenClaw 生态设计的专用 API 操作工具，用于与 scrapefun 服务器进行高效交互。该工具的核心定位是作为 OpenClaw 客户端与底层资源管理之间的桥梁，通过标准化的接口实现对媒体库、下载任务及文件导入流程的精细化控制。其设计遵循最小权限原则和明确路径优先策略，默认采用 `/api/openclaw/*` 端点体系，确保功能调用的准确性与安全性。在身份认证方面，系统优先使用 `X-OpenClaw-Key` 请求头传递访问密钥，仅在必要时回退至登录获取 Bearer Token 的方式。整个交互过程强调透明性：每次调用前需声明所需权限，若权限缺失则立即终止并反馈具体阻塞原因，避免静默降级或错误假设。 ScrapeFun 不负责资源发现逻辑，而是聚焦于已识别资源的操作执行。它支持从媒体库条目列表查询、检查剧集完整性状态、获取下载目标路径、提交磁力链接或 URL 下载请求、确认文件落地情况以及完成后续扫描整理等完整工作流。所有关键操作均有对应的必需权限约束，如 `library_query`、`download_submit`、`import_finalize` 等，防止越权行为。此外，工具严格区分主路径与备用路径的使用场景，仅允许在特定条件下有限度地调用旧版接口，其余情况必须报告端点不可用或权限不足等精确问题。这种机制保障了系统升级时的向后兼容性，同时维护了操作意图的清晰表达。
核心功能特点
- 优先使用 /api/openclaw/* 系列端点，确保与现代 OpenClaw 服务兼容
- 基于 X-OpenClaw-Key 认证为主，支持 fallback 到 Bearer Token 登录方式
- 每个 API 调用前明确声明所需权限，缺失时立即停止并报告具体阻塞原因
- 提供完整的媒体库浏览、下载提交、文件确认与导入后处理工作流支持
- 严格禁止自动降级到非首选端点，除非用户显式要求原始配置或数据细节
- 对 404/403/400 等响应码进行精准分类，避免模糊描述或误导性替代方案
适用场景
ScrapeFun 最典型的应用场景是在自动化媒体管理系统中执行精准的离线下载与入库流程。例如，当用户希望将某部动漫（如《芙莉莲》）的所有缺失集数一次性下载并自动归类到指定目录时，可通过先调用 `libraries/catalog` 获取元数据 ID，再依次查询当前剧集状态、准备下载参数、提交磁力链接，并最终触发文件落地验证与媒体库刷新。整个过程无需人工干预，且每一步都具备明确的权限校验与错误反馈机制，确保操作安全可靠。 另一个常见用例是批量处理多个番剧的更新补全。管理员可以利用 ScrapeFun 遍历 Anime 类媒体库中的所有条目，逐一检查缺失集合并动态发起下载请求。由于系统强制要求先执行 `download-check` 预检以避免重复下载，因此能有效防止资源浪费。完成后，通过 `confirm-landed` 和 `finalize-import` 两步确认文件到位并完成扫描组织，最终由 `downloads/:id` 接口汇总整体进度。这种端到端的闭环设计特别适合需要高频率同步或定期补全内容的家庭影音服务器环境。