Resource Hunter

A success-first public resource retrieval skill for:

• movies
• TV
• anime
• music
• software
• books
• public pan links
• magnets
• torrents
• public video URLs

What makes it useful

Stronger real-source coverage

• Pan/direct-or-clue: 2fun, dalipan, hunhepan, pansou.vip, tieba
• Torrent/direct: nyaa, animetosho, dmhy, eztv, tpb, torlock, yts, 1337x
• Indexed discovery fallback: search-index:ddg, search-index:bing, search-index:brave

Layered retrieval

• direct-structured-pan
• direct-structured-torrent
• community-clue
• indexed-discovery
• authenticated-connector (reserved)

Better result semantics

Results are ranked into:

• direct
• actionable
• clue

That makes it easier to distinguish:

• immediately usable links/magnets
• results that still need light follow-up
• clue-only records that point you in the right direction

Important limitations

Dalipan

dalipan is currently a token-only clue source in release semantics.

• anonymous search is confirmed
• runtime emits dalipan://provider/eu-token
• these records are structured clue output
• they are not guaranteed final share URLs yet

Bing / Brave

• public HTML fallback only
• useful for recall and indexed discovery
• still best-effort providers, not stable structured direct sources

Main entrypoint

SKILL_ROOT="$(openclaw skills path resource-hunter)"
SKILL_DIR="$SKILL_ROOT/scripts"
python3 "$SKILL_DIR/hunt.py" search "<query>"

Common commands

python3 "$SKILL_DIR/hunt.py" search "Oppenheimer 2023" --4k
python3 "$SKILL_DIR/hunt.py" search "Breaking Bad S01E01" --tv
python3 "$SKILL_DIR/hunt.py" search "进击的巨人 Attack on Titan" --anime --sub
python3 "$SKILL_DIR/hunt.py" search "周杰伦 无损" --music
python3 "$SKILL_DIR/hunt.py" sources --probe --json
python3 "$SKILL_DIR/hunt.py" video probe "https://www.bilibili.com/video/BV..."

Validation snapshot

• focused runtime/source regression set: 96 passed, 1 skipped
• ruff check skills/resource-hunter: passed
• latest GitHub resource-hunter-ci: green

Notes for agent behavior

• Prefer the main hunt.py entrypoint
• Use --quick for short chat answers
• Use --json for machine-consumable output
• Do not oversell Dalipan as a fully direct final-link source in the current release
• Do not oversell Bing/Brave as stable structured providers