OpenClaw Scrapefun

Purpose

Use this skill only for scrapefun operational APIs.

Default rule:

• - Prefer INLINECODE1
• Prefer INLINECODE2
• Do not silently fall back to /api/metadata, /api/metadata/stats, /api/settings/webdav/search, or INLINECODE6
• If an expected /api/openclaw/* endpoint returns 404, 403, or validation failure, report the exact blocker instead of switching to an old path unless the fallback is explicitly allowed below

This skill does not perform OpenClaw-side resource discovery.

Auth

Preferred auth:

• - Header: INLINECODE10

Fallback auth:

• - INLINECODE11
• Reuse INLINECODE12

Rules:

• - Prefer OPENCLAW_ACCESS_KEY or the saved skill api key
• Never use INLINECODE14
• State the required OpenClaw permissions before calling INLINECODE15
• If a permission is missing, stop and report it

Primary Endpoints

Use these endpoints as the default interface surface:

• - INLINECODE16

Required permission: library_query Use for listing media entries in a library

• - INLINECODE18

Required permission: library_query Use for existing files, existing episodes, and missing episodes

• - INLINECODE20

Required permission: download_target_query Use for target path, season path, storage, and next missing episode

• - INLINECODE22

Required permission: download_dedupe Use before every download submission Minimum payload: {} or {"seasonNumber":<n>,"episodeNumber":<n>} Optional fields: candidateName, candidateSize, INLINECODE28

• - INLINECODE29

Required permission: download_submit Use for offline download submission Minimum payload: {"metadataId":"<metadataId>","magnet":"<magnet>"} or {"metadataId":"<metadataId>","urls":["<url>"]} Optional fields: preferredPath, seasonNumber, episodeNumber, INLINECODE36

• - INLINECODE37

Required permission: download_confirm Use to verify landed files after submission Minimum payload: {"metadataId":"<metadataId>"} Optional fields: expectedPath, seasonNumber, episodeNumber, waitMs, INLINECODE44

• - INLINECODE45

Required permission: import_finalize Use for post-download scan, organize, and verification Minimum payload: {"downloadPath":"<webdav path>"} Optional fields: seasonNumber, episodeNumber, matchMode, forceScan, INLINECODE52

• - INLINECODE53

Required permission: download_status or one of download_submit, download_confirm, import_finalize Use for compact workflow status

• - INLINECODE58

Required permission: library_scan Use only for explicit rescan or forced refresh

Default Operation Order

Use these sequences.

1. List a library

1. 1. INLINECODE60

Do not use:

• - INLINECODE61
• INLINECODE62

2. Read a show's current state

1. 1. Resolve metadataId from INLINECODE64
2. INLINECODE65

Do not use:

• - INLINECODE66

3. Prepare a download

1. 1. INLINECODE67
2. INLINECODE68

Do not manually combine:

• - INLINECODE69
• INLINECODE70
• INLINECODE71

unless the fallback rules below explicitly allow it

4. Submit a download

1. 1. INLINECODE72

Do not call:

• - INLINECODE73

directly from this skill

5. Continue after submission

1. 1. INLINECODE74
2. INLINECODE75
3. INLINECODE76

Do not manually combine:

• - INLINECODE77
• INLINECODE78
• INLINECODE79

as the default path

Endpoint Availability Checks

Before relying on a path in your answer, treat these failures distinctly:

• - 404: endpoint not available on this server version
• INLINECODE81: missing OpenClaw permission
• INLINECODE82: required parameters missing or invalid

Rules:

• - If catalog, state, download-target, download-check, downloads/submit, confirm-landed, or finalize-import returns 404, say the server does not expose that OpenClaw endpoint
• If GET /api/openclaw/downloads/:downloadId returns 404, report Download workflow not found; do not describe it as route absence
• If one of them returns 403, report the exact missing permission and stop
• Do not describe a legacy fallback as if it were equivalent
• If POST /api/openclaw/libraries/scan returns partial: true, report the failed library root paths explicitly

Strict Fallback Rules

Fallback is allowed only in these cases.

Allowed fallback

• - INLINECODE97

Use only when the user explicitly asks for raw library config fields such as path, scraper, sourceMode, or INLINECODE101

• - INLINECODE102

Use only when the user explicitly asks for raw scraper candidates

• - INLINECODE103

Use only when the user explicitly asks for directory-level file enumeration detail that the OpenClaw endpoints do not return

• - INLINECODE104

Use only when the user explicitly wants a scan or when finalize-import is unavailable and the user still wants a best-effort refresh

Disallowed fallback

• - Do not fall back to GET /api/metadata for library listing
• Do not fall back to GET /api/metadata for missing episode detection
• Do not fall back to GET /api/metadata/stats for media browsing
• Do not fall back to POST /api/settings/webdav/add_offline_download for normal download submission
• Do not fall back to GET /api/settings/webdav/search for normal landed-file checks

Prohibited Endpoints

Do not use:

• - INLINECODE111
• INLINECODE112
• INLINECODE113
• INLINECODE114
• INLINECODE115
• INLINECODE116 remote delegation flow

Response Rules

Keep responses functional only.

Always state:

• - auth method
• endpoint
• required permission
• payload shape
• returned result or blocker

Do not add product commentary or discovery-side explanation unless it is required to explain a blocker.

Examples

View Anime entries

User request:

INLINECODE117

Execution:

1. 1. INLINECODE118

Check episodes

User request:

INLINECODE119

Execution:

1. 1. Find metadataId from INLINECODE121
2. INLINECODE122

Submit magnet

User request:

INLINECODE123

Execution:

1. 1. INLINECODE124
2. INLINECODE125
3. INLINECODE126 with metadataId and magnet or INLINECODE129

Continue after download

User request:

INLINECODE130

Execution:

1. 1. POST /api/openclaw/downloads/:downloadId/confirm-landed with INLINECODE132
2. INLINECODE133 with INLINECODE134
3. INLINECODE135

Raw library config

User request:

INLINECODE136

Execution:

1. 1. INLINECODE137
2. Return only the matched library's path, type, sourceMode, scraper, and INLINECODE142